_ltoa_s, _ltow_s

Artikel
06/09/2015

Konvertiert eine lange ganze Zahl in eine Zeichenfolge. Diese Versionen von _ltoa, _ltow enthalten Sicherheitserweiterungen wie unter Sicherheitsfunktionen in der CRT beschrieben.

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
Zu konvertierende Zahl.
str
Puffer für die Ergebniszeichenfolge.
sizeOfstr
Größe str in Bytes für _ltoa_s oder in Worten für _ltow_s.
radix
Basis für value.

Rückgabewert

Null wenn die Funktion erfolgreich oder ein Fehlercode war.

Hinweise

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

Wenn str ein Zeiger ist, NULL oder sizeOfstr kleiner oder gleich null ist, rufen diese Funktionen einen ungültigen Parameterhandler auf, wie in Parametervalidierung beschrieben. Wenn die Ausführung zulässig ist, um fortzufahren, geben diese Funktionen festgelegtem -1 und errno auf EINVAL ergibt oder, wenn value oder str aus Bereich eine lange ganze Zahl out, diese Funktionen -1 zurückgeben und errno auf ERANGE festlegen.

In C++ wird die Verwendung dieser Funktionen durch Vorlagenüberladungen vereinfacht; die Überladungen können automatisch Rückschlüsse auf die Pufferlänge ziehen (wodurch kein Größenargument mehr angegeben werden muss), und sie können automatisch die älteren, nicht sicheren Funktionen durch ihre neueren, sicheren Entsprechungen ersetzen. Weitere Informationen finden Sie unter Sichere Vorlagenüberladungen.

Zuordnung generischer Textroutinen