任意の Url で呼び出され、 Url を読み込むために非同期に開いたり (File.async-read-open を使用)、非同期の読み込み (TextInputStream.async-read-string) を行ないます。さらに、Url から読み込まれたデータを指定して AsyncStreamReadEvent イベントで登録されているイベント ハンドラを呼び出します。

url: 開いて読み込む Url。

buf: StringBuf キーワード 。作成される AsyncStreamReadEvent で使用および再利用されます。

n: 読み込む最大量を示す int64 キーワード。既定値は max-int64 で、ストリームの最後まで読み込みます。

max-chunk-size: 一度に読み込む最大量、および AsyncStreamReadEvent に提供する新しいデータ量の最大サイズを示す int キーワード。既定値は 8192 です。

partial?: n 個のアイテムが読み込まれる前、またはストリームの最後に達する前に AsyncStreamReadEvent を送信するかどうかを示す bool キーワード。つまり、読み込まれるチャンクごとにイベントを送信するかどうか、append? が true の場合にチャンクごとにファイル関連イベントを送信するかどうかどうかを指定することにもなります。既定値は false です。

append?: AsyncStreamReadEvent のいずれかが新規のデータだけを受け取るか、それまでに読み込まれた全データの継続バッファを受け取るかを示す bool キーワード。さらに、buf が指定されている場合は、これに追加するかまたはクリアしてから使用するかを示します。既定値は false です。

event-handler: AsyncStreamReadEvent を受け取る EventHandler。少なくとも 1 つを指定する必要があります。

...: AsyncStreamReadEvent を必須引数とする EventHandler を複数記述できます。

非同期読み込みを制御するための AsyncStreamReader。

EventHandler は引数で指定された順序とは逆の順番で呼び出されます。AsyncStreamReadEvent のデータは StringBuf になります。