deserialize

機械きかい向むけ文字列表現もじれつひょうげんから値あたいを復元ふくげんする trait 群ぐん

目的もくてき

Deserialize trait を標準化ひょうじゅんかし、Serialize が返かえした str から値あたいを戻もどす入口いりぐちを共通化きょうつうかします。
変換へんかん失敗しっぱいは StdErrorKind::ParseError として正規化せいきかし、trait 利用りよう側がわが個別こべつの整数 error code に依存いそんしなくてよいようにします。

注意ちゅうい

当面とうめんは str だけを入力にゅうりょくにします。
文法ぶんぽうや人間にんげん向むけ入力にゅうりょくの寛容かんような扱あつかいは Parse の別仕様べつしようで整理せいりします。

計算量けいさんりょう

各 impl に依存いそんします。bool は O(1)、文字列長もじれつちょうを n とする整数せいすう復元ふくげんは O(n) です。

Deserialize

str から値あたいを復元ふくげんする能力のうりょく

目的もくてき

機械きかい向むけ文字列表現もじれつひょうげんから値あたいを戻もどし、保存ほぞんや比較ひかくの往復おうふくを共通きょうつう helper で扱あつかえるようにします。

注意ちゅうい

失敗しっぱいは Result::Err StdErrorKind::ParseError として返かえすのを標準ひょうじゅんにします。
詳細しょうさいな診断しんだんが必要ひつような処理しょりは Outcome と Diag を使つかいます。

deserialize

trait を通とおして str から値あたいを復元ふくげんする

目的もくてき

呼よび出だし側がわが型かたごとの具体的ぐたいてき API を意識いしきせず、共通きょうつうの入口いりぐちから復元ふくげんできるようにします。

使用例しようれい

TEST

#entry main
#target std
#import "std/test" as *
#import "core/traits/deserialize" as *
#import "alloc/diag/error" as *
fn main <()*>i32> ():
    match deserialize<i32> "42":
        Result::Ok v:
            assert_eq_i32 42 v
        Result::Err e:
            match e:
                StdErrorKind::ParseError:
                    test_fail "deserialize<i32> failed unexpectedly";
                StdErrorKind::Failure:
                    test_fail "wrong error kind";
                StdErrorKind::OutOfMemory:
                    test_fail "wrong error kind";
                StdErrorKind::EmptyCollection:
                    test_fail "wrong error kind";
                StdErrorKind::IndexOutOfBounds:
                    test_fail "wrong error kind";
                StdErrorKind::KeyNotFound:
                    test_fail "wrong error kind";
                StdErrorKind::CapacityExceeded:
                    test_fail "wrong error kind";
                StdErrorKind::InvalidOperation:
                    test_fail "wrong error kind";
                StdErrorKind::InvalidUtf8:
                    test_fail "wrong error kind";
                StdErrorKind::IoError:
                    test_fail "wrong error kind";
                StdErrorKind::Other:
                    test_fail "wrong error kind";
    0

実装じっそう

Deserialize::deserialize s をそのまま呼よびます。

注意ちゅうい

型推論かたすいろんが効ききにくいので、呼よび出だしでは deserialize<i32> のような型引数かたひきすうを付つける前提ぜんていです。

計算量けいさんりょう

impl に依存いそんします。