_ltoa, _ltow

Artikel
06/09/2015

Konvertiert eine lange ganze Zahl in eine Zeichenfolge. Sicherere Versionen dieser Funktionen sind verfügbar. Informationen dazu finden Sie unter _ltoa_s, _ltow_s.

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

Parameter

value
Zu konvertierende Zahl.
str
Zeichenfolgenergebnis.
radix
Basis für value.

Rückgabewert

Jede dieser Funktionen gibt einen Zeiger auf str zurück. Es gibt keine Fehlerrückgabe.

Hinweise

Die _ltoa-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 ist eine Breitzeichen-Version von _ltoa; das zweite Argument und der Rückgabewert von _ltow sind Zeichenfolgen mit Breitzeichen. Jede dieser Funktionen ist Microsoft-spezifische.

Sicherheitshinweis
Um Pufferüberläufe zu verhindern, muss der str-Puffer groß genug für die konvertierten Ziffern, das abschließende NULL-Zeichen sowie ein Zeichen sein.