blob: b8bfb41513ab393ce0012cd29c89b078cdd9056d [file] [log] [blame]
log_file()
**********
FUNKTION
========
varargs int log_file(string file, string text, int size_to_break)
ARGUMENTE
=========
file
Name der Datei, in die geschrieben werden soll
text
Der Text, der geschrieben werden soll
size_to_break
Groesse, ab der ein neues File begonnen wird (optional)
BESCHREIBUNG
============
log_file schreibt den Text text in die Datei /log/file. Sollte file
schon mit einem /log/ beginnen, wird kein erneutes /log/ davor
eingefuegt. Falls das Zielverzeichnis unterhalb von /log/ noch
nicht existiert, wird dies automatisch angelegt, sofern das rufende
Objekt das Logfile schreiben darf.
RUECKGABEWERT
=============
1 bei Erfolg oder 0, falls ein Fehler beim Schreiben auftrat.
BEMERKUNGEN
===========
Wenn die Groesse von file vor dem Schreiben 50000 Bytes
ueberschreitet, wird sie in file.old umbenannt. Eine schon
vorhandene Datei file.old wird dabei geloescht. Der Text wird nach
dem Umbenennen geschrieben. Wird 'size_to_break' angegeben und ist
dies > 0, wird dieser Wert (in Bytes) statt der 50000 Bytes zum
Rotieren des Logfiles benutzt.
BEISPIELE
=========
log_file( "report/wargon.rep", "TYPO von bla in blubb:\ntest\n");
In /log/report/wargon.rep finde ich nun die neueste Typomeldung... ;)
log_file( "/log/report/wargon.rep", "TYPO von bla in blubb:\ntest\n");
Gleiches Ergebnis. ;-)
SIEHE AUCH
==========
write_file(E)
05.09.2018, Zesstra