_ultoa_s, _ultow_s

Artikel
02/26/2013

Konvertieren einer langen ganzen Zahl ohne Vorzeichen in eine Zeichenfolge.Dies sind Versionen von _ultoa, _ultow mit beschrieben, wie unter Security Enhancements in Sicherheitsfeatures im CRT.

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
Der zu konvertierende Zahl.
str
Ergebnis der Zeichenfolgen.
sizeOfstr
Die Größe in Bytes für str_ultoa_s für den Wörtern oder _ultow_s.
radix
Basis von value.

Rückgabewert

Beliebige wenn die Funktion erfolgreich oder ein Fehlercode war.

Hinweise

Die _ultoa_s-Funktion konvertiert die Zahlen in value auf eine auf NULL endende Zeichenfolge und speichert das Ergebnis in Bytes) bis 33 ( str.Das radix-Argument gibt die Basis des valuean, die im Bereich 2 bis 36 sein muss._ultow_s Breitzeichen handelt es sich um eine Version von _ultoa_s. Das zweite Argument ist _ultow_s von Zeichenfolgen mit Breitzeichen.

Wenn strNULL ein Zeiger ist oder wenn sizeOfstr kleiner oder gleich null ist, wird der Ereignishandler aufgerufen, z. B. ungültige Parameter in Parametervalidierungbeschrieben.Wenn die Ausführung ermöglicht wird, um fortzufahren, geben diese Funktionen festlegen und -1 errno zu EINVALzurück oder wenn value oder str außerhalb des Bereichs einer langen ganzen Zahl -1 (null) zurück, und diese Funktionen zu errnoERANGEfestlegen.

In C++ unter Verwendung dieser Funktionen wird von Vorlagen Operatoren vereinfacht. Die Überladungen können die Pufferlänge (die Anforderung automatisch beseitigend ableiten, die ein Argument angegeben) und können nicht-sicheren, die älteren Funktionen über ihre Äquivalente sicheren, aktuelleren automatisch ersetzen.Weitere Informationen finden Sie unter Speichern Sie Vorlagen-Überladungen.

Zuweisung generischer Textroutinen