df_nbrkeys: Setting up the number of keys

Use this function to set up the number of keys that you want to use in a particular key list structure.

Last updated

Changed for PUT00.

Format

void df_nbrkeys (dft_kyl *key_list, short int n);
key_list
is a pointer to the key list structure you are setting up.
n
is the number of keys (1–180) that you want in the key list.

Entry requirements

None.

Return conditions

None.

Error return

For information about how to check the error indicators, see Identifying return indicators and errors.

Programming considerations

  • The type definitions (for example, dft_fil, dft_ref, and dft_kyl) are defined in the c_cdfapi.h header file.
  • You can define any number of key list structures in your program. Each key list can have from 1–180 keys. See Specifying logical records (LRECs) using keys for more information about key lists.

Examples

See Setting up a key list with less than six keys and Setting up a key list in the range 1-180 for examples of how to set up a key list.

Related information

See df_setkey: Setting up a key in a key list for more information.