67fdb4e8a262d6b9b0a488a471491864e2fa8b65
[inform-resources.git] / inflibqr / inflibqr.md
1 % InfoLib At Your Fingertips
2 % Roger Firth <roger@firthworks.com>
3
4 A quick reference to the Inform Library.
5
6 Copyright © 2002 Roger Firth <roger@firthworks.com>. Copying and
7 distribution, with or without modification, are permitted in any
8 medium without royalty provided the copyright notice and this notice
9 are preserved.
10
11 <http://www.firthworks.com/roger/>
12
13 Version 1.5 (March 2002)
14
15 The road to brevity is via solecism and imprecision.
16
17 Library objects
18 ---------------
19
20 `compass` - A `container` object holding the twelve direction objects
21 `d_obj` `e_obj` `in_obj` `n_obj` `ne_obj` `nw_obj` `out_obj` `s_obj`
22 `se_obj` `sw_obj` `u_obj` `w_obj`.
23
24 `LibraryMessages` - If defined (between Includes of `Parser` and
25 `VerbLib`), changes standard library messages:
26
27     Object  LibraryMessages
28       with  before [;
29                 action : "string";
30                 action : "string";
31                 action : switch (lm_n) {
32                     value : "string";
33                     value : "string ",(a) lm_o,".";
34                     ...
35                     }
36                 ...
37                 ];
38
39 `selfobj` - The default player object. Avoid: use instead the `player`
40 variable, which usually refers to `selfobj`.
41
42 `thedark` - A pseudo-room which becomes the `location` when there is
43 no light (although the player object is not moved there).
44
45 Library constants
46 -----------------
47
48 In addition to the standard constants `true` (1), `false` (0) and
49 `nothing` (0), the Library defines `NULL` (-1) for an action, property
50 or pronoun whose current value is undefined.