strtoul, _strtoul_l, wcstoul, _wcstoul_l

Articolo
03/05/2013

Stringhe in un valore unsigned dell'a lungo Integer.

unsigned long strtoul(
   const char *nptr,
   char **endptr,
   int base 
);
unsigned long _strtoul_l(
   const char *nptr,
   char **endptr,
   int base,
   _locale_t locale
);
unsigned long wcstoul(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base 
);
unsigned long _wcstoul_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
impostazioni locali da utilizzare.

Valore restituito

strtoul restituisce il valore convertito, se presente, o ULONG_MAX in overflow.strtoul restituisce 0 se nessuna conversione può essere eseguito.wcstoul restituisce valori analogamente a strtoul.per entrambe le funzioni, errno è impostato su ERANGE se un overflow o un underflow si verifica.

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

Note

Ognuna di queste funzioni converte la stringa di input nptr in unsigned long.

strtoul interrompe la lettura della stringa nptr al primo carattere non è 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.LC_NUMERIC l'impostazione di categoria di impostazioni locali determina il riconoscimento di carattere di base in nptr; per ulteriori informazioni, vedere setlocale.strtoul ewcstoul utilizzare le impostazioni locali correnti, _strtoul_l e_wcstoul_l sono identiche tranne per il fatto 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.

wcstoul è una versione a caratteri estesi di strtoul; relativo nptr l'argomento è una stringa di caratteri estesi.In caso contrario queste funzioni si comportano in modo identico.

Mapping di routine a testo generico

routine di TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tcstoul	strtoul	strtoul	wcstoul
_tcstoul_l	strtoul_l	_strtoul_l	_wcstoul_l

strtoul prevede 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.strtoul consente a più (+) o meno (–) prefisso del segno; un segno meno iniziale indica che il valore restituito viene negata.