tibemsStreamMsg_Read

Function

Purpose

Read primitive datatypes from a stream message.

C Declaration

tibems_status tibemsStreamMsg_ReadBoolean(
    tibemsStreamMsg message,
    tibems_bool* value );

tibems_status tibemsStreamMsg_ReadByte(
    tibemsStreamMsg message,
    tibems_byte* value );

tibems_status tibemsStreamMsg_ReadChar(
    tibemsStreamMsg message,
    tibems_wchar* value );

tibems_status tibemsStreamMsg_ReadDouble(
    tibemsStreamMsg message,
    tibems_double* value );

tibems_status tibemsStreamMsg_ReadFloat(
    tibemsStreamMsg message,
    tibems_float* value );

tibems_status tibemsStreamMsg_ReadInt(
    tibemsStreamMsg message,
    tibems_int* value );

tibems_status tibemsStreamMsg_ReadLong(
    tibemsStreamMsg message,
    tibems_long* value );

tibems_status tibemsStreamMsg_ReadShort(
    tibemsStreamMsg message,
    tibems_short* value );

tibems_status tibemsStreamMsg_ReadString(
    tibemsStreamMsg message,
    char** value );

COBOL Call

CALL "tibemsStreamMsg_ReadBoolean"
     USING BY VALUE message,
           BY REFERENCE value,
           RETURNING tibems-status
END-CALL.

CALL "tibemsStreamMsg_ReadByte"
     USING BY VALUE message,
           BY REFERENCE value,
           RETURNING tibems-status
END-CALL.

CALL "tibemsStreamMsg_ReadChar"
     USING BY VALUE message,
           BY REFERENCE value,
           RETURNING tibems-status
END-CALL.

CALL "tibemsStreamMsg_ReadDouble"
     USING BY VALUE message,
           BY REFERENCE value,
           RETURNING tibems-status
END-CALL.

CALL "tibemsStreamMsg_ReadFloat"
     USING BY VALUE message,
           BY REFERENCE value,
           RETURNING tibems-status
END-CALL.

CALL "tibemsStreamMsg_ReadInt"
     USING BY VALUE message,
           BY REFERENCE value,
           RETURNING tibems-status
END-CALL.

CALL "tibemsStreamMsg_ReadLong"
     USING BY VALUE message,
           BY REFERENCE value,
           RETURNING tibems-status
END-CALL.
CALL "tibemsStreamMsg_ReadShort"
     USING BY VALUE message,
           BY REFERENCE value,
           RETURNING tibems-status
END-CALL.

CALL "tibemsStreamMsg_ReadString"
     USING BY VALUE message,
           BY REFERENCE value,
           RETURNING tibems-status
END-CALL.

Note: message has usage pointer.

value has usage pointer only in tibemsStreamMsg_ReadString (but not in the other calls documented in this group).

Parameters

Parameter	Description
`message`	Read a field struct from this message.
`value`	Store a pointer to the field struct.

Remarks