_ultoa_s, _ultow_s

Articolo
03/05/2013

Convertire un valore unsigned long in una stringa.queste sono versioni di _ultoa, _ultow con i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in 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

Parametri

value
Numero da convertire.
str
Risultato della stringa.
sizeOfstr
La dimensione di str in byte per _ultoa_s o parole per _ultow_s.
radix
Base value.

Valore restituito

Zero se la funzione è stata completata o un codice di errore.

Note

_ultoa_s la funzione consente di convertire le cifre di value in una stringa di caratteri con terminazione null e agli archivi il risultato (fino a 33 byte) in str.radix l'argomento indica la base di value, che deve essere compreso tra 2 e 36._ultow_s è una versione a caratteri estesi di _ultoa_s; il secondo argomento di _ultow_s è le stringhe di caratteri estesi.

se str è un oggetto NULL puntatore, o se sizeOfstr è minore o uguale a zero, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, queste funzioni restituiscono -1 e impostate errno in EINVALoppure value o str dell'intervallo di un intero lungo, queste funzioni restituiscono un -1 e configureranno errno in ERANGE.

In C++, utilizzando queste funzioni è semplificato dagli overload del modello; gli overload possono dedurre la lunghezza del buffer automaticamente (che elimina la necessità di specificare un argomento di dimensione) e possono sostituire automaticamente le funzioni precedenti e non sicure con le più recenti, controparti sicure.Per ulteriori informazioni, vedere Assicurarsi che gli overload del modello.

Mapping di routine a testo generico