_ltoa_s、_ltow_s

發行項
06/09/2015

將長整數轉換成字串。這些是 _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
value的基底。

傳回值

如果函式成功，回傳零，反之為錯誤碼。

備註

_ltoa_s 函式轉換 value 中的字元至以 null 結尾的字元字串並將結果儲存至 str (至多33 位元組)。 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++ 利用多載樣板簡化了這些函式的使用方式。多載可自動推斷緩衝區長度 (因而不須指定大小引數)，也可以將不安全的舊函式自動取代成較新且安全的對應函式。如需詳細資訊，請參閱安全範本多載。

一般文字常式對應