besALLOC_RETURN_STRING(X)

[<<<] [>>>]

Use this macro to allocate a string as a return value. If there is not enough space to store the result the macro returns from the function with the error code COMMAND_ERROR_MEMORY_LOW.

The argument should be the number of bytes of the return value. After using this macro the macro STRINGVALUE(besRETURNVALUE) can be used to access the byte-buffer of the return value. Usually the program uses memcpy to copy the bytes there.


[<<<] [>>>]