| Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 1 | log_file() |
| 2 | ========== |
| 3 | |
| 4 | FUNKTION |
| 5 | -------- |
| Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 6 | |
| Zesstra | 1cd2f9e | 2018-09-05 17:01:41 +0200 | [diff] [blame] | 7 | varargs int log_file(string file, string text, int size_to_break) |
| Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 8 | |
| 9 | ARGUMENTE |
| 10 | --------- |
| Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 11 | |
| Zesstra | 1cd2f9e | 2018-09-05 17:01:41 +0200 | [diff] [blame] | 12 | file |
| 13 | Name der Datei, in die geschrieben werden soll |
| 14 | |
| 15 | text |
| 16 | Der Text, der geschrieben werden soll |
| 17 | |
| 18 | size_to_break |
| 19 | Groesse, ab der ein neues File begonnen wird (optional) |
| Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 20 | |
| 21 | BESCHREIBUNG |
| 22 | ------------ |
| Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 23 | |
| Zesstra | 1cd2f9e | 2018-09-05 17:01:41 +0200 | [diff] [blame] | 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 | Falls das Zielverzeichnis unterhalb von /log/ noch nicht existiert, wird |
| 28 | dies automatisch angelegt, sofern das rufende Objekt das Logfile schreiben |
| 29 | darf. |
| Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 30 | |
| 31 | RUECKGABEWERT |
| 32 | ------------- |
| Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 33 | |
| 34 | 1 bei Erfolg oder 0, falls ein Fehler beim Schreiben auftrat. |
| 35 | |
| 36 | BEMERKUNGEN |
| 37 | ----------- |
| Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 38 | |
| 39 | Wenn die Groesse von file vor dem Schreiben 50000 Bytes ueberschreitet, |
| 40 | wird sie in file.old umbenannt. Eine schon vorhandene Datei file.old |
| 41 | wird dabei geloescht. Der Text wird nach dem Umbenennen geschrieben. |
| 42 | Wird 'size_to_break' angegeben und ist dies > 0, wird dieser Wert (in |
| 43 | Bytes) statt der 50000 Bytes zum Rotieren des Logfiles benutzt. |
| 44 | |
| 45 | BEISPIELE |
| 46 | --------- |
| Zesstra | 1cd2f9e | 2018-09-05 17:01:41 +0200 | [diff] [blame] | 47 | |
| 48 | .. code-block:: pike |
| Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 49 | |
| 50 | log_file( "report/wargon.rep", "TYPO von bla in blubb:\ntest\n"); |
| 51 | In /log/report/wargon.rep finde ich nun die neueste Typomeldung... ;) |
| 52 | log_file( "/log/report/wargon.rep", "TYPO von bla in blubb:\ntest\n"); |
| 53 | Gleiches Ergebnis. ;-) |
| 54 | |
| 55 | SIEHE AUCH |
| 56 | ---------- |
| Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 57 | |
| 58 | write_file(E) |
| 59 | |
| Zesstra | 1cd2f9e | 2018-09-05 17:01:41 +0200 | [diff] [blame] | 60 | 05.09.2018, Zesstra |
| Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 61 | |