_ltoa_s, _ltow_s
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
Tchar.h-Routine |
_UNICODE und _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
---|---|---|---|
_ltot_s |
_ltoa_s |
_ltoa_s |
_ltow_s |
Anforderungen
Routine |
Erforderlicher Header |
---|---|
_ltoa_s |
<stdlib.h> |
_ltow_s |
<stdlib.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.