C Logger er et enkelt og effektivt loggbibliotek for C-språket . Det lar deg skrive loggmeldinger til en fil eller til konsollen, med varierende detaljnivåer og kontroll. I denne artikkelen skal vi se hvilke funksjoner C Logger tilbyr, hvordan du installerer det og hvordan du bruker det i C-prosjektene dine.
Funksjonene til cloggeren
C logger er et lettvektsbibliotek, som bare består av 500 linjer med kildekode. Det er kompatibelt med C89-standarden og er trådsikkert. Det tilbyr to typer logging:
- Konsolllogging, som viser loggmeldinger i standardutdata eller feilutdata.
- Logging til en fil, som skriver loggmeldinger til en tekstfil, med automatisk rotasjon basert på filstørrelse.
c logger tillater også tilpasning av logging med en konfigurasjonsfil, der du kan definere meldingsformat, detaljnivå, loggfilnavn, maksimal filstørrelse osv.
Hvordan installerer jeg Clogger?
For å installere C Logger, last ned kildekoden fra GitHub-repositoriet og kompiler den med din foretrukne C-kompilator. For eksempel, med gcc:
$ git klon https://github.com/yksz/c-logger.git $ cd c-logger $ gcc -c -o logger.o logger.c $ ar rcs libclogger.a logger.o
Dette vil opprette et statisk arkiv, libclogger.a, som du kan koble til C-programmet ditt. Du må også inkludere logger.h-headerfilen i kildefilene dine.
Hvordan bruker jeg tilstopping?
For å bruke C Logger må du først initialisere biblioteket med `logger_init`- , og gi den navnet på konfigurasjonsfilen, eller `NULL` hvis du vil bruke standardinnstillingene. Deretter kan du bruke `logger`- til å skrive loggmeldinger, og gi den en tagg, et nivå og en melding. For eksempel:
#include "logger.h" int main(void) { /* Initialiser biblioteket med config.ini-filen */ if (logger_init("config.ini") != 0) { fprintf(stderr, "Feil ved initialisering av c logger\n"); return 1; } /* Skriv en INFO-nivåmelding med "main"-taggen */ logger("main", LOG_INFO, "Program startet"); /* Skriv en ERROR-nivåmelding med "main"-taggen */ logger("main", LOG_ERROR, "Fatal error"); /* Avslutt biblioteket */ logger_end(); return 0; }
Formatet på loggmeldinger avhenger av konfigurasjonsfilen som brukes. Som standard er det i formatet:
melding på datetime-tagnivå
For eksempel:
2023-06-13 02:37:16 main INFO Programstart 2023-06-13 02:37:16 main FEIL Fatal feil
Formatet kan endres ved hjelp av følgende variabler i konfigurasjonsfilen:
- %d: datoen i formatet ÅÅÅÅ-MM-DD
- %t: tiden i HH:MM:SS-format
- %c: meldingstaggen
- %l: meldingsnivået
- %m: meldingen
- %n: et linjeskift
Hvis vi for eksempel ønsker et kortere format, kan vi bruke:
[formater] enkel = "%t %c %l %m%n"
Hvilke detaljnivåer er tilgjengelige?
c logger tilbyr fem detaljnivåer for loggmeldinger:
- LOG_DEBUG: for feilsøking av meldinger, nyttig for utviklere.
- LOG_INFO: for informative meldinger, nyttig for brukere.
- LOG_WARN: for advarselsmeldinger, nyttig for rapportering av unormale, men ikke kritiske situasjoner.
- LOG_ERROR: for feilmeldinger, nyttig for å signalisere kritiske situasjoner som hindrer programmet i å fungere riktig.
- LOG_FATAL: for fatale meldinger, nyttig for å signalisere uopprettelige situasjoner som krever at programmet stoppes.
Detaljnivået i loggmeldinger kan kontrolleres ved hjelp av `log_level` i konfigurasjonsfilen. Hvis du for eksempel bare vil vise ERROR- og FATAL-meldinger, kan du bruke:
[generelt] log_level = 3
Nivåene er nummerert fra 0 til 4, fra mest detaljert til minst detaljert. Som standard er nivået satt til 0, som viser alle meldinger.
Hvordan kontrollere størrelsen på loggfilen?
c logger lar deg begrense loggfilstørrelsen ved å bruke `max_file_size` i konfigurasjonsfilen. Hvis du for eksempel vil at loggfilen ikke skal være større enn 1 MB, kan du bruke:
[generell] maks_filstørrelse = 1048576
Størrelsen uttrykkes i byte. Som standard er det ingen størrelsesgrense.
Når loggfilen når sin maksimale størrelse, oppretter c logger en ny fil med et numerisk suffiks. Hvis for eksempel loggfilnavnet er log.txt , vil den første filen som opprettes være log.txt.1 , deretter log.txt.2 , og så videre. Maksimalt antall filer som opprettes styres av max_file_count i konfigurasjonsfilen. Hvis du for eksempel vil beholde maksimalt 10 loggfiler, kan du bruke:
[generelt] maks_filantall = 10
Som standard er det ingen grense for antall filer.
Vanlige spørsmål
Hva er forskjellen mellom c logger og andre loggbiblioteker som log4c eller nglogc?
C Logger skiller seg ut med sin enkelhet og lette design. Selv om den ikke tilbyr like mange funksjoner som noen mer omfattende biblioteker, dekker den de viktigste behovene for logging. Den er også kompatibel med C89-standarden og trådsikker.
Hvordan kan jeg vise loggmeldinger i et annet format enn tekst?
c logger støtter bare tekstformat for loggmeldinger. Hvis du vil bruke et annet format, for eksempel JSON eller XML, må du skrive din egen formateringsfunksjon og kalle den i loggerfunksjonen .
Hvordan kan jeg filtrere loggmeldinger basert på tagg eller nivå?
c logger tilbyr ikke avansert filtrering av loggmeldinger. Du kan bare kontrollere det generelle meldingsnivået ved å bruke `log_level` i konfigurasjonsfilen. Hvis du vil filtrere meldinger basert på tagg eller nivå, må du skrive din egen filtreringsfunksjon og kalle den i `logger`- .
Hvordan kan jeg sende loggmeldinger til et annet mål enn konsollen eller en fil?
C-loggeren støtter bare konsollen og filer som destinasjoner for loggmeldinger. Hvis du vil sende meldinger til en annen destinasjon, for eksempel en database eller webtjeneste, må du skrive din egen send-funksjon og kalle den i loggerfunksjonen .
Hvordan feilsøker jeg C-logger hvis det er et problem?
`logger_debug`- funksjon som viser informasjon om bibliotekets interne tilstand. Du kan når som helst kalle den for å sjekke om C-loggeren fungerer som den skal.
Konklusjon
clogger er et enkelt og effektivt loggbibliotek for C-språket. Det lar deg skrive loggmeldinger til en fil eller til konsollen, med varierende detaljnivåer og kontroll. Det er enkelt å installere og bruke, og tilbyr tilpasning via en konfigurasjonsfil. clogger er basert på objektorienterte programmeringsprinsipper , som lar deg opprette loggobjekter med spesifikke egenskaper og metoder. clogger er en ideell løsning for utviklere som ønsker å legge til loggfunksjonalitet i C-prosjektene sine uten problemer.
