Copyright Digital Equipment Corp. All rights reserved.

MALLOC_C_STR

 The MALLOC_C_STR function  takes  a  Pascal  string  expression,
 calls the C routine malloc() to allocate memory, initializes the
 memory with the  string  expression,  and  then  terminates  the
 string with a null-charcter.


 Syntax:

    MALLOC_C_STR(e)


 The type of the expression e must be a Pascal string expression.
 The  function  result is a C_STR_T pointer to the null-terminted
 string.  The amount of memory allocated with malloc()  is  equal
 to  the  length  of  the string expression plus one.  The memory
 allocated with MALLOC_C_STR  must  be  deallocated  with  the  C
 free()  routine.  The compiler will not allow C_STR_T parameters
 with the NEW and DISPOSE routines.