4 * [Generated from res, 25 September 1996]
7 #if !defined(__CC_NORCROFT) || !defined(__arm)
8 #error You must use the Norcroft ARM Compiler for Sapphire programs
11 #pragma include_only_once
12 #pragma force_top_level
21 /*----- Overview ----------------------------------------------------------*
31 /* --- res_exists --- *
33 * On entry: R0 == pointer to pathname
35 * On exit: CS if the file exists, CC otherwise
37 * Use: Tries to find the named file. The file is deemed to exist
38 * if OS_File can return a valid object type for it (i.e. not
39 * `non-existant object' or actually raising errors).
42 extern routine res_exists;
44 /* --- res_country --- *
46 * On entry: R0 == pointer to a buffer to use
48 * On exit: R0 == pointer to country name (may not be in the buffer)
50 * Use: Reads the name of the current country. If no name can be
51 * found, it returns a pointer to the string `UK' which should
52 * do as a suitable default
55 extern routine res_country;
59 * On entry: R0 == pointer to resource filename
60 * R1 == pointer to buffer to build filename in
62 * On exit: R0 == pointer to start of full pathname (R1 on entry)
63 * R1 == pointer to terminating null character
64 * CS if the file could actually be found, CC otherwise
66 * Use: Locates a resource file. It searches, in order:
68 * * resPrefix.Resources.leaf[suffix]
69 * * resPrefix.Resources.country.leaf[suffix]
70 * * resPrefix.leaf[suffix]
72 * returning the last if none of them could be found. Note
73 * that `country' here is the currently configured country
74 * setting, and `suffix' is the WIMP mode aspect ratio suffix
75 * for the current mode (RISC OS 3 only).
78 extern routine res_find;
82 * On entry: R0 == pointer to application name
86 * Use: Initialises the resource prefix to <appname$Dir>
89 extern routine res_init;
91 /*----- That's all, folks -------------------------------------------------*/