_ultoa_s, _ultow_s

Articolo
06/09/2015

Converte un intero long senza segno 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
Numeri da convertire.
str
Stringa di risultato.
sizeOfstr
La dimensione di str in byte per _ultoa_s o le parole per _ultow_s.
radix
Base di value.

Valore restituito

Zero se la funzione in caso di successo o un codice di errore.

Note

La funzione _ultoa_s converte le cifre di value a una stringa di caratteri con terminazione null e archivia il risultato (fino a 33 byte) in str. L'argomento radix specifica la base di value, che deve essere compreso tra 2 e 36. _ultow_s è una versione a caratteri "wide" di _ultoa_s; il secondo argomento di _ultow_s è una stringa a caratteri "wide".

Se str è un puntatore a NULL o se sizeOfstr è minore o uguale a zero, il gestore di parametro non valido viene invocato, come descritto in Convalida dei parametri. Se all'esecuzione è consentito continuare, queste funzioni restituiscono -1 e impostato errno su EINVAL o se value o str sono fuori dall'intervallo di un long integer, queste funzioni restituiranno un -1 ed imposteranno errno a ERANGE.

In C++ l'utilizzo di queste funzioni è semplificato dagli overload dei modelli. Gli overload possono dedurre la lunghezza del buffer automaticamente (eliminando la necessità di specificare un argomento di dimensione) e possono sostituire automaticamente le funzioni precedenti e non sicure con le controparti più recenti e sicure. Per ulteriori informazioni, vedere Overload di modelli sicuri.

Mapping di routine di testo generico