const line = readLine(); // string | null
if (line == null) { break; } // 入力の終わり
| 関数 |
動作 |
readLine(): string | null |
標準入力から1行読みます。末尾の改行(とその前の \r 1つ)は含みません。入力の終わりでは null。行の長さに上限はありません。待つ前に標準出力を流します。 |
inputReady(): bool |
readLine() が待たずに戻るなら true(改行までの1行が届いているか、入力が終わっているとき。行の途中までしか届いていなければ false)。標準出力も流します。軽いので、探索の途中で何度も呼べます。 |
clock(): f64 |
プログラムの開始からの秒数。逆戻りしません。 |
stringFromBytes(bytes: u8[]): string |
バイト列を写した新しい文字列を作ります(UTF-8 かどうかは確かめません)。 |
readFile(path: string): u8[] | null |
ファイル全体をバイト列として読みます。読めなければ null。 |
writeFile(path: string, bytes: u8[]): bool |
ファイルを作って(あれば中身を置き換えて)書きます。すべて書けたら true。 |
- 引数は借りるだけで、結果は新しい値です。
string | null と u8[] | null は、const に入れて if (x != null) で確かめてから使います。
- 同じ名前の関数をプログラムが定義していれば、そちらが優先されます。 kernel の中では使えません。
print の出力はまとめて書き出されます。 相手のプログラムとパイプで話すときは、readLine() か inputReady() を呼んだ時点(と終了時)に相手へ届きます。
- 名前に 0 のバイトを含むファイルは読めず、書けません(
null / false)。
- 標準入力が「待たない」設定(O_NONBLOCK)でも、
readLine() は行が届くまで待ちます(まだ届いていないことを、入力の終わりとは扱いません)。
- 2 GiB 以上のファイルや行も読み書きできます(OS への依頼を 1 GiB ずつに分けます)。
- wasm32 では、入出力は読み込む側が渡した口だけを通ります。
instantiate(bytes, { readLine, inputReady, readFile, writeFile }) で渡します。渡さなければ readLine() は null、inputReady() は true(入力は終わっている)、readFile() は null、writeFile() は false です。ファイルの名前は UTF-8 の文字列として口に渡すので、UTF-8 として読めない名前は wasm32 では失敗(null / false)になります。runtime/run-node.mjs は標準入力とファイルをそのままつなぎます(Node には待たずに読めるかを確かめる方法がないので、inputReady() は読み込み済みの分だけで答えます)。wasm32 の入出力は、オブジェクトファイルが作れることまでしか確かめていません(実行は未確認)。
例: examples/input_lines.um、examples/bytes_and_files.um。