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
---------

.. code-block:: pike

	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