Function sapnwrfc::binding::RfcGetChars [−] [src]

pub unsafe extern "C" fn RfcGetChars(
    dataHandle: DATA_CONTAINER_HANDLE, 
    name: *const SAP_UC, 
    charBuffer: *mut RFC_CHAR, 
    bufferLength: c_uint, 
    errorInfo: *mut RFC_ERROR_INFO
) -> RFC_RC
[−]

Returns the value of the specified field as char array.

The charBuffer will be filled with a string representation of the given field. The remaining places in the buffer will be filled with trailing spaces. In case the buffer is too small, the function will return RFC_BUFFER_TOO_SMALL. The result will not be null-terminated.

The field specified by name needs to be of one of the following data types. If the field has one of the listed non-char-like data types, the RFC library will convert the field value to string format. Example:\n If "name" specifies a field of type INT4 with the value 4711 and charBuffer is an SAP_CHAR[10], then the buffer will be filled as follows: "4711 ".

Note: If the target field has type BYTE or XSTRING, the bytes will be converted to a hex encoded string representation.

\in dataHandle A data container (function handle, structure handle or table handle). If dataHandle is a table handle, the function will read the field value of the current row. \in *name The name of the field. \out *charBuffer A pre-allocated buffer, which will receive the (converted) field value. \in bufferLength Size of the buffer in RFC_CHARs. \out *errorInfo Field doesn't exist, cannot be converted to char, etc. \return RFC_RC