list_eos

Checks list load status; closes cursor/file.

Available in:

Apps (win) Apps (char) Reportwriter RPC Standalone PL
X X X X X

Syntax

int list_eos(list-name[,close])
list         list-name
int          close

Description

If the list_open(), list_more(), or query() call that loaded the list returns no more rows than the maximum specified in the call, then this funtion returns true (1), otherwise it returns false (0).
close (optional) can have one of two values. If it is true (nonzero), the underlying cursor or file is closed and the list remains open. Else the list is closed along with the cursor.

Example

Prints the list load status.
{
 list xx, yy;
 xx = list_open("20 16 10", 1000, "RT2");
 list_mod(xx,1,1,2,3);
 list_mod(xx,1,4,5,6);
 list_mod(xx,1,7,8,9);
 yy = list_open("SELECT * FROM staff", 1000);

 printf(list_eos(xx));
 printf(list_eos(yy));
 list_close(xx);
 list_close(yy);
}