blob: a3f3cabc9e41067f9aa44057df8f7dd6e01786cc [file] [log] [blame]
Zesstra953f9972017-02-18 15:37:36 +01001
2log_file()
3**********
4
5
6FUNKTION
7========
8
9 int log_file(string file, string text)
10 int log_file(string file, string text, int size_to_break)
11
12
13ARGUMENTE
14=========
15
16 file - Name der Datei, in die geschrieben werden soll
17 text - Der Text, der geschrieben werden soll
18 size_to_break - Groesse, ab der ein neues File begonnen wird (optional)
19
20
21BESCHREIBUNG
22============
23
24 log_file schreibt den Text text in die Datei /log/file.
25 Sollte file schon mit einem /log/ beginnen, wird kein erneutes /log/ davor
26 eingefuegt.
27
28
29RUECKGABEWERT
30=============
31
32 1 bei Erfolg oder 0, falls ein Fehler beim Schreiben auftrat.
33
34
35BEMERKUNGEN
36===========
37
38 Wenn die Groesse von file vor dem Schreiben 50000 Bytes ueberschreitet,
39 wird sie in file.old umbenannt. Eine schon vorhandene Datei file.old
40 wird dabei geloescht. Der Text wird nach dem Umbenennen geschrieben.
41 Wird 'size_to_break' angegeben und ist dies > 0, wird dieser Wert (in
42 Bytes) statt der 50000 Bytes zum Rotieren des Logfiles benutzt.
43
44
45BEISPIELE
46=========
47
48 log_file( "report/wargon.rep", "TYPO von bla in blubb:\ntest\n");
49 In /log/report/wargon.rep finde ich nun die neueste Typomeldung... ;)
50 log_file( "/log/report/wargon.rep", "TYPO von bla in blubb:\ntest\n");
51 Gleiches Ergebnis. ;-)
52
53
54SIEHE AUCH
55==========
56
57 write_file(E)
58
5929.01.2017, Zesstra