Functions
SAT_OBJECT	sat3_createchar_char (SAT_OBJECT where, char value)
	Create a char object from a char.
char	sat3_convertchar_char (SAT_OBJECT ochar)
	Convert a char into a calculator char object.

Detailed Description

This group includes all functions used to create/convert char objects.

Function Documentation

char sat3_convertchar_char ( SAT_OBJECT ochar )

Convert a char into a calculator char object.

Parameters:

ochar A SAT_OBJECT char.

Returns:: char with the given character. When conversion fails (invalid object) it returns 0.

SAT_OBJECT sat3_createchar_char	(	SAT_OBJECT	where,
		char	value
	)

Create a char object from a char.

Parameters:

where	Defines where to allocate memory from. Can be one of the following constants: ALLOC_HEAP Allocates from the C-heap using malloc() ALLOC_TEMPOB Allocates memory from the TEMPOB calculator area or... it can be an element (SAT_OBJECT) within a composite object, (array, list or any other).
value	Value to assign to the newly created char object.

Returns:: SAT_OBJECT with the new char, or zero if it fails. When a SAT_OBJECT is given to the 'where' parameter, the same SAT_OBJECT is returned or 0 if error.