Scriptwiki - User contributions [en]

Dec

2005-11-08T20:53:24Z

Tovrleaf: added category

This decreases the value of %var by value.

/dec [-cszuN] <%var> [value]

Options explained:
uN - decreases %var once and [[unset|unsets]] it N seconds later.
z - decreases %var until it reaches zero and then unsets it.
s - displays action in status window
c - decreases %var once per second.

If no value is given, default value is 1.

== Example ==

This example shows how to use dec basically in a while-loop:
var %i = 10
while (%i) {
echo -ag [[$chr]](37) [[DollarPlus|$+]] i = %i
dec %i
}

== See Also ==
*To increase a variable, you can use [[inc]].
*Read [[While_loops|While loops]] to learn more about them.

[[Category:Variables]]

Raw 001

2005-11-08T09:56:38Z

Tovrleaf: typo

<table>
<tr>
<td>Name:</td><td>RPL_WELCOME</td>
</tr>
<tr>
<td>Format:</td><td><source> 001 <target> :Welcome to the Internet Relay Network [via <provider>], <target></td>
</tr>
<tr>
<td valign="top">Info:</td><td>
This is returned when connecting<br />
[via <provider>] only appears when the following F line has been set
feature: PROVIDER
* Type: string
* Default: NULL
<br />
This string as added to the 001 numeric prefixed with "via" before the nick.
It's used for providing promotional space to providers as per CFV-202
</td>
</tr>
<tr>
<td>Example:</td><td> irc.quakenet.org 001 Dana :Welcome to the Internet Relay Network, Dana</td>
</tr>
</table>

[[Category:Raws]]

If-then-else

2005-10-28T07:21:37Z

Tovrleaf:

#Redirect [[if]]

Aliases as functions

2005-10-28T07:19:55Z

Tovrleaf: fixed links

Most people think aliases are only used as custom commands, easier to use than typing a list of commands over and over again. When writing larger scripts however, aliases are often used as what are mostly called 'routines' or 'functions'.

This script will show an example of using aliases in such a way. It calculates how much percent of the persons in all the channels you're currently in are channel operators. All of this is to be used in remote.

;First, we will create an alias that gives us the amount of people
;in all your channels.

[[aliases]] totalpeople {
;declare the variables
[[var]] %i = 1, %people
;use a while loop to go through every channel.
[[while_loops|while]] (%i <= [[$chan]](0)) {
;add the amount of people in the channel the while loop is at to %people
inc %people [[$nick]]($chan(%i),0)
;Make sure the while loops will go to the next channel.
[[inc]] %i
}
;Make the alias return the right value.
[[return]] %people
}

;From now on, $totalpeople will return the wanted amount.

;Now we will use a similar alias to count all the operators. The only difference
;is ,o added to the $nick identifier. As /help $nick states, this will make it
;only count channel operators.

alias totalops {
var %i = 1, %ops

while (%i <= $chan(0)) {
inc %ops $nick($chan(%i),0,o)
inc %i
}

return %ops
}

;This will make $totalops work too.

;As we wanted the result in percents, we should make a nice
;alias for that too. We are going to use 'arguments' again.

alias percent {
;first we will make sure the two required arguments are used. If they aren't, the
;alias will return 0 instead of a value that is actually calculated.
[[If-then-else|if]] (!$1 || !$2) { return 0 }
else {
;now we use $calc with a small bit of maths to return the actual percentage.
return [[$calc]]( [[$1-|$1]] / $2 * 100 )
}
}

;Usage of $percent will be $percent(A,B). This will show how many
;percent A is of B.

;Now let's create an alias as you're probably used to do.

alias compareops {
;A simple echo will do the trick. I also use $round to make the output look a bit
;nicer with 2 decimals.
[[echo]] [[$color]](info) -a * [[$round]]($percent($totalops,$totalpeople),2) [[$+]] [[$chr]](37) of the people in all the channels you're currently in are channel operators.
}

;You can now type /compareops to get the information you want.

[[Category:Script Archive]]

$nick (nick)

2005-10-28T07:19:26Z

Tovrleaf:

Returns Nth nickname in the channels nickname listbox on channel #.

$nick(#, N/nick, aohvr, aohvr)

First parameter marks for ''[[$chan|channel]]''. Channel can be defined as #channel or as $chan or # what marks for channel the script was triggered/executed. Second parameter ''N'' can be integer for Nth nick at channel, or person's nickname on channel. Rest of parameters are optional.

Both aohvr parameters are optional. The first specifies which nicks you'd like included, and the second specifies the nicks you'd like excluded, where:
a = all nicks, o = ops, h = halfops, v = voiced, r = regular

Parameter $nick takes ''color'', ''pnick'', ''idle'' as possible parameters.

'''color''' returns the color of nick in nicklist specified in mIRC's options.
'''pnick''' returns the nickname with prefixes in a @%+nick format.
'''idle''' returns the time in secods the user has been idle in specified channel.

== Examples ==

$nick(#foo, 0) returns the the total number of nicknames on #foo
$nick(#foo, 1) returns the 1st nickname on #foo
$nick(#foo, 1, v) returns the 1st voice on #foo
$nick(#foo, 0, a, ov) returns the total number of nicks on channel #foo excluded ops and voices.

[[var]] %i = 1
[[while_loops|while]] (%i <= $nick(#, 0)) {
[[echo]] -a $nick(#help.script, %i).pnick has been idled for [[$duration]]($nick(#help.script, %i).idle)
inc %i
}

Returns all nicks on channel with their prefixes and idle time.
Ex:
@BlackShroud has been idled for 17hrs 30mins 28secs
@Dana has been idled for 14hrs 24mins 9secs
@epicaL has been idled for 2days 7hrs 49secs
@Microbe has been idled for 6hrs 19mins 45secs

To get longest idle time on channel:
alias idletest {
var %i = 1, %idle = 0, %nick
[[while_loops|while]] (%i <= $nick(#, 0)) {
[[if]] ($nick(#, %i).idle > %idle) {
%idle = $nick(#, %i).idle
%nick = $nick(#, %i)
}
[[inc]] %i
}
[[msg]] $chan %nick has the longest idle on $chan that is $duration(%idle)
}

Returns ex: epicaL has the longest idle on #help.script that is 2days 7hrs 30mins 21secs

== See Also ==
* [[$prefix]] identifier for more information.
* Usage of property ''pnick'' in tutorial [[How_do_I_customize_mIRC's_own_output]]

[[Category:Nick and Address Identifiers]]

$bnick

2005-10-04T20:29:18Z

Tovrleaf:

$bnick refers to the banned users [[$nick|nickname]], however this would actually only be filled if the banmask itself includes a nickname. If the [[$banmask|banmask]] does not include a nickname, $bnick is [[$null]].
$bnick

Banmask consits of
''nick''!ident@host
and means that it's usually a [[iswm|wildcard]] string which means that it will be matching wildcard strings in your [[remote]] [[users]] section.

== See also ==
* [[on ban|on ban -event]]
* [[$address]]

[[Category:Nick and Address Identifiers]]

Category:Time and Date Identifiers

2005-09-21T17:53:51Z

Tovrleaf:

The following characters are recognized in the format parameter string.

Year yy 99
yyyy 1999
Month m 1
mm 01
mmm Jan
mmmm January
Day d 1
dd 01
ddd Mon
dddd Monday
Hours h 5
hh 05
H 13
HH 13
Minutes n 1
nn 01
Seconds s 1
ss 01
AM/PM t a/p
tt am/pm
T A/P
TT AM/PM
Ordinal oo st/nd/rd/th
Timezone z +0
zz +0000
zzz +0000 GMT

[[Category:Identifiers]]

$asctime

2005-09-21T17:40:45Z

Tovrleaf:

Returns the time and date in text format associated with the $ctime time value.

$asctime(N, format)

where ''N'' is the timestamp in unixtime, see [[$ctime]] for more information. See [[:Category:Time and Date Identifiers|Time and Date Identifiers]] for full list of possible formats. Both ''N'' and ''format'' are optional, but only one at the time.

$asctime([[$ctime]])

returns Wed Sep 21 20:30:26 2005 (for example). You'll get same result with $asctime(ddd mmm dd H:nn:ss yyyy). Without given ''N'', $asctime uses $ctime as default.

$asctime(793947600) returns the default text format for this time value
$asctime(hh:nn:ss) returns the current time in this format
$asctime(793947600, dd/mm/yy) returns the date for this time value

== See Also ==
* [[$ctime]]

[[Category:Time and Date Identifiers]]

News

2005-09-19T11:32:43Z

Tovrleaf: typo

== Welcome to mIRC-Wiki ==
{{newsWriter|[[User:Tovrleaf|Tovrleaf]] 22:53, 15 Sep 2005 (CEST)}}

Hi, and welcome to our new published '''mIRC-Wiki'''. mIRC-Wiki (as we call it) is our new lifelong project which is not probably ever be accomplished. It shall be developed and expended along with mIRC and new scripting skills.

Special thanks to all users helped us to get it to shape and to create a more user friendly wiki and articles.

If you think this wiki is missing some essential articles, there's a page to [[Special:Request|request]] new articles for it. And don't forget to give us [[:Special:SendComment|feedback]], comments, ideas or new suggestions.

News

2005-09-19T11:31:48Z

Tovrleaf: template

== Welcome to mIRC-Wiki ==
{{newsWriter|[[User:Tovrleaf|Tovrleaf]] 22:53, 15 Sep 2005 (CEST)}}

Hi, and welcome to our new published '''mIRC-Wiki'''. mIRC-Wiki (as we call it) is our new lifelong project which is not probably ever be accomplished. It shall be developed and expended along with mIRC and new scripting skills.

Special thanks to all users helped us to get it to shape and to create a more user friendly wiki and articles.

If you think this wiki is missing some essential articles, there's a page to [[Special:Request|request]] new articles for it. And don't forget to give us [[:Special:SendComment|feedback]], comments, ideas or new suggestions.

Template:NewsWriter

2005-09-19T11:30:42Z

Tovrleaf:

News

2005-09-15T20:55:19Z

Tovrleaf: typos

== Welcome to mIRC-Wiki ==
<div style="text-align: right; font-weight: 900;">[[User:Tovrleaf|Tovrleaf]] 22:53, 15 Sep 2005 (CEST)</div>

Hi, and welcome to our new published '''mIRC-Wiki'''. mIRC-Wiki (as we call it) is our new lifelong project which is not probably ever be accomplished. It shall be developed and expended along with mIRC and new scripting skills.

Special thanks to all users helped us to get it to shape and to create a more user friendly wiki and articles.

If you think this wiki is missing some essential articles, there's a page to [[Special:Request|request]] new articles for it. And don't forget to give us [[:Special:SendComment|feedback]], comments, ideas or new suggestions.

News

2005-09-15T20:53:07Z

Tovrleaf:

== Welcome to mIRC-Wiki ==
<div style="text-align: right; font-weight: 900;">[[User:Tovrleaf|Tovrleaf]] 22:53, 15 Sep 2005 (CEST)</div>

Hi, and welcome to our new published '''mIRC-Wiki'''. ''mIRC-Wiki'' (as we call it) is our new lifelong project which is not probably ever be accomplished. It shall be developed and expended along with mIRC and new scripting skills.

Special thanks to all users helped us to get it to shape and to create a more user friendly wiki and articles.

If you think this wiki is missing some essential articles, there's a page to [[Special:Request|request]] new articles for it. And don't forget to give us [[:Special:SendComment|feedback]]; comments, ideas or new suggestions.

Disclaimer

2005-09-15T16:26:10Z

Tovrleaf:

mIRC-wiki is encyclopedia build and edited on [[http://www.mediawiki.org/ MediaWiki]] under the GNU Free Documentation License (GFDL).
As you migth think, mIRC-wiki isn't open-content for anyone, but only for authors consists of [[:Category:Members|members]] of [[About Us|#help.script]] of [[QuakeNet]] and carefully choosen editors.

Articles are based on [[mIRC]]'s [[:Category:mIRC Help|help file]] and is trying to reproduce its structure expanded with examples and tutorials. Only syntax and category structures are copied from original mIRC's help file and therefore every article is expanded by knowledge of its author(s).

We cannot guarantee mIRC-wiki to be bug-free or its validity entirety, note that authors are only humans. It is constructed with voluntary work and users own will.

=== Copying and Copyrights ===
Do not copy, plagiarize or use without permission. For personal use only. Note that mIRC is registered trademark.

''We are in no way responsible for what might happen to you even if you blow up your house using our scripts.''

$istokcs

2005-09-15T15:48:31Z

Tovrleaf:

$istokcs() is the case-sensitive version of [[$istok]].

[[Category:Token Identifiers]]

$istokcs

2005-09-15T15:46:05Z

Tovrleaf:

#Redirect [[$istok]]

Category:Token Identifiers

2005-09-15T15:45:28Z

Tovrleaf:

 

[[Category:Identifiers]]

$istokcs

2005-09-15T15:44:44Z

Tovrleaf:

#Redirect [[$istok]]

[[Category:Token Identifiers]]

$istok

2005-09-15T15:44:19Z

Tovrleaf:

Returns [[$true]] if token exists, otherwise returns [[$false]].

$istok(text, token, C)

''Text'' is the string where we are looking for the match ''token''. ''C'' stands for ascii value of character that is used as delimiter.

'''Note''': $istokcs() is the case-sensitive version.

Ascii value for dot is ''46''. String where from we are looking ''is a.b.c.d'' and we're looking for token ''b''.
$istok(a.b.c.d, b, 46) returns $true

Note that if we'll search the same match from the string ''a.b c.d'' with same parameters, $istok(a.b c.d, b, 46) returns $false because now ''b'' belongs to token a.b.

''text'' can be anything, figurative constant, [[$1-]] or any parameters, or [[:Category:variables|variables]].

If you would like to check if you're name is in text the user typed. As separator we use space. Ascii value for it is 32.
on *:[[on text|text]]:#help.script:{
if ($istok([[$1-]], [[$me]], 32)) {
[[beep]]
notice [[$me]] Nick $nick just said your name at [[$chan]]
}
}

== See Also ==
* [[$asc]] to get character's ascii value.
* [[If-Then-Else]] for more information about if-statements.

[[Category:Token Identifiers]]

Away script

2005-09-15T15:23:38Z

Tovrleaf: edited links

This is an example of a basic away script, including autoaway and option to send a message when you're away/back.

;away alias
[[Aliases|alias]] away {
;if $1 does exist, you'll be marked as away, else you're back
[[If-Then-Else|if]] ([[$1-|$1]]) {
;this is to send an /ame when you set yourself as away
[[ame]] is away: [[$1-]]
;the ! is so the normal away alias will be used.
!away $1-
}
[[If-Then-Else|else]] {
if ([[$away]]) {
;send an /ame when you're back :]
ame is back from $1-
!away
}
else {
[[echo]] -a error, you were not marked as away yet, so you can't use /away
echo -a to be back again :)
}
}
}
;this alias is to check if you're active
alias awaycheck {
;%t is the var wich is after how many seconds you should be marked as away auto
[[var]] %t = 600
;the autoaway will only work if you're not away yet, and if $idle (the amount of seconds you've done nothing in mirc)
;is bigger then %t
if (!$away) && ($idle >= %t) {
;the ame message when you are auto away is considered as being annoying, so we'll disable that by using !away
!away autoaway after %t seconds
}
}
;start a timer for the awaycheck
on *:[[on connect|connect]]:{
;the . is so you won't see "* Timer 1 activated" when you start it
;the 0 is to let it run forever, or till you turn mirc off or your computer crashes :)
;30 means every 30 seconds
.[[timer]] 0 30 awaycheck
}
;add here all channels you don't want you're /ame messages to appear in
alias nochannels {
;return is to make it an identifyer, so you can use $nochannels wich will give everything you put behind return
[[return]] #help.script,#feds,#help,#other_channels
}
;ame alias, wich doesn't send the message to all channels
alias ame {
;make %a 1, and clear %t
var %a = 1,%t
;the while runs as long as %a is lower or equal to $chan(0)
[[While_loops|while]] (%a <= $chan(0)) {
;$istok is an identifyer wich will return $true if the $chan(%a) is in $nochannels
if (![[$istok]]($nochannels,[[$chan]](%a),44)) {
;if $chan(%a) is not it in, add the channel to %t
var %t = %t $+ $chr(44) $+ $chan(%a)
;echo in the channel the action
echo [[$color]](action text) -t $chan(%a) * [[$nick]]($chan(%a),[[$me]]).pnick $1-
}
inc %a
}
;send the message to the server
.[[raw]] PRIVMSG $right(%t,-1) $+(:,$chr(1),ACTION,$chr(32),$1-,$chr(1))
}

[[Category:Script Archive]]

Events

2005-09-15T15:20:30Z

Tovrleaf:

#Redirect [[:Category:Events]]

Echo

2005-09-15T15:09:29Z

Tovrleaf: added see also

Prints text in the specified window using the specified color.
/echo [color] [-cdeghiNtsaqlbfnmr] [color name] [#channel|[=]nick] <text>
<table>
<tr><td><b>Switch</b></td><td><b>Meaning</b></td></tr>
<tr><td>s</td><td>If a channel/nickname isn't specified, it echoes to the status window.</td></tr>
<tr><td>d</td><td>If a channel/nickname isn't specified, it echoes to the single message window.</td></tr>
<tr><td>a</td><td>If a channel/nickname isn't specified, it echoes to the active window.</td></tr>
<tr><td>e</td><td>Encloses the line in the line spearators.</td></tr>
<tr><td>iN</td><td>Indents the wrapped line by N characters.</td></tr>
<tr><td>h</td><td>Forces lines to hard-wrap so resizing the window doesn't change the line.</td></tr>
<tr><td>t</td><td>Prefixes the line with a timestamp if global time stamping is on or timestamping is on for that window.</td></tr>
<tr><td>q</td><td>Makes it not display the text if called from an alias using the . prefix.</td></tr>
<tr><td>l</td><td>Makes it apply the highlight settings to the line that's displayed.</td></tr>
<tr><td>bf</td><td>Make it apply the beep/flash settings in the window it is echoing to.</td></tr>
<tr><td>n</td><td>Prevents the echo from hiliting the window switchbar icon.</td></tr>
<tr><td>m</td><td>Indicates that the line should be treated as a user message, not an event.</td></tr>
<tr><td>g</td><td>Prevents the line from being logged to the log file.</td></tr>
<tr><td>r</td><td>Applies the strip settings in the messages dialog.</td></tr>
<tr><td>c</td><td>Uses the specified color name from the colors dialog.</td></tr>
</table>

'''Note''' that this text is only displayed in your own window and isn't sent to the server.

== Example ==
/echo -a moo
This will print moo to the active window.
/echo -sb moo
This will print moo to the status window and applies the beep setting in the window.
/echo 0 -g #help.script moo
This will print moo to the #help.script channel window in white with preventing it from logging to the log file.

== See Also ==
* Take a look on [[How do I customize mIRC's own output|How do I customize mIRC's own output]] by using echo at category [[:Category:Tutorials|Tutorials]].
* Take a look on [[Custom Windows]] to see how to print text to it.
[[Category:Commands]]

{{Stub}}

Return

2005-09-14T04:19:54Z

Tovrleaf: Custom Identifiers -> Custom Identifiers

Halts a currently executing script and allows the calling routine to continue processing.
/return [value]
You can also optionally specify a return value which will be stored in the [[$result]] [[Identifiers|identifier]]. The $result can then be used in the calling routine.

Value is optional. If identifiers doesn't return any existing value, the return [[$null]] by default.

== Example ==

[[var]] %c = 1
[[While_loops|while]] (%c <= 10) {
[[echo]] -a %c
[[If-Then-Else|if]] (%c == 5) { return }
[[inc]] %c
}
[[Echo|Echos]] values from 1 to 5.
alias foo { return Today, it's the [[$asctime]](dd.mm.yyyy) }
/echo -a $foo
This will echo 'Today, it's the <current date>', as $foo returns it.
== See Also ==

* [[:Category:Identifiers|Identifiers]]
* [[Custom Identifiers]]

[[Category:Aliases]] [[Category:Commands]]

If-Then-Else

2005-09-12T16:49:13Z

Tovrleaf:

==If-then-else statements==

The If-then-else statement allows you to compare values and execute different parts of a script based on that comparison.

if (v1 operator v2) { commands }
elseif (v1 operator v2) { commands }
else { commands }

If the first statement is true, commands inside of first brackets are executed. If the first if-statement returns false, script starts looking for elseif-statement. Elseif-statement can be only accessed if none of the same groups if's have not returned true before. And at last, if none of the statements were triggered, commands in else-statement are executed.

One if structure can consist of one main if-statement, after it there can be 0 .. N elseif-statements. There can be only one else, which can be understood as the default statement, if none one before were triggered. There doesn't need to be else-statement though.

Every if statement is handled separatly and none of others effects in another.

if (A) { ... }
elseif (B) {
if (C) { ... }
elseif (D) { ... }
elseif (E) { ... }
else { F }
}
elseif (G) { ... }
else { H }

If structure would be hierarchical represented it would look something like this

A If A is true, execute its commands and return
B If B is true,
\
C check if C, D or E returns true
D
E
F If none of these got triggered, return F
G G is checked only if A or B were not triggered
H If none of previous wasn't matches, H is returned

== The Operators ==

== equal to
=== equal to (case-sensitive)
!= not equal to
< less than
> larger than
>= larger than or equal to

<= smaller than or equal to
// v2 is a multiple of v1
\\ v2 is not a multiple of v1
& bitwise comparison

isin string v1 is in string v2
isincs string v1 is in string v2 (case sensitive)
iswm wildcard string v1 matches string v2
iswmcs wildcard string v1 matches string v2 (case sensitive)
isnum number v1 is a number in the range v2 which is in the form n1-n2 (v2 optional)
isletter letter v1 is a letter in the list of letters in v2 (v2 optional)

isalnum text contains only letters and numbers
isalpha text contains only letters
islower text contains only lower case letters
isupper text contains only upper case letters

ison nickname v1 is on channel v2
isop nickname v1 is an op on channel v2
ishop nickname v1 is a halfop on channel v2
isvoice nickname v1 has a voice on channel v2
isreg nickname v1 is a normal nick on channel v2
ischan if v1 is a channel which you are on.
isban if v1 is a banned address in internal ban list

isaop if v1 is a user in your auto-op list for channel v2 (v2 optional)
isavoice if v1 is a user in your auto-voice list for channel v2 (v2 optional)
isignore if v1 is a user in your ignore list with the ignore switch v2 (v2 optional)
isprotect if v1 is a user in your protect list for channel v2 (v2 optional)
isnotify if v1 is a user in your notify list.

To negate an operator you can prefix it with an ! exclamation mark.

=== Few examples ===

if (cat isin [[$1-]])
matches for "a cat", catalog and any string where "cat" '''is in'''.

iswm stands for is a wildcard match. Operators:
* 0..N character
? 1 character

if (*bat* iswm $1-)
allows charter before string and after it, but there's no need for it. See [[Wildcard]] for more help.

if (ca?* iswm $1-)
requires one character after "ca" and allows 0..N character after it. So it would match for cat, cab, cabin etc.

Not all comparations need two parameters.
if ($1- isupper)
returns true, if $1- oly contain uppercase letters. So ABCD returns true, but even one lowercase letter makes it return false.

== Combining comparisons ==

You can combine comparisons by using the && for AND and || for OR characters.

[[var]] %c = 5
if (%c < 6) && (%c > 0) ; returns true because %c is both, smaller than 6 and greater than 0
if (%c < 6) || (%c isalpha) ; returns true because %c is lower than 6.
; note that %c is not alphapetical and returns false, but || matches for 1 .. N true values.
if (%c < 6) && (%c isalpha) ; returns false
if (%c < 6) && (%c !isalpha) ; ! negates the operator, this this returns true

'''NOTE''' this article covers only if-then-else '''string''' operators, so you can't use
if (foo isin test.txt)
to check content of text-files. You can use [[$read]] instead of that to read content of textfile and which returns value can be used instead.

== See Also ==
* [[Wildcard]]

[[Category:Commands]]

If-Then-Else

2005-09-12T16:41:49Z

Tovrleaf: links

==If-then-else statements==

The If-then-else statement allows you to compare values and execute different parts of a script based on that comparison.

if (v1 operator v2) { commands }
elseif (v1 operator v2) { commands }
else { commands }

If the first statement is true, commands inside of first brackets are executed. If the first if-statement returns false, script starts looking for elseif-statement. Elseif-statement can be only accessed if none of the same groups if's have not returned true before. And at last, if none of the statements were triggered, commands in else-statement are executed.

One if structure can consist of one main if-statement, after it there can be 0 .. N elseif-statements. There can be only one else, which can be understood as the default statement, if none one before were triggered. There doesn't need to be else-statement though.

Every if statement is handled separatly and none of others effects in another.

if (A) { ... }
elseif (B) {
if (C) { ... }
elseif (D) { ... }
elseif (E) { ... }
else { F }
}
elseif (G) { ... }
else { H }

If structure would be hierarchical represented it would look something like this

A If A is true, execute its commands and return
B If B is true,
\
C check if C, D or E returns true
D
E
F If none of these got triggered, return F
G G is checked only if A or B were not triggered
H If none of previous wasn't matches, H is returned

== The Operators ==

== equal to
=== equal to (case-sensitive)
!= not equal to
< less than
> larger than
>= larger than or equal to

<= smaller than or equal to
// v2 is a multiple of v1
\\ v2 is not a multiple of v1
& bitwise comparison

isin string v1 is in string v2
isincs string v1 is in string v2 (case sensitive)
iswm wildcard string v1 matches string v2
iswmcs wildcard string v1 matches string v2 (case sensitive)
isnum number v1 is a number in the range v2 which is in the form n1-n2 (v2 optional)
isletter letter v1 is a letter in the list of letters in v2 (v2 optional)

isalnum text contains only letters and numbers
isalpha text contains only letters
islower text contains only lower case letters
isupper text contains only upper case letters

ison nickname v1 is on channel v2
isop nickname v1 is an op on channel v2
ishop nickname v1 is a halfop on channel v2
isvoice nickname v1 has a voice on channel v2
isreg nickname v1 is a normal nick on channel v2
ischan if v1 is a channel which you are on.
isban if v1 is a banned address in internal ban list

isaop if v1 is a user in your auto-op list for channel v2 (v2 optional)
isavoice if v1 is a user in your auto-voice list for channel v2 (v2 optional)
isignore if v1 is a user in your ignore list with the ignore switch v2 (v2 optional)
isprotect if v1 is a user in your protect list for channel v2 (v2 optional)
isnotify if v1 is a user in your notify list.

To negate an operator you can prefix it with an ! exclamation mark.

=== Few examples ===

if (cat isin [[$1-]])
matches for "a cat", catalog and any string where "cat" '''is in'''.

iswm stands for is a wildcard match. Operators:
* 0..N character
? 1 character

if (*bat* iswm $1-)
allows charter before string and after it, but there's no need for it. See [[Wildcard]] for more help.

if (ca?* iswm $1-)
requires one character after "ca" and allows 0..N character after it. So it would match for cat, cab, cabin etc.

Not all comparations need two parameters.
if ($1- isupper)
returns true, if $1- oly contain uppercase letters. So ABCD returns true, but even one lowercase letter makes it return false.

== Combining comparisons ==

You can combine comparisons by using the && for AND and || for OR characters.

[[var]] %c = 5
if (%c < 6) && (%c > 0) ; returns true because %c is both, smaller than 6 and greater than 0
if (%c < 6) || (%c isalpha) ; returns true because %c is lower than 6.
; note that %c is not alphapetical and returns false, but || matches for 1 .. N true values.
if (%c < 6) && (%c isalpha) ; returns false
if (%c < 6) && (%c !isalpha) ; ! negates the operator, this this returns true

== See Also ==
* [[Wildcard]]

[[Category:Commands]]

If-Then-Else

2005-09-12T16:41:17Z

Tovrleaf:

==If-then-else statements==

The If-then-else statement allows you to compare values and execute different parts of a script based on that comparison.

if (v1 operator v2) { commands }
elseif (v1 operator v2) { commands }
else { commands }

If the first statement is true, commands inside of first brackets are executed. If the first if-statement returns false, script starts looking for elseif-statement. Elseif-statement can be only accessed if none of the same groups if's have not returned true before. And at last, if none of the statements were triggered, commands in else-statement are executed.

One if structure can consist of one main if-statement, after it there can be 0 .. N elseif-statements. There can be only one else, which can be understood as the default statement, if none one before were triggered. There doesn't need to be else-statement though.

Every if statement is handled separatly and none of others effects in another.

if (A) { ... }
elseif (B) {
if (C) { ... }
elseif (D) { ... }
elseif (E) { ... }
else { F }
}
elseif (G) { ... }
else { H }

If structure would be hierarchical represented it would look something like this

A If A is true, execute its commands and return
B If B is true,
\
C check if C, D or E returns true
D
E
F If none of these got triggered, return F
G G is checked only if A or B were not triggered
H If none of previous wasn't matches, H is returned

== The Operators ==

== equal to
=== equal to (case-sensitive)
!= not equal to
< less than
> larger than
>= larger than or equal to

<= smaller than or equal to
// v2 is a multiple of v1
\\ v2 is not a multiple of v1
& bitwise comparison

isin string v1 is in string v2
isincs string v1 is in string v2 (case sensitive)
iswm wildcard string v1 matches string v2
iswmcs wildcard string v1 matches string v2 (case sensitive)
isnum number v1 is a number in the range v2 which is in the form n1-n2 (v2 optional)
isletter letter v1 is a letter in the list of letters in v2 (v2 optional)

isalnum text contains only letters and numbers
isalpha text contains only letters
islower text contains only lower case letters
isupper text contains only upper case letters

ison nickname v1 is on channel v2
isop nickname v1 is an op on channel v2
ishop nickname v1 is a halfop on channel v2
isvoice nickname v1 has a voice on channel v2
isreg nickname v1 is a normal nick on channel v2
ischan if v1 is a channel which you are on.
isban if v1 is a banned address in internal ban list

isaop if v1 is a user in your auto-op list for channel v2 (v2 optional)
isavoice if v1 is a user in your auto-voice list for channel v2 (v2 optional)
isignore if v1 is a user in your ignore list with the ignore switch v2 (v2 optional)
isprotect if v1 is a user in your protect list for channel v2 (v2 optional)
isnotify if v1 is a user in your notify list.

To negate an operator you can prefix it with an ! exclamation mark.

=== Few examples ===

if (cat isin [[$1-]])
matches for "a cat", catalog and any string where "cat" '''is in'''.

iswm stands for is a wildcard match. Operators:
* 0..N character
? 1 character

if (*bat* iswm $1-)
allows charter before string and after it, but there's no need for it. See [[Wildcard]] for more help.

if (ca?* iswm $1-)
requires one character after "ca" and allows 0..N character after it. So it would match for cat, cab, cabin etc.

Not all comparations need two parameters.
if ($1- isupper)
returns true, if $1- oly contain uppercase letters. So ABCD returns true, but even one lowercase letter makes it return false.

== Combining comparisons ==

You can combine comparisons by using the && for AND and || for OR characters.

var %c = 5
if (%c < 6) && (%c > 0) ; returns true because %c is both, smaller than 6 and greater than 0
if (%c < 6) || (%c isalpha) ; returns true because %c is lower than 6.
; note that %c is not alphapetical and returns false, but || matches for 1 .. N true values.
if (%c < 6) && (%c isalpha) ; returns false
if (%c < 6) && (%c !isalpha) ; ! negates the operator, this this returns true

== See Also ==
* [[Wildcard]]

[[Category:Commands]]

If

2005-09-12T16:18:21Z

Tovrleaf:

#Redirect [[If-Then-Else]]

If-Then-Else

2005-09-09T15:33:37Z

Tovrleaf:

$lower

2005-09-09T12:57:19Z

Tovrleaf:

Returns text in lowercase.

$lower(text)

$lower forces its parameter to lowercase characters.

$lower(''FOO'') returns ''foo'', and $lower(''bAr'') returns ''bar''.

== See Also ==
* [[$upper()]]

[[Category:Text and Number Identifiers]]

$chan (remote)

2005-09-09T06:30:38Z

Tovrleaf:

Returns the name of the channel for a specific event. For all non-channel [[:Category:events|events]] $chan will be [[$null]].

$chan

It takes no parameters.

on *:text:hello:#mIRC:{ [[msg]] $chan [[$nick (remote)|$nick]] hello, and welcome to $chan $+ ! }

You can also use # to evaluate channel name. Ex:
welcome to $chan
welcome to #
would return to same value.

== See Also ==

* [[$active]]

[[Category:Remote Identifiers]]

$chan

2005-09-09T06:26:29Z

Tovrleaf: split

== Categories ==
* [[$chan (remote)|$chan]] Remote Identifiers
* [[$chan (window)|$chan]] Window Identifiers

{{Disambling}}
[[Category:Remote Identifiers]][[Category:Window Identifiers]]

$chan

2005-09-09T06:24:31Z

Tovrleaf: $chan moved to $chan (window)

#REDIRECT [[$chan (window)]]

$nick (remote)

2005-09-09T06:23:05Z

Tovrleaf:

Returns the nickname of the user associated with an event.

$nick

It has no parameters.

on *:text:*help*:#mIRC:{ [[msg]] [[$chan (remote)|$chan]] $nick hold your horses, I'm coming. }

== See Also ==
* [[$nick (nick)|$nick]] Nick and Address Identifiers

[[Category:Remote Identifiers]]

$nick

2005-09-09T06:14:59Z

Tovrleaf:

== Categories ==
* [[$nick (nick)|$nick]] Nick and Address Identifiers
* [[$nick (remote)|$nick]] Remote Identifiers

{{Disambling}}
[[Category:Nick and Address Identifiers]][[Category:Remote Identifiers]]

$opnick

2005-09-05T20:57:49Z

Tovrleaf:

== Events ==
* [[on op]]
* [[on deop]]

{{Disambling}}
[[Category:Nick and Address Identifiers]]

$vnick

2005-09-05T20:53:10Z

Tovrleaf:

== Events ==
* [[on voice]]
* [[on devoice]]

{{Disambling}}
[[Category:Nick and Address Identifiers]]

Template:Disambling

2005-09-05T20:52:36Z

Tovrleaf: more margin, style

{| style="width: 100%; border: 1px solid #aaa; background: #F9F9F9; padding: 3px; margin-bottom: 30px; margin-top: 30px;"
|-
|width="50" |[[Image:Disambig.png|left|45px|Disambiguation]]
|''This is a disambiguation page — this means that one or more articles list this page and it holds reference to one or more articles or it has different meanings.''
|}

Template:Disambling

2005-09-05T20:43:51Z

Tovrleaf:

{| style="width: 100%; border: 1px solid #aaa; background: #F9F9F9; padding: 3px; margin-bottom: 30px;"
|-
|width="50" |[[Image:Disambig.png|left|45px|Disambiguation]]
|''This is a disambiguation page — this means that one or more articles list this page and it holds reference to one or more articles or it has different meanings.''
|}

File:Disambig.png

2005-09-05T20:31:45Z

Tovrleaf: * Description: Symbol of Disambiguation * Source: Own drawing, 2005 * Author: Stephan Baum * Licence: GNU FDL

* Description: Symbol of Disambiguation
* Source: Own drawing, 2005
* Author: Stephan Baum
* Licence: GNU FDL

On voice

2005-09-05T18:00:12Z

Tovrleaf:

The on VOICE event triggers when a user on a channel is voiced.

on <level>:VOICE:<#[,#]>:<commands>

[[$vnick]] refers to the user who was voiced.

== Example ==

Triggers when a user with level 999 was voiced in #help.script or #mIRC and devoices him again:

on 999:VOICE:#help.script,#mIRC: { [[mode]] [[$chan]] -v $vnick }

== See Also ==

* [[On_devoice|On devoice]] triggers when a user was devoiced.
* [[Access Levels]]

[[Category:Events]]

On devoice

2005-09-05T17:59:40Z

Tovrleaf:

The on DEVOICE event triggers when a user on a channel is devoiced.

on <level>:DEVOICE:<#[,#]>:<commands>

[[$vnick]] refers to the user who was devoiced.

== Example ==

Triggers when a user with level owner was devoiced in #help.script or #mIRC and voices him again:

on 999:DEVOICE:#help.script,#mIRC: { mode $chan +v $vnick }

== See Also ==

* [[On_voice|On voice]] triggers when a user was voiced.
* [[Access Levels]]

[[Category:Events]]

On op

2005-09-05T17:59:10Z

Tovrleaf: typo

The on OP event triggers when a user on a channel is opped.

on <level>:OP:<#[,#]>:<commands>

[[$opnick]] refers to the user who was oped.

== Example ==

Triggers when a user with level 999 was opped in #help.script or #mIRC and deops him again:

on 999:OP:#help.script,#mIRC: { mode $chan -o $opnick }

== See Also ==

* [[On_deop|On deop]] triggers when a user was deopped.
* [[Access Levels]]

[[Category:Events]]

On deop

2005-09-05T17:58:54Z

Tovrleaf:

The on DEOP event triggers when a user on a channel is deopped.

on <level>:DEOP:<#[,#]>:<commands>

[[$opnick]] refers to the user who was deoped.

== Example ==

Triggers when a user with level owner was deopped in #help.script or #mIRC and ops him again:

on owner:DEOP:#help.script,#mIRC: { mode $chan +o $opnick }

== See Also ==

* [[On_op|On op]] triggers when a user was opped.
* [[Access Levels]]

[[Category:Events]]

On op

2005-09-05T17:58:17Z

Tovrleaf:

On connect

2005-09-05T16:47:49Z

Tovrleaf:

The on CONNECT event triggers when [[mIRC]] connects to an [[IRC]] Server right after the [[MOTD]] is displayed.

on <level>:CONNECT:<commands>

On connect event is most commonly used to perform commands right after joining a server, such as automaticly joining channels or authenticate with [[Q]] bot.

on *:connect:{
if ([[$network]] === QuakeNet) && ([[$right]]([[$server]], 13) === .quakenet.org) {
!var %u = username
!var %p = password
!.msg Q@CServe.quakenet.org auth %u %p

[[join]] #help.script
join #mIRC
}
}

Please note, that keeping your account secure is up to you, the user, and cannot be achieved by anyone/thing else. So using automaticly authenticating scripts or storing your Q-password to remote file is your own choise and only You. There's always existing security risk. Read [http://www.quakenet.org/faq/faq.php?c=160&expand=yup&l=0 Security FAQ] at QuakeNet's site for further information.

{{Author|Tovrleaf}}

== See Also ==
* [[on_disconnect|on disconnect]]
* [[on_connectfail|on connectfail]]
* {{Relatedraws|join}}

[[Category:Events]]

On connect

2005-09-05T15:47:56Z

Tovrleaf: added link

Category:Events

2005-09-05T15:46:29Z

Tovrleaf:

 

[[Category:Remote]]

On connect

2005-09-05T15:45:59Z

Tovrleaf:

The on CONNECT event triggers when [[mIRC]] connects to an [[IRC]] Server right after the [[MOTD]] is displayed.

on <level>:CONNECT:<commands>

On connect event is most commonly used to perform commands right after joining a server, such as automaticly joining channels or authenticate with [[Q]] bot.

on *:connect:{
if ([[$network]] === QuakeNet) && ([[$right]]([[$server]], 13) === .quakenet.org) {
!var %u = username
!var %p = password
!.msg Q@CServe.quakenet.org auth %u %p

join #help.script
join #mIRC
}
}

Please note, that keeping your account secure is up to you, the user, and cannot be achieved by anyone/thing else. So using automaticly authenticating scripts or storing your Q-password to remote file is your own choise and only You. There's always existing security risk. Read [http://www.quakenet.org/faq/faq.php?c=160&expand=yup&l=0 Security FAQ] at QuakeNet's site for further information.

== See Also ==
* [[on_disconnect|on disconnect]]
* [[on_connectfail|on connectfail]]

[[Category:Events]]

IRC

2005-09-04T20:58:07Z

Tovrleaf: redirected

#Redirect [[Category:IRC]]

Template:User da

2005-09-03T08:58:41Z

Tovrleaf:

<div style="float:left;border:solid #6EF7A7 1px;margin:1px">
{| cellspacing="0" style="width:238px;background:#C5FCDC"
| style="width:45px;height:45px;background:#6EF7A7;text-align:center;font-size:14pt" | '''da'''
| style="font-size:8pt;padding:4pt;line-height:1.25em" | Denne bruger har '''[[:Category:User da|dansk]]''' som '''modersmål'''.
|}</div>

[[Category:User da|{{PAGENAME}}]]