serialize

機械きかい向むけの安定あんてい文字列表現もじれつひょうげんを与あたえる trait 群ぐん

目的もくてき

Serialize trait を標準化ひょうじゅんかし、保存ほぞん・比較ひかく・通信つうしんに使つかう文字列表現もじれつひょうげんを共通きょうつう helper から得えられるようにします。
Stringify が利用者りようしゃ向むけ、Debug が開発者かいはつしゃ向むけであるのに対たいし、Serialize は機械きかいに渡わたしても壊こわれにくい表現ひょうげんを担当たんとうします。

注意ちゅうい

当面とうめんは str を媒体ばいたいにした最小さいしょうの trait として導入どうにゅうします。
形式けいしきを複数ふくすう持もつ Serialize<T, F> への一般化いっぱんかは後続こうぞくの課題かだいです。

計算量けいさんりょう

各 impl に依存いそんします。str の再利用さいりようは O(1)、数値すうちの 10 進しん変換へんかんは O(d) です。

Serialize

機械きかい向むけ文字列表現もじれつひょうげん

目的もくてき

値あたいを str に変換へんかんし、保存ほぞんや比較ひかくのために安定あんていした表現ひょうげんを得えられるようにします。

注意ちゅうい

現在げんざいの stdlib では Serialize の返かえり値あたいは str に固定こていします。
人間にんげん向むけの簡易かんい表示ひょうじは Stringify、調査用ちょうさようの詳細しょうさい表示ひょうじは Debug を使つかいます。

serialize

trait を通とおして直列化ちょくれつか文字列もじれつを得える

目的もくてき

呼よび出だし側がわが具体的ぐたいてき impl を意識いしきせず、共通きょうつうの入口いりぐちから機械きかい向むけ表現ひょうげんを取得しゅとくできるようにします。

使用例しようれい

TEST

#entry main
#target std
#import "std/test" as *
#import "core/traits/serialize" as *
fn main <()*>i32> ():
    assert_str_eq "42" serialize 42;
    assert_str_eq "false" serialize false;
    0

実装じっそう

Serialize::serialize x をそのまま呼よびます。

注意ちゅうい

型推論かたすいろんが曖昧あいまいな場合ばあいは周囲しゅういの型注釈かたちゅうしゃくで解決かいけつします。

計算量けいさんりょう

impl に依存いそんします。