Platform

Miscellaneous

• chroot(dir:string) -> void [XL]
• color() -> integer [XL]
• color(c:integer) -> integer [XL]
• color_princ(s:string) -> void [XL]
• ding() -> void [XL]
• exit(self:integer) -> void
• gc() -> void
• getlocale(cat:integer) -> string [XL]
• pwd() -> string [XL]
• release() -> string
• setcwd(s:string) -> void [XL]
• setlocale(cat:integer, s:string) -> string [XL]
• shell(self:string) -> integer
• sleep(t:integer) -> void [XL]
• unix?() -> boolean [XL]

chroot(dir:string) -> void

chroot(dirname) causes dirname to become the root directory, that is, the starting point for path searches of pathnames beginning with '/'.

This call is restricted to the super-user.

color() -> integer

color() returns the current color mode that can be on of :

• 0 : uncolored
• 1 : terminal colors
• 2 : HTML colors

color(c:integer) -> integer

color(c) sets the color mode to c and returns the previous color mode

color_princ(s:string) -> void

color_princ(s) prints the string s on the current output (cout()). The string s may contain color sequences that will be printed as color modifiers according to the current color mode.

ding() -> void

ding() prints on stdout the "bell" char (ASCII 0x7).

exit(self:integer) -> void

exit(n) stops CLAIRE and returns to the hosting system the value n. What can happen next is platform-dependent.

gc() -> void

gc() forces a garbage collection to take place.

getlocale(cat:integer) -> string

getlocale(s) returns the current locale for the given category cat (see setlocale).

pwd() -> string

pwd() is used to obtain the path of the current working directory. this directory may be changed with setcwd.

release() -> string

returns a release number of your CLAIRE system (<release>.<version>.<revision>).

setcwd(s:string) -> void

setcwd(s) set the current working directory to the path s. this path can then be obtained with pwd.

setlocale(cat:integer, s:string) -> string

setlocale(cat, s) is a wrapper for the C lib setlocale. It sets the notion of natural language formatting style for particular sets of routines. The cat argument defines the category of the routine setlocale applies (see man). cat is one of the following :

• CTYPE = 0
• LC_NUMERIC = 1
• LC_TIME = 2
• LC_COLLATE = 3
• LC_MONETARY = 4
• LC_MESSAGES = 5
• LC_ALL = 6
• LC_PAPER = 7
• LC_NAME = 8
• LC_ADDRESS = 9
• LC_TELEPHONE = 10
• LC_MEASUREMENT = 11
• LC_IDENTIFICATION = 12

shell(self:string) -> integer

Passes the command s to the operating system (the shell) and returns the exit status of the command execution.

sleep(t:integer) -> void

sleep(t) suspends the execution of the process for t ms.

Core/unix?() -> boolean

unix?() tell if the underlying system is a UNIX (vs. windows).