Revision as of 01:24, 13 August 2014

Note: This feature has essentially been replaced by $input() identifier.

The $? identifier is used to request immediate user-input. The values that you gather from this input can be used in a plethora of different ways, from designing games to requesting a user to kick on a channel.

Synopsis

$?="[Input Request Message]"

Displays an input box to get user-input. The "Input Request Message" is optional; if not specified, it is replaced by "Enter reply:"

Properties

There are three ways you can modify the intent of the requested data:

• $?="Give Me Input"

Displays an input request with the words 'Give Me Input' above the input box.

• $?*="Give Me Password"

Displays a password input request, in that the information the user inputs will be treated as a password field, therefore the characters will be replaced with password characters. The information is still displayed normally once the input is received.

• $?!="Give Me Input"

Displays an input request with a Yes & No button, with the words 'Give Me Input' above them.

- If you click Yes, the input returns $true, otherwise it returns $false, even if you don't click No and exit out other ways.

• $?N

In the case of using tokens, via /tokenize, this will allow the script to request a specific token value from the user, via the Nth value.

Examples

Below are three examples that display exactly how to use each individual property:

Basic

alias testme {
  echo -a $?="Type something for me"
}

Echoes whatever the user types into the input field to the active window.

alias testme {
  echo -a $?*="Enter Password:"
}

Does the same as the first example, except while the user is typing, the characters are replaced by password characters. The typed value, however, is visibly legible when it is echoed to the active window.

alias testme {
  echo -a $?!="Do you like chocolate?"
}

Pops up an input request asking if the user likes chocolate. If they click Yes, it echoes $true to the active window; otherwise, it echoes $false.

alias testme {
  tokenize 32 A B
  echo -a $?3
}

We tokenize the A B using token 32, which is the character for spaces. The script then asks the user for a 3rd token value, via $?3. Once the user enters that value, it is then echoed to the active window.

Advanced

This area contains one advanced example that is still pretty basic, but details how this sort of input can be extracted for a more demanding outcome.

alias testme {
  var %start = $?="Please input a number to start the count from:", %end = $?="Please input a number to stop the count at:"
  if ((%start isnum) && (%end isnum) && (%start < %end)) {
    while (%start <= %end) {
      echo -a %start
      inc %start
    }
  }
  else { echo -a Error: Invalid data or start value larger than end value! }
}

1. This will create two variables, %start & %end, which take in user input.
2. The script verifies that the numbers are actual numbers, and that the start value is less than the end value.
3. The script then begins a while loop that only repeats if %start is less than or equal to %end.
4. The loop echoes the contents of %start to the active screen, and then increments (increases) the value of %start by 1.
5. If the if comparison is not fully true, the loop is avoided altogether and an error is echoed to the active window instead.