Semiconductor & Computer Engineering
From WikiChip
Difference between revisions of "mirc/identifiers/$iif"
Maroonbells (talk | contribs) (Create content for identifier) |
Maroonbells (talk | contribs) |
||
| Line 5: | Line 5: | ||
== Parameters == | == Parameters == | ||
* '''C''' - A conditional statement that determines whether this identifier returns the $true or $false conditional. | * '''C''' - A conditional statement that determines whether this identifier returns the $true or $false conditional. | ||
| − | * '''T''' - The string returned and/or identifier executed if the C statement is $true | + | * '''T''' - The string returned and/or identifier evaluated/executed if the C statement is $true |
| − | * '''F''' - Optional string returned and/or identifier executed if the C statement is $false | + | * '''F''' - Optional string returned and/or identifier evaluated/executed if the C statement is $false |
Note: If F parameter is not used, $iif returns $null if the C statement is $false<br /> | Note: If F parameter is not used, $iif returns $null if the C statement is $false<br /> | ||
| − | Note: If C evaluates to $false or $null or 0 (including 000 or 0.00), it is $false | + | Note: If C evaluates to $false or $null or 0 (including 000 or 0.00), it is $false. $true or non-zero or text strings are $true<br /> |
| + | Note: If both T and F conditions contain identifier calls, the T condition's identifier/alias is called/evaluated only if C evaluates as $true, and the F condition's alias is called only if C evaluates as $false | ||
== Properties == | == Properties == | ||
None | None | ||
== Example == | == Example == | ||
| + | <source lang="mIRC"> | ||
| + | //echo -a My IP address $ip is an $iif( $calc($right($ip,1) % 2),odd,even) number | ||
| + | </source> | ||
<source lang="mIRC"> | <source lang="mIRC"> | ||
//echo -a $iif(0,$custom1(true1),$custom2(false2)) / $v1 $v2 | //echo -a $iif(0,$custom1(true1),$custom2(false2)) / $v1 $v2 | ||
| − | + | ||
| + | Calls the custom2 identifier and returns any string returned by it. | ||
| + | $v1 is filled with the 1st term of the C condition. Because the conditional was $false, the $custom1 alias in the T branch is not called. | ||
| + | |||
//echo -a $iif(2 > 1,$custom1(true1),$custom2(false2)) / $v1 $v2 | //echo -a $iif(2 > 1,$custom1(true1),$custom2(false2)) / $v1 $v2 | ||
| − | + | ||
| − | // | + | Calls the custom1 identifier and returns any string returned by it. |
| − | // | + | $v1 is filled with 2 (the 1st term of the C condition) and $v2 is filled with 1 (the 2nd term of C). |
| + | |||
| + | //echo -a today: $iif($asctime($ctime,ddd) isin MonTueWedThuFri,Weekday,Weekend) | ||
| + | //echo -a today: $iif($asctime($ctime,ddd) isin MonTueWedThuFri,Weekday) | ||
1st of the pair returns either Weekday or Weekend | 1st of the pair returns either Weekday or Weekend | ||
2nd of the pair returns either Weekday or $null because of the missing F parameter. | 2nd of the pair returns either Weekday or $null because of the missing F parameter. | ||
| + | |||
$iif conditionals can be nested: | $iif conditionals can be nested: | ||
//echo -a Classes on the $iif($asctime($ctime,ddd) isin SatSun,Sat-Sun, $iif(T* iswm $asctime($ctime,ddd),Tue-Thur,Mon-Wed-Fri)) Schedule meet today | //echo -a Classes on the $iif($asctime($ctime,ddd) isin SatSun,Sat-Sun, $iif(T* iswm $asctime($ctime,ddd),Tue-Thur,Mon-Wed-Fri)) Schedule meet today | ||
</source> | </source> | ||
| + | |||
| + | Note: see the {{mIRC|msl_injection}} page for explanation/examples of how malformed $iif syntax can trick users into executing code from the editbox. This next example causes you to perform the /QUIT command if you remove the 'echo -a' from it: | ||
| + | |||
| + | <source lang="mIRC"> | ||
| + | //echo -a $iif(($regsubex(dim[int:x];for[x=0:20:3]x*TAN-1<<DEG[]<<SQ[],/[^A1NT]/g,)) echo -a $base($v1, 34, 35) I accidentally math, I math right! ) | ||
| + | </source> | ||
| + | |||
| + | Note: $iif is a relatively slow identifier, and in some situations it can benchmark faster to replace it with a /set and an /if command pair. | ||
| + | |||
| + | <source lang="mIRC"> | ||
| + | //var %a $iif($rand(0,1),True,False) | ||
| + | vs | ||
| + | var %a False | ||
| + | if ($rand(0,1)) var %a True | ||
| + | </source> | ||
| + | |||
== Compatibility == | == Compatibility == | ||
{{mIRC compatibility|5.4}} | {{mIRC compatibility|5.4}} | ||
| − | |||
== See Also == | == See Also == | ||
{{collist | {{collist | ||
| Line 37: | Line 63: | ||
* {{mIRC|$true}} | * {{mIRC|$true}} | ||
* {{mIRC|$false}} | * {{mIRC|$false}} | ||
| + | * {{mIRC|msl_injection}} | ||
}} | }} | ||
[[Category:mIRC identifiers|$didtok]] | [[Category:mIRC identifiers|$didtok]] | ||
Latest revision as of 04:39, 4 April 2020
Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
$iif returns a conditional value depending on whether a conditional statement resolves to $true or $false.
Synopsis[edit]
$iif(C,T [,F] )
Parameters[edit]
- C - A conditional statement that determines whether this identifier returns the $true or $false conditional.
- T - The string returned and/or identifier evaluated/executed if the C statement is $true
- F - Optional string returned and/or identifier evaluated/executed if the C statement is $false
Note: If F parameter is not used, $iif returns $null if the C statement is $false
Note: If C evaluates to $false or $null or 0 (including 000 or 0.00), it is $false. $true or non-zero or text strings are $true
Note: If both T and F conditions contain identifier calls, the T condition's identifier/alias is called/evaluated only if C evaluates as $true, and the F condition's alias is called only if C evaluates as $false
Properties[edit]
None
Example[edit]
//echo -a My IP address $ip is an $iif( $calc($right($ip,1) % 2),odd,even) number
//echo -a $iif(0,$custom1(true1),$custom2(false2)) / $v1 $v2 Calls the custom2 identifier and returns any string returned by it. $v1 is filled with the 1st term of the C condition. Because the conditional was $false, the $custom1 alias in the T branch is not called. //echo -a $iif(2 > 1,$custom1(true1),$custom2(false2)) / $v1 $v2 Calls the custom1 identifier and returns any string returned by it. $v1 is filled with 2 (the 1st term of the C condition) and $v2 is filled with 1 (the 2nd term of C). //echo -a today: $iif($asctime($ctime,ddd) isin MonTueWedThuFri,Weekday,Weekend) //echo -a today: $iif($asctime($ctime,ddd) isin MonTueWedThuFri,Weekday) 1st of the pair returns either Weekday or Weekend 2nd of the pair returns either Weekday or $null because of the missing F parameter. $iif conditionals can be nested: //echo -a Classes on the $iif($asctime($ctime,ddd) isin SatSun,Sat-Sun, $iif(T* iswm $asctime($ctime,ddd),Tue-Thur,Mon-Wed-Fri)) Schedule meet today
Note: see the msl_injection page for explanation/examples of how malformed $iif syntax can trick users into executing code from the editbox. This next example causes you to perform the /QUIT command if you remove the 'echo -a' from it:
//echo -a $iif(($regsubex(dim[int:x];for[x=0:20:3]x*TAN-1<<DEG[]<<SQ[],/[^A1NT]/g,)) echo -a $base($v1, 34, 35) I accidentally math, I math right! )
Note: $iif is a relatively slow identifier, and in some situations it can benchmark faster to replace it with a /set and an /if command pair.
//var %a $iif($rand(0,1),True,False) vs var %a False if ($rand(0,1)) var %a True
Compatibility[edit]
Added: mIRC v5.4
Added on: 23 Jun 1998
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.