_ltoa_s, _ltow_s

Articolo
03/05/2013

Converte un numero intero lungo 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
Numero da convertire.
str
buffer per la stringa di risultato.
sizeOfstr
Dimensione di str in byte per _ltoa_s o parole per _ltow_s.
radix
Base value.

Valore restituito

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

Note

_ltoa_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.se radix è pari a 10 e value è negativo, il primo carattere della stringa memorizzata è il segno meno (-)._ltow_s è una versione a caratteri estesi di _ltoa_s; il secondo argomento di _ltow_s è le stringhe di caratteri estesi.

se str è un oggetto NULL puntatore o sizeOfstr è minore o uguale a zero, queste funzioni viene richiamato un gestore non valido di parametro, 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 impostazioni 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