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.