cl_itemq()

Returns the number of items in a choice list

Call  
#include <vv_clist.h>
int cl_itemq(clistp)

CLISTPTR clistp

Choice list to search

Returns  
>=0 The number of items in the choice list
1 An error occurred when attempting to set the keyword. VV_ERR is set to one of the following:
  KWDNOTFOUND

ERRREAD

FILETOOBIG

The keyword marking the choice list was not found in the memory file.

An error occurred while trying to read the memory file.

The keyworded section used by the choice list is too large to fit in the memory file.

Description

cl_itemq() first calls mf_kwdset() to set the memory file to operate within the section marked by the choice list's keyword. The structure is then referenced to see how many rows are in that keyworded section.

If a keyword was set prior to calling this function, the memory file is restored so that it operates on the keyworded section that was active when cl_itemq() was called.

Related Functions

cli_ins(), cli_rpl(), cli_numtxt(), cl_curnum(), cli_del()


Home Contents Previous Next