Function:     GDS_NITEMS

Purpose:      Returns the number of descriptor items present in a set.

Category:     GDS

File:         gdsd_basic.c

Author:       J.P. Terlouw

Use:          INTEGER GDS_NITEMS( SET ,    Input    CHARACTER*(*)
                                  ERROR )  Output   INTEGER

              GDS_NITEMS    Returns the number of descriptor items.
              SET           Name or handle of set.
              ERROR         Error return code.
              
Description:  The obtained number of descriptor items can be used to determine
              the size of the hash table of a set to be created.
              The size of a set's hash table influences the efficiency with
              which descriptor items can be accessed. It should be of the
              same order of magnitude as the number of descriptor items
              (to be) stored.

See also:     gds_prime.dc2, gdst_prime.dc2.

Updates:      Apr 27, 1994: JPT, document created.