_ltoa_s, _ltow_s

Artikel
02/26/2013

Konvertiert eine lange ganze Zahl in eine Zeichenfolge.Dies sind Versionen von _ltoa, _ltow mit beschrieben, wie unter Security Enhancements in Sicherheitsfeatures im 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

Parameter

value
Der zu konvertierende Zahl.
str
Puffer für die resultierende Zeichenfolge.
sizeOfstr
str Größe in Bytes für _ltoa_s für den Wörtern oder _ltow_s.
radix
Basis von value.

Rückgabewert

Beliebige wenn die Funktion erfolgreich oder ein Fehlercode war.

Hinweise

Die _ltoa_s-Funktion konvertiert die Zahlen in value auf eine auf NULL endende Zeichenfolge und speichert das Ergebnis in Bytes) bis 33 ( str.Das radix-Argument gibt die Basis des valuean, die im Bereich 2 bis 36 sein muss.Wenn radix 10 entspricht, und value negativ ist, wird das erste Zeichen der gespeicherten Zeichenfolge das Minuszeichen (–)._ltow_s Breitzeichen handelt es sich um eine Version von _ltoa_s. Das zweite Argument ist _ltow_s von Zeichenfolgen mit Breitzeichen.

Wenn str ein NULL Zeiger ist oder sizeOfstr kleiner oder gleich null ist, rufen diese Funktionen einen ungültigen Parameter für ein, wie in Parametervalidierungbeschrieben.Wenn die Ausführung ermöglicht wird, um fortzufahren, geben diese Funktionen festlegen und -1 errno zu EINVALzurück oder wenn value oder str außerhalb des Bereichs einer langen ganzen Zahl -1 (null) zurück, und diese Funktionen zu errnoERANGEfestlegen.

In C++ unter Verwendung dieser Funktionen wird von Vorlagen Operatoren vereinfacht. Die Überladungen können die Pufferlänge (die Anforderung automatisch beseitigend ableiten, die ein Argument angegeben) und können nicht-sicheren, die älteren Funktionen über ihre Äquivalente sicheren, aktuelleren automatisch ersetzen.Weitere Informationen finden Sie unter Speichern Sie Vorlagen-Überladungen.

Zuweisung generischer Textroutinen