_ltoa_s _ltow_s

發行項
02/28/2013

將長整數轉換為字串。這些是舊版_ltoa _ltow中所述的安全性增強功能與安全性功能，則在 CRT 中。

errno_t _ltoa_s(
    long value,
    char *str,
    size_t sizeOfstr,
    int radix 
);
errno_t _ltow_s(
    long value,
    wchar_t *str,
    size_t sizeOfstr,
    int radix 
);
template <size_t size>
errno_t _ltoa_s(
    long value,
    char (&str)[size],
    int radix 
); // C++ only
template <size_t size>
errno_t _ltow_s(
    long value,
    wchar_t (&str)[size],
    int radix 
); // C++ only

參數

value
以指定須轉換的數字。
str
產生的字串的緩衝區。
sizeOfstr
大小的str以位元組為單位的_ltoa_s或特定的文字的_ltow_s。
radix
Base of value.

傳回值

如果函式成功的零或一個錯誤碼。

備註

_ltoa_s函式將轉換的數字value為 null 結尾字元字串，並將結果 (最多可有 33 個位元組) 儲存在str。radix引數指定的基底value，它必須介於 2 – 36。如果radix等於 10， value是負值，預存的字串的第一個字元是減號 (-)。_ltow_s寬字元版本的_ltoa_s。第二個引數的_ltow_s是寬字元字串。

如果str是NULL指標或sizeOfstr小於或等於為零，這些函式呼叫不正確的參數處理常式中所述參數驗證。如果執行，則允許繼續執行，這些函數會傳回-1 並設定errno到EINVAL 或value或str超出長整數的範圍，這些函數會傳回-1 並設定errno到ERANGE。

在 C++ 中，使用這些函式已經過簡化的樣板的多載；多載可以自動推斷緩衝區長度 (而不必指定 size 引數)，它們可以自動取代較舊的、不安全的函式與其較新的、安全的對應項目。如需詳細資訊，請參閱安全範本多載。

泛用文字常式對應