Function Name: Is String Empty

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_SUCCESS - and *result_out_ptr is set to the appropriate value, if valid parameters were passed in.

SE_DRM_NULL_REQUIRED_PARAMETER - and no changes are made, if string_ptr or result_out_ptr is NULL.

SE_DRM_FAILURE - and *result_out_ptr is set to SE_FALSE, if string_ptr->string_value is NULL.

Prototype


extern SE_DRM_STATUS_CODE_ENUM
SE_IsStringEmpty
(
constSE_STRING *string_ptr, (notes)
SE_BOOLEAN *result_out_ptr (notes)
);

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: Is Inheritable. Next: Print Axis. Up:Index.