Skip to main content

標準函式庫 (Standard Library)

Move 標準函式庫為原生型別與操作提供功能。它是由不與儲存體互動的模組組成之標準 集合，但提供處理與操作資料的基本工具。它是 Sui Framework 唯一的依賴項，並會與其一同匯入。

最常用的模組 (Most Common Modules)​

本書會深入說明標準函式庫中的大多數模組；不過，先概覽其功能也很有幫助，讓你能了解 可用的功能以及實作這些功能的模組。

模組說明章節
std::string提供基本的字串操作字串
std::ascii提供基本的 ASCII 操作-
std::option實作 Option<T>Option
std::vector向量型別的原生操作向量
std::internal為經模組授權的呼叫提供 Permit<T> 型別Internal Permit
std::bcs包含 bcs::to_bytes() 函式BCS
std::address包含唯一的 address::length 函式地址
std::type_name允許在執行階段進行 型別反射型別反射
std::hash雜湊函式：sha2_256 與 sha3_256-
std::debug包含偵錯函式，僅可在 test 模式中使用-
std::unit_test適用於 test 原始碼的 assert_eq! 與 assert_ref_eq! 巨集測試
std::bit_vector提供位元向量的操作-
std::uq32_32定點數運算：UQ32_32 型別-
std::uq64_64定點數運算：UQ64_64 型別-
std::fixed_point32FixedPoint32 型別；已淘汰，改用 std::uq32_32-

整數模組 (Integer Modules)​

Move 標準函式庫提供一組與整數型別相關的函式。這些函式分散於多個模組中， 每個模組對應特定的整數型別。這些模組不應直接匯入，因為其函式可用於每個整數值。

所有模組皆提供相同的一組函式：min、max、diff、 divide_and_round_up、sqrt、pow 與 to_string；可檢查的較小型別轉換， 例如 try_as_u8、try_as_u16 等；以及巨集，例如 max_value! 與迭代 輔助工具 do! 和 range_do!。

模組說明
std::u8u8 型別的函式
std::u16u16 型別的函式
std::u32u32 型別的函式
std::u64u64 型別的函式
std::u128u128 型別的函式
std::u256u256 型別的函式

匯出的地址 (Exported Addresses)​

標準函式庫匯出一個具名地址：std = 0x1。本書中使用的 std 別名便是在此定義。

隱式匯入 (Implicit Imports)​

部分模組會被隱式匯入，因此可在模組中使用，而無須明確撰寫 use 匯入。對標準函式庫而言，這些模組與型別包括：

  • std::vector
  • std::option
  • std::option::Option
  • std::internal

請注意，std::internal 是以模組而非成員方式匯入：其成員會保留模組 前綴，例如 internal::Permit<T> 與 internal::permit<T>()，無須 use 陳述式。請參閱 Internal Permit 章節，了解其使用方式。

不使用 Sui Framework 匯入 std (Importing std without Sui Framework)​

Move 標準函式庫可直接匯入套件。不過，僅有 std 並不足以建置有意義的應用程式， 因為它不提供任何儲存能力，也無法與鏈上狀態互動。

MoveStdlib = { git = "https://github.com/MystenLabs/sui.git", subdir = "crates/sui-framework/packages/move-stdlib", rev = "framework/mainnet" }

原始碼 (Source Code)​

Move 標準函式庫的原始碼可在 Sui 儲存庫 取得。