The Standard ScriptEase Library is based on the standard C libraries, as defined by ANSI and ISO. All of these routines are available to any ScriptEase program executed by ScriptEase.
Minimal modifications have been made to the standard C library to support the differences between the ScriptEase and the C languages. In most cases, these modifications involve the redefinition of a variable pointer to become a variable-passed-by-reference. Usually, the ScriptEase call to one of these functions looks identical to the C call. The experienced C programmer must only give thought to the changes when an ampersand (&) operator or a sizeof() statement would otherwise be in order.
A few functions are missing, mostly those dealing with locales (locales will be added if there is demand for them). A few functions have been added beyond those in the ANSI and ISO standards. The functions that seem to be common across most existing implementations of C libraries were implemented.
Note: Any functions beginning with "str" automatically tags character-arrays as "strings", which means that further use of those variables will always ensure that they are null-terminated.
The following defines are include as part of the standard ScriptEase library
(e.g. 18.2, 100) Number of system clock ticks |
|
0 (Indicates FALSE) |
|
1 (Indicates TRUE) |
|
0 Used to initialize arrays to being empty |
|
(e.g. 1, 255) Program return code to indicate failure |
|
(e.g. 0) Program return code to indicate success |
|
Maximum value returned by the rand function |
|
Status returned when end of file is reached |
|
FILE for standard error device; can be changed with freopen() |
|
FILE for standard input device; can be changed with freopen() |
|
FILE for standard output device; can be changed with freopen() |
|
errno is a variable used to store diagnostic messages in the case of an error in executing a fuction. Many library functions will set errno to non-zero in case of error to provide more specific information about the error. ScriptEase implements errno as a macro to the internal function_errno(). This variable can be accessed with perror() or strerror(). |
acos |
|
---|---|
DESCRIPTION |
Calculate the arc cosine. |
SYNTAX |
float acos(float x) |
RETURN |
Return arc cosine of x in the range [0,pi] radians. |
asin |
|
---|---|
DESCRIPTION |
Calculate the arc sine. |
SYNTAX |
float asin(float x) |
RETURN |
Return arc sine of x in the range [-pi/2,pi/2] radians. |
atan |
|
---|---|
DESCRIPTION |
Calculate the arc tangent. |
SYNTAX |
float atan(float x) |
RETURN |
Return arc tangent of x in the range [-pi/2,pi/2] radians. |
atan2 |
|
---|---|
DESCRIPTION |
Calculate the arc tangent of a fraction. |
SYNTAX |
float atan2(float y, float x) |
RETURN |
Return the arc tangent of y/x, in the range [-pi, +pi] radians. |
atexit |
|
---|---|
DESCRIPTION |
Register function to be called at program exit. |
SYNTAX |
void atexit(string FunctionName) |
COMMENTS |
Function name is string for function to call. |
SEE ALSO |
abort(), assert(), exit() |
ceil |
|
---|---|
DESCRIPTION |
Ceiling; round up. |
SYNTAX |
float ceil(float x) |
RETURN |
Return the smallest integral value not less than x. |
SEE ALSO |
floor() |
cos |
|
---|---|
DESCRIPTION |
Calculate the cosine. |
SYNTAX |
float cos(float x) |
RETURN |
Return the cosine of x in radians. |
cosh |
|
---|---|
DESCRIPTION |
Calculate the hyperbolic cosine. |
SYNTAX |
float cosh(float x) |
RETURN |
Return the hyperbolic cosine of x. |
exp |
|
---|---|
DESCRIPTION |
Compute the exponential function. |
SYNTAX |
float exp(float x) |
RETURN |
Return the exponential value of x. |
SEE ALSO |
frexp(), ldexp(), pow() |
fabs |
|
---|---|
DESCRIPTION |
Absolute value. |
SYNTAX |
float fabs(float x) |
RETURN |
Return the absolute (i.e., non-negative) value of x. |
SEE ALSO |
abs() |
floor |
|
---|---|
DESCRIPTION |
Round down. |
SYNTAX |
float floor(float x) |
RETURN |
Return the largest integral value not greater than x. |
SEE ALSO |
ceil() |
fmod |
|
---|---|
DESCRIPTION |
Modulus; calculate remainder. |
SYNTAX |
float fmod(float x, float y) |
RETURN |
Return the remainder of x / y. |
SEE ALSO |
div(), ldiv(), modf() |
isalnum |
|
---|---|
DESCRIPTION |
Test for alphanumeric character. |
SYNTAX |
bool isalnum(int c) |
RETURN |
Return TRUE if c is a letter (A to Z or a to z) or a digit (0 to 9), else return FALSE. |
isalpha |
|
---|---|
DESCRIPTION |
Test for alphabetic character. |
SYNTAX |
bool isalpha(int c) |
RETURN |
Return TRUE if c is a letter (A to Z or a to z), else return FALSE. |
isascii |
|
---|---|
DESCRIPTION |
Test for ASCII coded character. |
SYNTAX |
bool isascii(int c) |
RETURN |
Return TRUE if c is in the range 0 to 127, inclusive, else return FALSE. |
iscntrl |
|
---|---|
DESCRIPTION |
Test for any control character. |
SYNTAX |
bool iscntrl(int c) |
RETURN |
Return TRUE if c is a control character or delete character, else return FALSE. |
isdigit |
|
---|---|
DESCRIPTION |
Test for any decimal-digit character. |
SYNTAX |
bool isdigit(int c) |
RETURN |
Return TRUE if c is a digit (0 to 9), else return FALSE. |
isgraph |
|
---|---|
DESCRIPTION |
Test for any printing character except for space. |
SYNTAX |
bool isgraph(int c) |
RETURN |
Return TRUE if c is a printable character that is not a space, else return FALSE. |
islower |
|
---|---|
DESCRIPTION |
Test for lower-case alphabetic letter. |
SYNTAX |
bool islower(int c) |
RETURN |
Return TRUE if c is a lowercase letter (a to z), else return FALSE. |
isprint |
|
---|---|
DESCRIPTION |
Test for any printing character including space. |
SYNTAX |
bool isprint(int c) |
RETURN |
Return TRUE if c occupies one space when printed, else return FALSE. |
ispunct |
|
---|---|
DESCRIPTION |
Test for punctuation character. |
SYNTAX |
bool ispunct(int c) |
RETURN |
Return TRUE if c is a punctuation character, else return FALSE. |
isupper |
|
---|---|
DESCRIPTION |
Test for upper-case alphabetic character. |
SYNTAX |
bool isupper(int c) |
RETURN |
Return TRUE if c is an uppercase letter (A to Z), else return FALSE. |
isxdigit |
|
---|---|
DESCRIPTION |
Test for hexadecimal-digit character. |
SYNTAX |
bool isxdigit(int c) |
RETURN |
Return TRUE if c is a hexadecimal digit (0 to 9, A to F, or a to f), else return FALSE. |
log |
|
---|---|
DESCRIPTION |
Calculate the natural logarithm. |
SYNTAX |
float log(float x) |
RETURN |
Return the natural logarithm of x. |
SEE ALSO |
exp(), log10(), pow() |
log10 |
|
---|---|
DESCRIPTION |
Calculate the base-ten logarithm. |
SYNTAX |
float log10(float x) |
RETURN |
Return the base-ten logarithm of x. |
SEE ALSO |
exp(), log, pow() |
pow |
|
DESCRIPTION |
Calculates x to the power of y. |
SYNTAX |
float pow(float x, float y) |
RETURN |
Return the x to the power of y. |
SEE ALSO |
exp(), frexp(), log(), sqrt() |
remove |
|
---|---|
DESCRIPTION |
Delete a file. |
SYNTAX |
int remove(string filename) |
COMMENTS |
Deletes the filename specified by filename. |
RETURN |
Returns zero for success, and non-zero for failure. |
rename |
|
---|---|
DESCRIPTION |
Rename a file. |
SYNTAX |
int rename(string OldFilename, string NewFilename) |
RETURN |
Returns zero for success, and non-zero for failure. |
sin |
|
---|---|
DESCRIPTION |
Calculate the sine. |
SYNTAX |
float sin(float x) |
RETURN |
Return the sine of x in radians. |
sinh |
|
---|---|
DESCRIPTION |
Calculate the hyperbolic sine. |
SYNTAX |
float sinh(float x) |
RETURN |
Return the hyperbolic sine of x |
sqrt |
|
---|---|
DESCRIPTION |
Calculate the square root. |
SYNTAX |
float sqrt(float x) |
RETURN |
Return the square root of x. |
tan |
|
---|---|
DESCRIPTION |
Calculate the tangent. |
SYNTAX |
float tan(float x) |
RETURN |
Return the tangent of x in radians. |
tanh |
|
---|---|
DESCRIPTION |
Calculate the hyperbolic tangent. |
SYNTAX |
float tanh(float x) |
RETURN |
Return the hyperbolic tangent of x. |
toascii |
|
---|---|
DESCRIPTION |
Translate character to ASCII (7-bit) format |
SYNTAX |
int toascii(int c) |
COMMENTS |
Converts c to ASCII by clearing all but the lower 7 bits. |
RETURN |
Return lower 7 bits of c. |