ERROR_DIALOG - Show the user an error dialog via the UI

When to use it

Use ERROR_DIALOG to explain a failure in the payload. The most common use would be to notify the user that an operation is not currently possible.

Syntax 

  ERROR_DIALOG [error text]

error text

Error text to show. Text should be kept short enough to fit on the device display.

An example error dialog

An example error dialog

Results

ERROR_DIALOG returns immediately after showing an error dialog; it should usually be the last thing called in a payload.

Examples 

  ERROR_DIALOG "Something went wrong!" ; exit 0
  
  CONFIRMATION_DIALOG "Continue?" || {
    ERROR_DIALOG "You said no..."
    exit 0
}