Editing mirc/identifiers/$?

{{mirc title|$? Identifier}}{{Deprecated feature|new=[[$input identifier - mIRC|$input() identifier]]}}

The ''$?'' identifier is used to request immediate user-input.

==Synopsis==
<source lang="mIRC">
$?="[Input Request Message]"
</source>
: ''Displays an input box to get user-input. The "Input Request Message" is optional; if not specified, it default to "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'', <span style="color: #B30000;">even if you don't click '''No'''</span> and exit out other ways.
* '''$?N'''
:: ''In the case of using tokens, via {{mIRC|/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===
<source lang="mIRC">
alias testme {
  echo -a $?="Type something for me"
}
</source>
: ''Echoes whatever the user types into the input field to the active window.''

<source lang="mIRC">
alias testme {
  echo -a $?*="Enter Password:"
}
</source>
: ''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.''

<source lang="mIRC">
alias testme {
  echo -a $?!="Do you like chocolate?"
}
</source>
: ''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'''.''
<source lang="mIRC">
alias testme {
  tokenize 32 A B
  echo -a $?3
}
</source>
: ''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.

<source lang="mIRC">
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! }
}
</source>
# This will create two variables, '''%start''' & '''%end''', which take in user input.
# The script verifies that the numbers are actual numbers, and that the start value is less than the end value.
# The script then begins a [[while command - mIRC|while loop]] that only repeats if %start is less than or equal to %end.
# The loop echoes the contents of '''%start''' to the active screen, and then increments (increases) the value of %start by 1.
# If the '''if''' comparison is not fully true, the loop is avoided altogether and an error is echoed to the active window instead.
{{mIRC identifier list}}

[[Category:MIRC identifiers]]
@@ Line 1: / Line 1: @@
-{{mirc title|$? Identifier}}{{Deprecated feature|new={{mIRC|$input}}}}
+{{mirc title|$? Identifier}}{{Deprecated feature|new=[[$input identifier - mIRC|$input() identifier]]}}
 The ''$?'' identifier is used to request immediate user-input.
 ==Synopsis==
@@ Line 10: / Line 9: @@
 : ''Displays an input box to get user-input. The "Input Request Message" is optional; if not specified, it default to "Enter reply:"''
-== Usage ==
+==Properties==
-There are four ways you can use this identifier:
+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: the input is treated as a password field. The input is shown as •••''
+:: ''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'', <span style="color: #B30000;">even if you don't click '''No'''</span> and exit out other ways.
-* '''$?N="Give me input!'''
+* '''$?N'''
-:: ''Where N is a positive number > 1 representing the $N identifier, If the value of $N is $null, you are asked to provide it, otherwise $N is returned.
+:: ''In the case of using tokens, via {{mIRC|/tokenize}}, this will allow the script to request a specific token value from the user, via the Nth value.''
-* '''$?#="Give me input!'''
-:: ''where # represent $chan, If the value of $chan is $null, you are asked to provide it, otherwise $chan is returned
-You can use {{mIRC|$crlf}} to get multiple lines.
-'''Note''': This fills the {{mIRC|$!}} identifier with the value entered in the editbox if you press ok or yes buttons
-== Notes & quirks ==
-The $? identifier has some parsing issues, it has been replaced by {{mIRC|$input}} to overcome these issues:
-* $? can be used without the '=' sign as long as you either don't pass as an input request message (just $?), or that this paramater contain a balanced number of quotes:.
-** $? $?"test" $?"test words" etc are all valid usages.
-** In fact, mIRC start looking for a valid parameter when you start the first quote, $?ignored"this is the message" will actually ignore the part before the first quote
-* //echo -a $?"message with multiple words" $?!"test"
-This line cause parsing issue, here $?!"test" is evaluated before, mIRC seems to get lost as to which quote is closing which quote, and end up evaluating more than it should
 ==Examples==
@@ Line 73: / Line 52: @@
 }
 </source>
-: ''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. If we use $?2 instead, B will be used without asking anything.''
+: ''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.
+<source lang="mIRC">
+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! }
+}
+</source>
+# This will create two variables, '''%start''' & '''%end''', which take in user input.
+# The script verifies that the numbers are actual numbers, and that the start value is less than the end value.
+# The script then begins a [[while command - mIRC|while loop]] that only repeats if %start is less than or equal to %end.
+# The loop echoes the contents of '''%start''' to the active screen, and then increments (increases) the value of %start by 1.
+# If the '''if''' comparison is not fully true, the loop is avoided altogether and an error is echoed to the active window instead.
 {{mIRC identifier list}}
-[[Category:mIRC identifiers|$?]]
+[[Category:MIRC identifiers]]