blob: 3c58ec1476b70384e7e66425a8e115d318f82bfd [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001SYNOPSIS
Zesstrad59c3892019-11-28 20:53:39 +01002 string read_file(string file, int start, int anzahl, string encoding)
MG Mud User88f12472016-06-24 23:31:02 +02003
4BESCHREIBUNG
5 Liest Zeilen aus einem File <file>. Wenn <start> angegeben ist und
6 nicht 0, wird von Beginn der Zeile <start> an gelesen; ist <start> 0
7 oder nicht angegeben, wird vom Beginn des Files gelesen.
8
9 Wenn <anzahl> nicht angegeben oder 0 ist, wird das gesamte File
10 gelesen, sonst nur <anzahl> Zeilen.
11
Zesstrad59c3892019-11-28 20:53:39 +010012 Mit <encoding> kann man den Zeichensatz spezifieren, der beim
13 Lesen der Datei angewandt werden soll. Falls er nicht angeben oder
14 0 ist, so wird der Hook H_FILE_ENCODING verwendet.
15
MG Mud User88f12472016-06-24 23:31:02 +020016 Wenn <start> ausserhalb der Groesse des Files liegt, liefert
17 read_file() anstelle eines Strings 0 zurueck.
18
19 Die max. Anzahl einzulesender Bytes (nicht Zeilen!) pro Aufruf dieser
20 Funktion betraegt LIMIT_FILE (s. query_limits()).
21
Zesstrad59c3892019-11-28 20:53:39 +010022GESCHICHTE
23 LDMud 3.6.0 fuegte den <encoding>-Parameter hinzu.
24
MG Mud User88f12472016-06-24 23:31:02 +020025SIEHE AUCH
Zesstrad59c3892019-11-28 20:53:39 +010026 read_bytes(E), write_file(E), hooks(C)