blob: 136c575e08327353a4ccdf162ffa45756ccac747 [file] [log] [blame]
Zesstra953f9972017-02-18 15:37:36 +01001log_file()
2**********
MG Mud User88f12472016-06-24 23:31:02 +02003
MG Mud User88f12472016-06-24 23:31:02 +02004
Zesstra953f9972017-02-18 15:37:36 +01005FUNKTION
6========
MG Mud User88f12472016-06-24 23:31:02 +02007
Zesstra6cadc1b2018-11-15 22:27:32 +01008 varargs int log_file(string file, string text, int size_to_break)
MG Mud User88f12472016-06-24 23:31:02 +02009
MG Mud User88f12472016-06-24 23:31:02 +020010
Zesstra953f9972017-02-18 15:37:36 +010011ARGUMENTE
12=========
13
Zesstra6cadc1b2018-11-15 22:27:32 +010014 file
15 Name der Datei, in die geschrieben werden soll
16
17 text
18 Der Text, der geschrieben werden soll
19
20 size_to_break
21 Groesse, ab der ein neues File begonnen wird (optional)
Zesstra953f9972017-02-18 15:37:36 +010022
23
24BESCHREIBUNG
25============
26
Zesstra6cadc1b2018-11-15 22:27:32 +010027 log_file schreibt den Text text in die Datei /log/file. Sollte file
28 schon mit einem /log/ beginnen, wird kein erneutes /log/ davor
29 eingefuegt. Falls das Zielverzeichnis unterhalb von /log/ noch
30 nicht existiert, wird dies automatisch angelegt, sofern das rufende
31 Objekt das Logfile schreiben darf.
Zesstra953f9972017-02-18 15:37:36 +010032
33
34RUECKGABEWERT
35=============
36
37 1 bei Erfolg oder 0, falls ein Fehler beim Schreiben auftrat.
38
39
40BEMERKUNGEN
41===========
42
Zesstra6cadc1b2018-11-15 22:27:32 +010043 Wenn die Groesse von file vor dem Schreiben 50000 Bytes
44 ueberschreitet, wird sie in file.old umbenannt. Eine schon
45 vorhandene Datei file.old wird dabei geloescht. Der Text wird nach
46 dem Umbenennen geschrieben. Wird 'size_to_break' angegeben und ist
47 dies > 0, wird dieser Wert (in Bytes) statt der 50000 Bytes zum
48 Rotieren des Logfiles benutzt.
Zesstra953f9972017-02-18 15:37:36 +010049
50
51BEISPIELE
52=========
53
54 log_file( "report/wargon.rep", "TYPO von bla in blubb:\ntest\n");
55 In /log/report/wargon.rep finde ich nun die neueste Typomeldung... ;)
56 log_file( "/log/report/wargon.rep", "TYPO von bla in blubb:\ntest\n");
57 Gleiches Ergebnis. ;-)
58
59
60SIEHE AUCH
61==========
62
63 write_file(E)
MG Mud User88f12472016-06-24 23:31:02 +020064
Zesstra6cadc1b2018-11-15 22:27:32 +01006505.09.2018, Zesstra