_ultoa, _ultow
Konvertiert eine lange ganze Zahl ohne Vorzeichen in eine Zeichenfolge. Sicherere Versionen dieser Funktionen sind verfügbar. Informationen dazu finden Sie unter _ultoa_s, _ultow_s.
char *_ultoa(
unsigned long value,
char *str,
int radix
);
wchar_t *_ultow(
unsigned long value,
wchar_t *str,
int radix
);
template <size_t size>
char *_ultoa(
unsigned long value,
char (&str)[size],
int radix
); // C++ only
template <size_t size>
wchar_t *_ultow(
unsigned 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 _ultoa-Funktion konvertiert value in eine auf NULL endende Zeichenfolge und speichert das Ergebnis (bis zu 33 Bytes) in str. Keine Sammelüberprüfung wird ausgeführt. radix gibt der Basis von value; radix muss im Bereich 2 - 36. _ultow ist eine Breitzeichenversion von _ultoa.
.gif "Sicherheitshinweis") Sicherheitshinweis |
|---|
Um Pufferüberläufe zu verhindern, sorgen Sie dafür dass der Puffer str groß genug ist die konvertierten Ziffern plus das nachfolgende NULL-Zeichen aufzunehmen. |
In C++ haben diese Funktionen Vorlagenüberladungen, mit denen die neueren, sicheren Entsprechungen dieser Funktionen aufgerufen werden. Weitere Informationen finden Sie unter Sichere Vorlagenüberladungen.
Zuordnung generischer Textroutinen
TCHAR.H-Routine |
_UNICODE & _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
|---|---|---|---|
_ultot |
_ultoa |
_ultoa |
_ultow |
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
_ultoa |
<stdlib.h> |
_ultow |
<stdlib.h> oder <wchar.h> |
Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.
Beispiel
Im Beispiel für _itoa.