sds_getkword

int sds_getkword (const char *prompt, char *answer);


Ask the user to specify a keyword.


The function pauses to get a keyword from the user. The prompt to the user shows the list of acceptable keywords. The user may type the whole word, or an abbreviation.

Keywords are defined using sds_initget prior to sds_getkword. Do not use command names as keywords.

The prompt argument is a command-line prompt requesting that the user enter a keyword. The prompt can include a list of keywords so the user is not required to know them from memory. This argument may be null.

The argument answer is the keyword entered by the user. It is a string of a maximum of 512 characters, the last of which is always Ø (ASCII 0). Even if the user enters an abbreviation, the entire keyword, with its original capitalization, is stored in the answer argument.

This function returns RTCAN (when the user presses Esc), RTERROR (when it fails), or RTNORM (when it succeeds). If the prior function was sds_initget, this function may return RTNONE.

NOTE sds_getkword itself does not ever return RTKWORD.

Example

char string1;

sds_initget(0,"Cat Dog Horse Bird");

sds_getkword("\nChoose a pet: Cat/Dog/Horse/Bird ",string1);

sds_printf("\nYou chose a %s. ",string1);

Tell me about...

Programming Overview of SDS™ (Solutions Development System™)