KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

strerror — een foutcode beschrijven

strerror zet een foutcode om in een melding. De geretourneerde tekst hangt af van de implementatie en de locale.

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

Syntax

#include <string.h>
char *strerror(int errnum);

strerror(errnum) uit <string.h> retourneert een melding voor elke waarde van het type int, meestal afkomstig van errno. De functie beschrijft een code; ze detecteert niet of een bewerking is mislukt.

Ondanks het retourtype char * mag je de geretourneerde array niet wijzigen. Een volgende aanroep van strerror kan de inhoud van de array overschrijven. Gebruik de geretourneerde pointer niet meer nadat de thread die hem heeft verkregen is beëindigd. Heb je de tekst na een volgende aanroep of na het einde van die thread nog nodig, kopieer die dan vooraf.

Gelijktijdige aanroepen kunnen dataraces veroorzaken. Ga niet uit van een specifieke formulering van de melding. Het voorbeeld geeft EDOM door zonder opzettelijk een fout te veroorzaken.

Voorbeelden

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

int main(void)
{
    const char *message = strerror(EDOM);
    printf("message_available=%d\n", message != NULL && message[0] != '\0');
    return 0;
}

Resultaat

message_available=1

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.

Bronnen