A pointer to the text string. When all the text has been found cli_getcheck() returns a null pointer.

cli_getcheck() loops through the memory file section looking at the check field of the mfline structure. If the lower nibble has a 1 then a checkmark character has been found. If the upper nibble is 1, the address of that line was given as the result of an earlier running of cli_getcheck(). When all the checkmark characters have been found, cli_getcheck() returns a null pointer. The upper nibble is set to zero for all entries in the key word section.

cli_check(), se_ckcheckch()

The memory file text may change due to autoloading of the keyworded sections. It is recommended that the text be copied to user buffers as soon as possible.

It is recommended that cli_getcheck() be called until a null pointer is returned.