Copyright Digital Equipment Corp. All rights reserved.

PAS_STRCPY

 The PAS_STRCPY function copies a Pascal string  expression  into
 memory pointed to by C_STR_T.


 Syntax:

    PAS_STRCPY(v, e)


 The type of the variable v must be C_STR_T.   The  type  of  the
 expression  e  must  be  a Pascal string expression.  The Pascal
 string is copied into the memory pointed to by the  variable  v.
 The  memory  is  then  terminated  with  a  null character.  The
 function returns a C_STR_T value  representing  the  destination
 (such as, the same value as contained by the variable v).

 The behavior of PAS_STRCPY is undefined if  the  length  of  the
 Pascal  string expression is greater than or equal to the amount
 of memory pointed to by the variable v.  It is an error  if  the
 variable v is NIL.