NUMBER_PICKER

NUMBER_PICKER - Ask the user to interactively enter a number via the UI

When to use it

NUMBER_PICKER presents an optimized numerical keyboard whenever a payload needs a number, such as a port or a flexible timeout value.

  NUMBER_PICKER [text prompt] [default number]

text prompt

Text prompt to show the user. Prompts should be kept short enough to fit on the device display.

default number

Default number for the picker.

warning

A default number should typically be provided. To prompt the user with no default, use a blank quoted string: "".

NUMBER_PICKER will wait until the user has made a selection, pausing the payload.

NUMBER_PICKER exits with a return code of 0 if the user continues, and non-zero if the user cancels.

NUMBER_PICKER returns the number as the output.

  __usernum=$(NUMBER_PICKER "Timeout (in seconds)" "5") || exit 0

  __usernum=$(NUMBER_PICKER "No default number" "") || exit 0

info

Remember to enclose the prompt text in quotes!

MAC_PICKER

PROMPT