The routines in this section are specific to the UNIX version of ScriptEase. They are included internally to the ScriptEase program, and are available to any ScriptEase program executed by ScriptEase under UNIX.
Most of these routines allow the programmer to have more power than is generally acknowledged as safe under ScriptEase' guidelines. So be careful when you use these commands, they provide plenty of rope with which to hang yourself.
dlcall |
|
---|---|
DESCRIPTION |
Call a routine in a shared object under Linux, Sun OS, Solaris, FreeBSD, or AIX (all Unix versions currently supported). |
SYNTAX |
int dlcall(string shared_object, string routine,...) |
COMMENTS |
dlcall() allows you to call routines in shared objects directly. The first parameter is the name of the shared object; the second is the name of the routine being called. If a parameter is undefined when dlcall() is called, then it is assumed that parameter will be a 32-bit value that will be filled in (i.e., the address of a 32-bit data element is passed to the function, and that function will set the value). If any parameter is a structure then it must be a structure that defines the binary data types in memory to represent the following variable. Before calling the DLL function, the structure will be copied to a binary buffer as described in BLObPut() and fwrite(). After calling the DLL function the binary data will be converted back into the data structure according to the rules defined in BLObGet() and fread(). Data conversion will be performed according to the current _BigEndianMode setting (see fread()). |
RETURN |
This function returns the result of the called function converted to integer form. If the given function does not exists, a run-time error is generated. |
DESCRIPTION |
Get the current working directory. |
SYNTAX |
string getcwd(string buffer); |
COMMENT |
The full pathname of the current directory is copied to the given buffer. |
RETURN |
The function returns the value of its argument. |