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