The SEDRIS Data Representation Model
APPENDIX D - Functions
SE IsStringEmpty
extern SE_DRM_Status_Code
SE_IsStringEmpty
(
constSE_String *string_ptr,1
SE_Boolean *result_out_ptr2
);

Definition

Checks whether the given SE_String is an "empty" string.

NOTE: Do NOT use a pointer comparison on the string value with se_empty_string; a string is empty if it is of length zero, not just if it equals se_empty_string.


Returns

SE_DRM_STAT_CODE_SUCCESS and *result_out_ptr is set to the appropriate value, if valid parameters were passed in.
SE_DRM_STAT_CODE_NULL_REQUIRED_PARAMETER and no changes are made, if string_ptr or result_out_ptr is NULL.
SE_DRM_STAT_CODE_FAILURE and *result_out_ptr is set to SE_FALSE, if string_ptr->characters is NULL.

Parameters Notes

1 pointer to the SE_String being checked

2 pointer to a variable in the user's memory space where the result will be stored


Prev: SE_IsInheritable. Next: SE_PrintAPI. Up:Index.

Last updated: July 26, 2006 Copyright © 2006 SEDRIS