Langage de programmation - C++ - Référence de procédures et de fonctions

STRTOUL	Chaîne à naturel long
Langage C++	cstdlib (stdlib.h)

Syntaxe

unsigned long strtoul(const char *str1,char **fin,int base)

Paramètres

Nom	Description
str1	Ce paramètre permet d'indiquer la chaîne de caractères ASCIZ contenant le nombre.
fin	Ce paramètre retourne un pointeur à la fin du nombre dans la chaîne de caractères ASCIZ.
base	Ce paramètre permet d'indiquer la base numérique du nombre à extraire (1 à 36).

Description

Cette fonction permet de convertir la chaîne de caractères en nombre de type non-signée «long».

Remarques

La fonction strtoul() convertit la représentation sous le format d'une chaîne de caractères d'un nombre entreposé dans la chaîne de caractères pointée par str1 en un long non signé et renvoie le résultat. La base du nombre est déterminée par base. Si le paramètre base est zéro, la base est déterminée par des règles régissant la spécification constante. Si le base est spécifié, il doit être compris entre 2 et 36.
La fonction strtoul() fonctionne comme suit. Tout d'abord, tout espace blanc dans la chaîne de caractères pointée par str1 est supprimé. Ensuite, chaque caractère comprenant le numéro est lu. Tout caractère ne pouvant pas faire partie d'un nombre entier long non signé entraînera l'arrêt de ce processus. Cette situation inclut les espaces blancs, la ponctuation et les caractères. Enfin, fin est défini pour pointer vers le reste, le cas échéant, de la chaîne de caractères d'origine. Cela signifie que si la fonction strtoul() est appelé avec "100 gladir", la valeur 100L sera renvoyée et fin pointera vers l'espace précédant "gladir".
Si le résultat ne peut pas être représenté par un entier long non signé, la fonction strtoul() renvoie ULONG_MAX et la variable globale errno est définie sur ERANGE, indiquant une erreur d'intervalle. Si aucune conversion n'a lieu, zéro est renvoyé.

Exemple

Voici quelques exemples typiques de l'utilisation de cette fonction :

Essayer maintenant !



#include <iostream>

#include <cstdlib>

 
int main()

{

     char *s, *sr;

     s = "0";

     std::cout << "0 = " << strtoul(s,&sr,10) << std::endl;

     s = "1";

     std::cout << "1 = " << strtoul(s,&sr,10) << std::endl;

     s = "123";

     std::cout << "123 = " << strtoul(s,&sr,10) << std::endl;

     s = "-123";

     std::cout << "-123 = " << strtoul(s,&sr,10) << std::endl;

     s = "G";

     std::cout << "G = " << strtoul(s,&sr,10) << std::endl;

     return 0;

}

on obtiendra le résultat suivant :

0 = 0 1 = 1 123 = 123 -123 = 4294967173 G = 0

Voir également

Langage de programmation - C++ - Référence procédures et fonctions - atol
Langage de programmation - C++ - Référence procédures et fonctions - strtol
Langage de programmation - C - Référence procédures et fonctions - strtoul

Références

Langage C, Edition Micro-Application, Gehard Willms, 2001, ISBN: 2-7429-2008-0, page 735.
Borland C++ for Windows 4.0, Library Reference, Edition Borland, 1993, Part # BCP1240WW21772, page 270.

Dernière mise à jour : Lundi, le 3 août 2015

Section courante

A propos

Section administrative du site

STRTOUL