_ultoa_s, _ultow_s

Artikel
06/09/2015

Konvertiert eine lange ganze Zahl ohne Vorzeichen in eine Zeichenfolge. Diese Versionen von _ultoa, _ultow enthalten Sicherheitserweiterungen wie unter Sicherheitsfunktionen in der CRT beschrieben.

errno_t _ultoa_s(
    unsigned long value,
    char *str,
    size_t sizeOfstr,
    int radix 
);
errno_t _ultow_s(
    unsigned long value,
    wchar_t *str,
    size_t sizeOfstr,
    int radix 
);
template <size_t size>
errno_t _ultoa_s(
    unsigned long value,
    char (&str)[size],
    int radix 
); // C++ only
template <size_t size>
errno_t _ultow_s(
    unsigned long value,
    wchar_t (&str)[size],
    int radix 
); // C++ only

Parameter

value
Zu konvertierende Zahl.
str
Zeichenfolgenergebnis.
sizeOfstr
Die Größe str in Bytes für _ultoa_s oder in Worten für _ultow_s.
radix
Basis für value.

Rückgabewert

Null wenn die Funktion erfolgreich oder ein Fehlercode war.

Hinweise

Die _ultoa_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. _ultow_s ist eine Breitzeichen-Version von _ultoa_s; das zweite Argument _ultow_s ist Zeichenfolgen mit Breitzeichen.

Wenn str ein NULL Zeiger ist oder wenn sizeOfstr kleiner oder gleich null ist, wird der ungültige Parameterhandler aufgerufen, 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