NUMBER_PICKER Ask the user to interactively ender 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 timeout value. It is a quicker way to ask the user for nunbers - and only numbers - than the TEXT_PICKER interface.

Syntax

NUMBER_PICKER [text prompt] [default number]

text prompt required

Text prompt / dialog title shown to the user. Text prompts should be kept short enough to fit on the device display.

default number required

Default number pre-populated when the number picker launches. Must be an empty string ("") for a blank prompt.

The number picker dialog
The number picker dialog
The number picker editor
The number picker editor

Results

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 enters a value, and non-zero if the user cancels.

NUMBER_PICKER returns the number as the output

Examples

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