C.1  Constructing ECLⁱPS^e terms in C

All these functions return (volatile) pwords, which can be used as input to other constructor functions, or which can be stored in (non-volatile) ec_refs.

pword ec_string(const char*)

converts a C string to an ECLⁱPS^e string. The string is copied.

pword ec_length_string(int, const char*)

converts a C string of given length to an ECLⁱPS^e string. The string is copied and can contain NUL bytes.

pword ec_atom(const dident)

creates an ECLⁱPS^e atom. A dident (dictionary identifier) can be obtained either via ec_did() or ec_get_atom().

pword ec_long(const long)

converts a C long to an ECLⁱPS^e integer.

pword ec_long_long(const long long)

converts a C long long to an ECLⁱPS^e integer.

pword ec_double(const double)

converts a C double to an ECLⁱPS^e float.

pword ec_term(dident,pword,pword,...)

creates an ECLⁱPS^e term from the given components.

pword ec_term_array(const dident,const pword[ ])

creates an ECLⁱPS^e term from the arguments given in the array.

pword ec_list(const pword,const pword)

creates a single ECLⁱPS^e list cell with the given head (car) and tail (cdr).

pword ec_listofrefs(ec_refs)

creates an ECLⁱPS^e list containing the elements of the ec_refs array.

pword ec_listoflong(int, const long*)

creates an ECLⁱPS^e list of integers containing the longs in the given array. The data is copied.

pword ec_listofchar(int, const char*)

creates an ECLⁱPS^e list of integers containing the chars in the given array. The data is copied.

pword ec_listofdouble(int, const double*)

creates an ECLⁱPS^e list of doubles containing the doubles in the given array. The data is copied.

pword ec_arrayofdouble(int, const double*)

creates an ECLⁱPS^e array (a structure with functor [ ]of appropriate arity) of doubles from the given C array. The data is copied.

pword ec_matrixofdouble(int rows, int cols, const double*)

creates an ECLⁱPS^e array (size rows) of arrays (size cols) of doubles from the given C array. The data is copied.

pword ec_handle(const t_ext_type*,const t_ext_ptr)

creates an ECLⁱPS^e handle that refers to the given C data and its method table.

pword ec_newvar()

creates a fresh ECLⁱPS^e variable.

pword ec_nil()

creates an ECLⁱPS^e nil ie. the empty list [ ].

Auxiliary functions to access the ECLⁱPS^e dictionary.

dident ec_did(char*,int)

looks up or enters the given string with arity into the ECLⁱPS^e dictionary and returns a unique identifier for it.

char* DidName(dident)

returns the name string of the given dictionary identifier.

int DidArity(dident)

returns the arity of the given dictionary identifier.