Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

strtoul — convertir du texte en unsigned long

Présente la conversion de texte en unsigned long et la vérification du résultat. L’exemple montre le contrôle de la plage et le rejet d’un suffixe non consommé.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <stdlib.h>
unsigned long int strtoul(const char *restrict nptr, char **restrict endptr, int base);

strtoul convertit le début de la chaîne nptr en unsigned long. Les espaces initiaux sont ignorés et un signe + ou - est accepté.

base : 2–36 ou 0 (détection automatique : 0 — octal, 0x/0X — hexadécimal, 0b/0B — binaire en C23, décimal sinon). C23 accepte également le préfixe binaire lorsque base == 2.

Si on passe &end, la fonction enregistre dans end l’adresse du premier caractère non consommé. Si on passe NULL, elle ne stocke pas cette adresse. En l’absence de conversion, le résultat est 0 et end == nptr. Un dépassement de plage donne ULONG_MAX et errno == ERANGE : définissez d’abord errno à 0. Une conversion complète exige *end == '\0'.

Le signe moins n’est pas automatiquement une erreur : "-1" donne ULONG_MAX. Pour interdire les nombres négatifs, rejetez le signe moins après les espaces initiaux. Un indicateur de compilation C23 ne garantit pas la prise en charge de C23 par la bibliothèque d’exécution.

Exemples

#include <errno.h>
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    const char *text = "42";
    char *end;
    errno = 0;
    unsigned long value = strtoul(text, &end, 10);

    if (end == text || errno == ERANGE || *end != '\0') {
        puts("invalid");
        return EXIT_FAILURE;
    }

    printf("value=%lu\n", value);
    return EXIT_SUCCESS;
}

Résultat

value=42

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources