blob: c5019dc691425ef813bfae2d971c4d979a7b12a5 [file] [log] [blame]
Zesstra18626972017-01-31 10:38:27 +01001More()
2======
3
4FUNKTION
5--------
6::
7
8 varargs public void More(string txt, int file,
9 mixed ctrl, mixed *ctrlargs, int flags);
10
11DEFINIERT IN
12------------
13::
14
15 /std/util/pager.c
16
17ARGUMENTE
18---------
19::
20
21 txt - entweder ein Text der ausgegeben werden soll, oder ein filename.
22 file - das flag file gibt an, ob es sich bei <txt> um einen text oder
23 einen Filenamen handelt. Bei einem Filenamen wird der Inhalt
24 dieses Files eingelesen und ausgegeben.
25 ctrl - Eine closure, die aufgerufen wird, falls kein <txt> angegeben
26 wurde.
27 ctrlargs - ctrlargs wird als Parameter an ctrl uebergeben.
28 flags - flags wird mit den im Spieler definierten P_MORE_FLAGS
29 kombiniert.
30
31BESCHREIBUNG
32------------
33::
34
35 More() dient der Ausgabe von Texten an Spieler. Mit Hilfe eines
36 PL->More(txt) oder PL->More(txt, 1) ist es sehr einfach laengere Texte
37 an Spieler auszugeben. Bei der Ausgabe werden die persoenlichen
38 Einstellungen des Spielern (wie z.b. Zeilen pro Bildschirmseite)
39 automatisch beruecksichtigt und der Text dadurch ggf. zerstueckelt
40 und in mehreren Schritten nacheinander angezeigt.
41
42RUeCKGABEWERT
43-------------
44::
45
46 keiner
47
48BEMERKUNGEN
49-----------
50::
51
52 Beim einlesen des Files sind die Leserechte des Spieler in dem More()
53 aufgerufen wird von Bedeutung und nicht die Rechte des Objektes das
54 More() aufruft. Spielerobjekte haben im MorgenGrauen jedoch nur sehr
55 eingeschraenkte Leserechte! Ausgegeben werden koennen nur files
56 aus /p/*, /gilden/* und /d/* die _keinen_ code enthalten. Als Code
57 wird hierbei jedes File betrachtet das als vorletztes Zeichen einen .
58 hat (also .c, .h, .o usw.).
59 Will man aus irgendwelchen Gruenden ein File (z.b. aus /players/)
60 ausgeben, so sollte man stattdessen folgendes verwenden:
61 this_player()->More(read_file(filename))
62
63BEISPIELE
64---------
65::
66
67 // Ausgabe eines normalen textes...
68 this_player()->More("Einfach nur mal so ein Test...\n");
69
70 // Ausgabe eines kompletten files
71 this_player()->More("/etc/WIZRULES", 1);
72
73SIEHE AUCH
74----------
75::
76
77----------------------------------------------------------------------------
78Last modified: Mon Feb 22 15:09:18 1999 by Padreic
79