_strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l

Articolo
03/05/2013

Convertire una stringa in un oggetto __int64 valore.

__int64 _strtoi64(
   const char *nptr,
   char **endptr,
   int base 
);
__int64 _wcstoi64(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base 
);
__int64 _strtoi64_l(
   const char *nptr,
   char **endptr,
   int base,
   _locale_t locale
);
__int64 _wcstoi64_l(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

Parametri

nptr
Stringa con terminazione null da convertire.
endptr
Puntatore al carattere che interrompe la funzionalità.
base
Base numerica da utilizzare.
locale
le impostazioni locali da utilizzare.

Valore restituito

_strtoi64restituisce il valore rappresentato nella stringa nptr, ad eccezione di quando la rappresentazione può provocare un overflow, nel qual caso restituisca _I64_MAX o _I64_MIN.La funzione restituirà 0 se nessuna conversione può essere eseguito._wcstoi64 restituisce valori analogamente a strtoi64.

_I64_MAX e _I64_MIN essere definito in LIMITS.H.

se nptr viene NULL o base sono diversi da zero e meno di 2 o maggiore di 36, errno è impostato su EINVAL.

vedere _doserrno, errno, _sys_errlist e _sys_nerr per ulteriori informazioni su questi e su altri, codici restituiti.

Note

_strtoi64conversione di funzione nptr in __int64.interruzione di entrambe le funzioni che legge la stringa nptr al primo carattere non sono in grado di riconoscere come parte di un numero.Ciò può rappresentare il carattere di terminazione null, oppure può essere il primo carattere numerico maggiore o uguale a base._wcstoi64 è una versione a caratteri estesi di _strtoi64; relativo nptr l'argomento è una stringa di caratteri estesi.Queste funzioni si comportano in modo identico in caso contrario.

Mapping di routine a testo generico

routine di TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tcstoi64	_strtoi64	_strtoi64	_wcstoi64
_tcstoi64_l	_strtoi64_l	_strtoi64_l	_wcstoi64_l

le impostazioni locali LC_NUMERIC l'impostazione di categoria determina il riconoscimento di carattere di base in nptr; per ulteriori informazioni, vedere setlocale.Le funzioni senza il suffisso del _l utilizzano le impostazioni locali correnti, _strtoi64_l e_wcstoi64_l essere identico alla funzione corrispondente senza _l suffiggere con la differenza che utilizzano le impostazioni locali passate in alternativa.Per ulteriori informazioni, vedere Impostazioni locali.

se endptr non viene NULL, un puntatore al carattere che viene chiusa la funzionalità viene archiviato nella posizione indicata da endptr.Se nessuna conversione può essere eseguita (nessuna cifra valida è stata trovata o una base non valida è stata specificata), il valore di nptr viene archiviato nella posizione indicata da endptr.

_strtoi64prevede nptr per indicare una stringa di formato seguente:

[whitespace] [{+ | –}] [0 [{ x | X }]] [digits]

In whitespace può essere costituito dallo spazio e di caratteri di tabulazione, che vengono ignorati; digits sono uno o più cifre decimali.Il primo carattere che non supporta le interruzioni del form la funzionalità.se base è compreso tra 2 e 36, pertanto viene utilizzata come base del numero.se base è 0, i caratteri iniziali della stringa indicata da nptr viene utilizzato per determinare la base.Se il primo carattere è 0 e il secondo carattere non è “x„ o “X„, la stringa viene interpretata come Integer ottale; in caso contrario, viene interpretata come numero decimale.Se il primo carattere è “0 " e il secondo carattere è “x„ o “X„, la stringa viene interpretata come Integer esadecimale.Se il primo carattere è “1 " e “9 ", la stringa viene interpretata come Integer decimale.Le lettere “a„ e “z„ (o “A„ e “Z ") sono assegnati i valori da 10 a 35; solo lettere dei cui valori assegnati inferiori a base essere valido.