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

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->string_value is NULL.


Parameters Notes


string_ptr

 pointer to the SE_String being checked

result_out_ptr

 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 16, 2004 Copyright © 2004 SEDRIS