CKTIS / C
strtol — tekst omzetten naar long
strtol leest een long-geheel getal vanaf het begin van tekst. Controleer endptr en errno om fouten en niet-verwerkte tekens aan het einde te detecteren.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdlib.h>
long int strtol(const char *restrict nptr, char **restrict endptr, int base);strtol uit <stdlib.h> slaat voorloopspaties over, accepteert een optioneel +- of --teken en zet cijfers om naar long.
base moet 0 of 2–36 zijn. Met 0 worden decimale, octale (0), hexadecimale (0x) en, in C23, binaire notaties (0b) herkend. De expliciete bases 16 en 2 staan de bijbehorende prefixen toe. Een C23-compileroptie bevestigt niet dat de runtimebibliotheek ondersteuning biedt.
Als endptr != NULL, wijst *endptr naar het eerste niet-verwerkte teken. Als er niets wordt omgezet, retourneert de functie 0 en geldt *endptr == nptr; alleen de waarde 0 duidt niet op een fout.
Stel vóór de aanroep errno = 0 in. Een waarde buiten het bereik retourneert LONG_MIN of LONG_MAX en stelt ERANGE in. Als endptr != NULL en de hele tekst moet worden verwerkt, controleer dan ook **endptr == '\0': vergelijk het teken waarnaar *endptr wijst met het afsluitende teken van de tekenreeks, niet de pointer zelf. In de C-locale blijft witruimte aan het einde onverwerkt. In andere locales kan de functie aanvullende, locale-specifieke invoervormen accepteren. Als het afsluitende teken wordt bereikt, is de hele tekenreeks verwerkt; dat betekent niet dat de invoer voldoet aan de syntaxis van de C-locale.
Voorbeelden
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
const char *text = "123";
char *end;
errno = 0;
long value = strtol(text, &end, 10);
if (end == text) {
puts("no digits");
return EXIT_FAILURE;
}
if (errno == ERANGE) {
puts("out of range");
return EXIT_FAILURE;
}
if (*end != '\0') {
puts("trailing characters");
return EXIT_FAILURE;
}
printf("value=%ld\n", value);
return EXIT_SUCCESS;
}Resultaat
value=123
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.