io

targetたーげっと非依存ひいぞんの stream 抽象ちゅうしょうと binary buffer を集あつめるライブラリ

目的もくてき

byte stream / text stream の読よみ書かき能力のうりょくを trait として分離ぶんりし、std/streamio や std/io が共通きょうつう入口いりぐちを構築こうちくできるようにします。
binary stream の媒体ばいたいとして、fd_read / fd_write にそのまま渡わたせる連続れんぞく byte buffer ByteBuf を定義ていぎします。

注意ちゅうい

ここでは syscall や descriptor を扱あつかいません。具体的ぐたいてきな入出力にゅうしゅつりょくは std/streamio や std/fs が担当たんとうします。
ByteBuf は所有権しょゆうけんを持もつので Copy / Clone を実装じっそうしません。

TEST

#entry main
#target std
#import "std/test" as *
#import "alloc/io" as *
struct CountSink:
    total <i32>

impl ByteWriter for CountSink:
    fn write_bytes <(CountSink,ByteBuf)*>Result<CountSink, StdErrorKind>> (sink, bytes):
        let n <i32> get bytes "len";
        io_bytebuf_free bytes;
        Result::Ok CountSink add get sink "total" n

fn main <()*>i32> ():
    let bytes0 <ByteBuf> io_bytebuf_from_str "AB";
    match io_write_bytes (CountSink 3) bytes0:
        Result::Ok sink1:
            if eq get sink1 "total" 5 0 1
        Result::Err _e:
            0

ByteBuf

連続れんぞくした raw byte buffer を所有しょゆうする handle

目的もくてき

Vec<u8> の内部表現ないぶひょうげんに依存いそんせず、binary I/O の媒体ばいたいを明示的めいじてきに表あらわします。

注意ちゅうい

ptr は len byte の所有領域しょゆうりょういきを指さします。
使つかい終おわったら io_bytebuf_free で解放かいほうしてください。

ByteReader

生なまのバイト列ばいとれつを読よみ出だす能力のうりょく

ByteWriter

生なまのバイト列ばいとれつを書かき込こむ能力のうりょく

TextReader

text として全体ぜんたいを読よみ出だす能力のうりょく

TextWriter

text を書かき込こむ能力のうりょく

Flush

保留中ほりゅうちゅうの出力しゅつりょくを外部がいぶへ反映はんえいする能力のうりょく

Close

stream を閉とじる能力のうりょく