req4c_fetch_next_msg()

Purpose:

req4c_fetch_next_msg() returns the next info msg from the current message list.

Usage:

$msg = req4c_fetch_next_msg();

Arguments: None

Returns:

false - No more info messages in current list

$msg - A string containing the info msg

Where Used:

req4c_fetch_next_msg() can be called anytime there are info messages on the current message list.

Example:

Description:

req4c functions that make requests to 4creqd may generate info messages. These messages are kept on an internal list until another req4c function call clears the list. These messages may be helpful in debugging. These messages include messages generated by a 4C program that calls sys.message() or sys.msg().

Bugs/Features/Comments:

req4c_fetch_next_msg() does not access the network

req4c_fetch_next_msg() does not clear the message list, but it does move the internal pointer for the current info msg.

See Also:

req4c_get_num_msgs()

req4c_fetch_all_msgs()

req4c_get_num_errors()

req4c_fecth_next_error()

req4c_fetch_all_errors()