Pauses for user input of a keyword, and returns that keyword
(getkword [msg])
Valid keywords are set prior to the getkword call with the initget function. The user cannot enter another AutoLISP expression as the response to a getkword request.
Arguments
A string to be displayed to prompt the user; if omitted, getkword does not display a prompting message.
Return Values
A string representing the keyword entered by the user; otherwise nil, if the user presses ENTER without typing a keyword. The function also returns nil if it was not preceded by a call to initget to establish one or more keywords.
If the user enters a value that is not a valid keyword, getkword displays a warning message and prompts the user to try again.
Examples
The following example shows an initial call to initget that sets up a list of keywords (Yes and No) and disallows null input (bits value equal to 1) to the getkword call that follows:
Command: (initget 1 "Yes No")
nil
Command: (setq x (getkword "Are you sure? (Yes or No) "))
Are you sure? (Yes or No) yes
"Yes"
The following sequence illustrates what happens if the user enters invalid data in response to getkword:
Command: (initget 1 "Yes No")
nil
Command: (setq x (getkword "Are you sure? (Yes or No) "))
Are you sure? (Yes or No) Maybe
Invalid option keyword.
Are you sure? (Yes or No) yes
"Yes"
The user's response was not one of the keywords defined by the preceding initget, so getkword issued an error message and then prompted the user again with the string supplied in the msg argument.
The initget function. The getxxx Functions in the AutoLISP Developer's Guide.
