SE AllocCharacterArray

The SEDRIS Data Representation Model APPENDIX D - Functions SE AllocCharacterArray

extern SE_Character *
SE_AllocCharacterArray
(
SE_Integer_Unsigned	size	¹
);

Definition

Allocates memory for a "string" (intended for use with an EDCS_String's or SE_String's characters field, particularly in conjunction with <Data Table> allocation.) Memory allocated by this function should be freed via SE_FreeCharacterArray().

Does NOT return a pointer to an EDCS_String or SE_String.

Returns

NULL if allocation operation failed, with warning to stderr otherwise, pointer to char allocated here

Parameters Notes

¹ number of bytes to allocate. Note that this should NOT be the string length of an EDCS_String or SE_String, but instead should be passed the string length plus 1 in order to have room for the terminating byte (i.e., follow standard C string conventions)