_ltoa_s, _ltow_s

Articolo
06/09/2015

Converte un long integer in una stringa. Queste sono versioni di _ltoa, _ltow con i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in CRT.

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

Parametri

value
Numeri da convertire.
str
Buffer per la stringa risultato.
sizeOfstr
Dimensione di str in byte per _ltoa_s o le parole per _ltow_s.
radix
Base di value.

Valore restituito

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

Note

La funzione _ltoa_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. Se radix è uguale a 10 e value è negativo, il primo carattere della stringa memorizzata è il segno meno (–). _ltow_s è una versione a caratteri "wide" di _ltoa_s; il secondo argomento di _ltow_s è una stringa a caratteri "wide".

Se str è un puntatore a NULL o sizeOfstr è minore o uguale a zero, queste funzioni invocano un gestore di parametro non valido, 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 restituiscono un -1 e impostano 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