====== std.log ======

Strukturiertes Logging mit 5 Leveln: DEBUG, INFO, WARN, ERROR, FATAL. Das globale Log-Level (''set_log_level'') filtert alle Nachrichten unterhalb des gesetzten Werts. Bedingte Ausgabe (''log_info_if''), Sektionsmarkierungen für Tracing (''log_section_enter''/''log_section_exit''), App-Lebenszyklus-Events (''log_app_start''/''log_app_end'') und eine optionale Callback-Funktion zum Weiterleiten an externe Log-Systeme.

Einsatzbereiche: Serveranwendungen, Hintergrunddienste, Produktions-Debugging, strukturiertes Monitoring.

**Autor:** Andreas Röne\\
**Copyright:** 2024-2025 Andreas Röne

----

===== Konstanten =====

^ Name ^ Typ ^ Wert ^ Sichtbarkeit ^
| ''LOG_LEVEL_DEBUG'' | ''int64'' | ''0'' | priv |
| ''LOG_LEVEL_INFO'' | ''int64'' | ''1'' | priv |
| ''LOG_LEVEL_WARN'' | ''int64'' | ''2'' | priv |
| ''LOG_LEVEL_ERROR'' | ''int64'' | ''3'' | priv |
| ''LOG_LEVEL_FATAL'' | ''int64'' | ''4'' | priv |

----

===== Funktionen =====

^ Signatur ^ Sichtbarkeit ^ Beschreibung ^
| ''log_level_to_string(level: int64): pchar'' | pub | Gibt Level-Name als String zurück |
| ''set_log_level(level: int64): void'' | pub | Setzt globales Log-Filter-Level |
| ''get_log_level(): int64'' | pub | Liest aktuelles Log-Level |
| ''log_debug(msg: pchar): void'' | pub | Schreibt Debug-Meldung ins Log |
| ''log_info(msg: pchar): void'' | pub | Schreibt Info-Meldung ins Log |
| ''log_warn(msg: pchar): void'' | pub | Schreibt Warnmeldung ins Log |
| ''log_error(msg: pchar): void'' | pub | Schreibt Fehlermeldung ins Log |
| ''log_fatal(msg: pchar): void'' | pub | Schreibt kritischen Fehler ins Log |
| ''log_debug_if(cond: bool, msg: pchar): void'' | pub | Loggt Debug-Meldung wenn Bedingung zutrifft |
| ''log_info_if(cond: bool, msg: pchar): void'' | pub | Loggt Info-Meldung wenn Bedingung zutrifft |
| ''log_warn_if(cond: bool, msg: pchar): void'' | pub | Loggt Warnung wenn Bedingung zutrifft |
| ''log_error_if(cond: bool, msg: pchar): void'' | pub | Loggt Fehler wenn Bedingung zutrifft |
| ''log_section_enter(name: pchar): void'' | pub | Markiert Beginn eines Trace-Abschnitts |
| ''log_section_exit(name: pchar): void'' | pub | Markiert Ende eines Trace-Abschnitts |
| ''log_app_start(name: pchar): void'' | pub | Loggt Applikationsstart-Event |
| ''log_app_end(code: int64): void'' | pub | Loggt Applikationsende mit Exit-Code |
| ''register_log_callback(fn_ptr: int64): void'' | pub | Registriert externen Log-Handler |
| ''unregister_log_callback(): void'' | pub | Entfernt registrierten Log-Handler |
| ''has_log_callback(): bool'' | pub | Prüft ob Callback registriert ist |