string-to-char*

$Revision: 5.0.2.6 $

Function

Package: FOREIGN-FUNCTIONS

Arguments: (string &optional address)

This function is obsolete. It has been replaced by excl:string-to-native. A call to char*-to-string has been changed to return the first value of the following:

(excl:string-to-native string :address address :external-format :default)

Users are encouraged to use excl:string-to-native instead of ff:string-to-char* for new code. See also excl:native-to-string and excl:with-native-string.

The remainder of this description is the old documentation for string-to-char*.

This function returns an integer pointer to a C string. string should be a Lisp string. If the optional address argument is used, then ff:string-to-char* copies string to address.

This function uses malloc to allocate the space needed for the string. This space will not be freed automatically by Lisp. Users must free the space themselves, by calling excl:aclfree with the address returned by string-to-char* as the single argument.

See ftype.htm for information on foreign types in Allegro CL. See foreign_functions.htm for general information on foreign functions in Allegro CL.

The general documentation description is in introduction.htm. The index in index.htm.