CKTIS / C
sscanf — geformatteerde gegevens uit een tekenreeks lezen
sscanf uit <stdio.h> leest gegevens volgens een formaat uit een tekenreeks die met een nul is beëindigd. De functie slaat resultaten op via pointers en geeft het aantal geslaagde toewijzingen terug (zonder `%n` mee te tellen), niet het aantal gelezen tekens.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdio.h>
int sscanf(const char * restrict s, const char * restrict format, ...);sscanf werkt net als fscanf, maar leest een tekenreeks in plaats van een stream. Het formaat beschrijft conversies en vereiste letterlijke tekens. %d vereist een int *; gebruik &age. Geef voor de array name de naam name zelf door.
Controleer de geretourneerde waarde voordat je de gegevens gebruikt: deze telt geslaagde toewijzingen en kan lager zijn dan verwacht of gelijk zijn aan 0. Een %n-richtlijn slaat het aantal tot dan toe gelezen tekens op, maar verhoogt de geretourneerde waarde niet. EOF geeft aan dat er een invoerfout was voordat de eerste conversie klaar was. Geslaagde toewijzingen garanderen niet dat de hele tekenreeks is verbruikt.
%s slaat voorafgaande witruimte over, leest een woord en voegt een nulkarakter toe. %7s heeft minstens 8 char-elementen nodig. De meeste conversies slaan voorafgaande witruimte over; %c, %[ en %n doen dat niet.
Een ongeschikt pointertype, een numeriek resultaat dat niet in het doelobject kan worden weergegeven, of kopiëren tussen overlappende objecten veroorzaakt ongedefinieerd gedrag. De veldbreedte controleert het numerieke bereik niet. In het voorbeeld worden beide resultaten pas gebruikt nadat count == 2 is gecontroleerd.
Voorbeelden
#include <stdio.h>
int main(void)
{
const char input[] = "Ada 42";
char name[8];
int age;
int count = sscanf(input, "%7s %d", name, &age);
if (count != 2) {
puts("Parse failed");
return 1;
}
printf("%s: %d\n", name, age);
return 0;
}Resultaat
Ada: 42
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.