From WikiChip
Difference between revisions of "mirc/local identifiers"
< mirc

(IRC related events)
(Non IRC events)
(31 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
'''Local identifiers''' are {{mirc|identifiers}} which only function inside specific events. Attempting to call such identifiers from outside of their designed scope might have undesired results or might simply return {{mirc|$null}}.
 
'''Local identifiers''' are {{mirc|identifiers}} which only function inside specific events. Attempting to call such identifiers from outside of their designed scope might have undesired results or might simply return {{mirc|$null}}.
  
== local identifiers ==
+
Below is a list of all the local identifiers for all events.
Below is a list of all the local identifiers for all events:
 
  
=== IRC related events ===
+
=== All events ===
The following are considered IRC events. Only inside those events various local identifiers may be called.
 
  
{{collist
+
* {{mirc|$event}} - returns the name of the event
|count = 3
+
* {{mirc|$halted}} - returns $true if the default actions for this event has been halted
|* {{mIRC|on action}}
+
* {{mirc|$eventid}} - returns an ID so that dll can evaluate local identifiers during events.
* {{mIRC|on ban}}
+
* {{mirc|$eventparms}} - if the event has a matchtext, returns the value of the matchtext with spacee preserved
* {{mIRC|on connect}}
+
* {{mirc|$matchkey}} - if the event has a matchtext, returns the value of the matchtext, with spaces lost.
* {{mIRC|on disconnect}}
+
 
* {{mIRC|on connectfail}}
+
=== IRC related events which involve an user ===
 +
 
 +
* {{mirc|$address}} - returns the address of the user triggering the event in the format user@host
 +
* {{mirc|$maddress}} - returns the address of the user for that event, as provided by the server
 +
* {{mirc|$fulladdress}} - returns the full address of the user triggering the event in the format nick!user@host
 +
* {{mirc|$nick}} - returns the nickname of the user triggering the event
 +
* {{mirc|$rawmsg}} - returns the raw server line message
 +
* {{mIRC|$rawbytes}} - returns the undecoded raw line message.
 +
* {{mirc|$site}} - return the part after the @ in $address
 +
* {{mirc|$wildsite}} - returns the address of the user triggering the event in the format *!*@host
 +
* {{mIRC|$ulevel}} - returns the level of the user that was matched for the triggered event.
 +
* {{mirc|$clevel}} - returns the matching event level for a triggered event
 +
 
 +
 
 +
They apply to:
 +
 
 +
* {{mIRC|on action}}
 +
* {{mIRC|on ban}}  
 
* {{mIRC|on ctcpreply}}
 
* {{mIRC|on ctcpreply}}
 
* {{mIRC|on dehelp}}
 
* {{mIRC|on dehelp}}
Line 50: Line 65:
 
* {{mIRC|on wallops}}
 
* {{mIRC|on wallops}}
 
* {{mIRC|ctcp event}}
 
* {{mIRC|ctcp event}}
}}
 
  
Additionally '''$1-''' is filled with a message, applicable in all events above except for {{mIRC|on ban}}, {{mIRC|on connect}}, {{mIRC|on disconnect}}, {{mIRC|on dehelp}}, {{mIRC|on devoice}}, {{mIRC|on deop}}, {{mIRC|on deowner}}, {{mIRC|on filercvd}}, {{mIRC|on filesent}}, {{mIRC|on action}}, {{mIRC|on action}}, {{mIRC|on action}}, {{mIRC|on action}}, {{mIRC|on action}}, {{mIRC|on action}}, {{mIRC|on action}}, {{mIRC|on action}}
+
There a few more local identifier related to IRC which exists only in specific IRC events/case:
 +
 
 +
* {{mirc|$banmask}} - used inside {{mIRC|on ban}} and {{mIRC|on unban}}, returns the mask that is being banned/unbanned
 +
* {{mirc|$bnick}} - used inside {{mIRC|on ban}} and {{mIRC|on unban}}, returns the nickname that is being banned/unbanned, if any
 +
* {{mirc|$chan}} - used inside events which trigger for channel window
 +
* {{mirc|$hnick}} - used inside {{mIRC|on help}} and {{mIRC|on dehelp}}, returns the nickname being given +h/-h
 +
* {{mirc|$knick}} - used inside {{mIRC|on kick}}, returns the nickname being kicked
 +
* {{mirc|$newnick}} - used inside {{mIRC|on nick}}, returns the new nickname
 +
* {{mirc|$opnick}} - used inside {{mIRC|on op}}, {{mIRC|on deop}}, {{mIRC|on owner}} and {{mIRC|on deowner}}, returns the nickname being opped/deopped/owner'd/deowner'd
 +
* {{mirc|$vnick}} - used inside the {{mIRC|on voice}} and {{mIRC|on devoice}} events, returns the name of the voiced/devoiced nickname
 +
* {{mirc|$cd}} - used inside the {{mIRC|on chat}} and {{mIRC|on serv}} events, returns the current directory of the connected user
 +
* {{mIRC|$parseline}} {{mIRC|$parsetype}} {{mIRC|$parseutf}} - available in the {{mIRC|on parseline}} event, returns the raw line, the in/out type of direction, and whether or not mIRC is going to decode to utf8 respectively.
 +
* {{mirc|$msgstamp}} - returns UTC timestamp for a irc server message that has an IRCv3 @time prefix tag
 +
 
 +
=== Non IRC events ===
 +
 
 +
Here is a list for non IRC events:
  
=== Local Identifiers ===
+
* {{mirc|$filename}} - used inside {{mIRC|on filesent}}, {{mIRC|on getfail}}, {{mIRC|on midiend}}, {{mIRC|on waveend}}, {{mIRC|on songend}}, {{mIRC|on nosound}}, {{mIRC|on playend}}, {{mIRC|on mp3end}}, returns the filename that was involved
Below is a list of local identifiers:
+
* {{mirc|$hotline}} - used inside {{mIRC|on hotlink}}, returns the full line containing the word which made the event triggers.
 +
* {{mirc|$hotlink}} - used inside {{mIRC|on hotlink}}, returns informations about the context in which the on hotlink event triggered
 +
* {{mirc|$hotlinepos}} - used inside {{mIRC|on hotlink}}, returns line number and word position of the matched word
 +
* {{mirc|$parseline}} - used inside {{mIRC|on parseline}}, returns the line being parsed
 +
* {{mirc|$parsetype}} - used inside {{mIRC|on parseline}}, returns the type of message, in/out
 +
* {{mirc|$parseutf}} - used inside {{mIRC|on parseline}}, returns $true if the line is going to be utf8 encoded/decoded after the event
 +
* {{mirc|$target}} - used inside events which accept a window parameter, returns the name of the window
 +
* {{mIRC|$agentname}} - used inside {{mIRC|on agent}}, returns the name of the agent.
 +
* {{mirc|$window}} - returns the name of the window that was left in a 'leave' menu {} event, whereas $leftwin is not a local identifier
 +
* {{mirc|$ctrlenter}} - used inside {{mirc|on input}}, returns $true if keys control+enter have been used to trigger the event.
 +
* {{mirc|$inpaste}} - used inside {{mirc|on input}}, returns $true if the event is triggering because you are pasting (multiple lines usually), not because you pressed enter.
 +
* {{mirc|$did}} - used inside {{mirc|on dialog}}, returns the ID of the control that is triggering the event
 +
* {{mirc|$dname}} - used inside {{mirc|on dialog}}, returns the name of the dialog that is triggering the event
 +
* {{mirc|$devent}} - used inside {{mirc|on dialog}}, returns the name of the event that is triggering the on dialog event.
 +
* {{mirc|$keyval}} - used inside {{mirc|on keydown}} and {{mirc|on keyup}}, returns the value of the keypress, always a number.
 +
* {{mirc|$keychar}} - used inside {{mirc|on keydown}} and {{mirc|on keyup}}, returns the character of the keypress.
 +
* {{mirc|$keyrpt}} - used inside {{mirc|on keydown}}, returns $true if the event triggers because the key is held down.
 +
* {{mirc|$menu}} - used inside menu { } event, returns the name of the menu
 +
* {{mirc|$menutype}} - used inside menu { } event, returns the type of the menu
 +
* {{mirc|$menucontext}} - used inside menu { } event, returns the context in which the popup was created
 +
* {{mirc|$sockbr}} - used inside socket events where /sockread is allowed, returns the number of bytes read
 +
* {{mirc|$sockname}} - used inside socket events, returns the name of the socket
 +
* {{mirc|$signal}} - used inside {{mirc|on signal}} event, returns the name of the signal.
 +
* {{mirc|$iaddress}} - used inside {{mirc|on dns}}, returns the ip address, if available
 +
* {{mirc|$raddress}} - used inside {{mirc|on dns}}, returns the resolved address
 +
* {{mirc|$naddress}} - used inside {{mirc|on dns}}, returns the address being resolved
 +
* {{mirc|$modefirst}} - used inside any channel specific mode event (on op, on dehelp, but not on rawmode or on mode), returns $true if the mode you're dealing with is the first
 +
* {{mirc|$modelast}} - used inside any channel specific mode event (on op, on dehelp, but not on rawmode or on mode), returns $true if the mode you're dealing with is the last
 +
* {{mirc|$mode}} - used typically inside {{mirc|on rawmode}}, returns the Nth nick affected by a mode.
  
{{collist
+
=== $1- ===
|count = 3
 
|
 
* {{mirc|$address}}
 
* {{mirc|$chan}}
 
* {{mirc|$fulladdress}}
 
* {{mirc|$halted}}
 
* {{mirc|$hnick}}
 
* {{mirc|$nick}}
 
* {{mirc|$opnick}}
 
* {{mirc|$site}}
 
* {{mirc|$vnick}}
 
* {{mirc|$wildsite}}
 
}}
 
  
 +
Additionally '''$1-''' is filled with a message, applicable in the following events:
  
{{stub}}
+
* {{mIRC|on text}}, {{mIRC|on action}}, {{mIRC|on chat}}, {{mIRC|on snotice}}, {{mIRC|on notice}} {{mIRC|on serv}}, {{mIRC|on open}}, {{mIRC|on ctcpreply}}, {{mIRC|ctcp_events|ctcp}} returns the text that was sent by the user
 +
* {{mIRC|on input}} - returns the text in the editbox
 +
* {{mIRC|on kick}} - returns the kick message
 +
* {{mIRC|on connectfail}} - returns the error message
 +
* {{mIRC|on error}} - returns the error message
 +
* {{mIRC|on hotlink}} - returns the word you hovered (stripped from control code).
 +
* {{mIRC|on mode}}, {{mIRC|on rawmode}} and {{mIRC|on servermode}} - returns the new modes
 +
* {{mIRC|on quit}} & {{mIRC|on part}}, returns the quit/part message if any
 +
* {{mIRC|on ping}} & {{mIRC|on pong}}, returns the ping/pong value
 +
* {{mIRC|on signal}} - returns the parameters of the signal
 +
* {{mIRC|on tabcomp}} - returns the line in which you pressed the tab key in the editbox
 +
* {{mIRC|on topic}} - returns the new topic
 +
* {{mIRC|on usermode}} - returns the new usermode
 +
* {{mIRC|on vcmd}} - returns the recognized word

Revision as of 17:21, 27 April 2019

Local identifiers are identifiers which only function inside specific events. Attempting to call such identifiers from outside of their designed scope might have undesired results or might simply return $null.

Below is a list of all the local identifiers for all events.

All events

  • $event - returns the name of the event
  • $halted - returns $true if the default actions for this event has been halted
  • $eventid - returns an ID so that dll can evaluate local identifiers during events.
  • $eventparms - if the event has a matchtext, returns the value of the matchtext with spacee preserved
  • $matchkey - if the event has a matchtext, returns the value of the matchtext, with spaces lost.

IRC related events which involve an user

  • $address - returns the address of the user triggering the event in the format user@host
  • $maddress - returns the address of the user for that event, as provided by the server
  • $fulladdress - returns the full address of the user triggering the event in the format nick!user@host
  • $nick - returns the nickname of the user triggering the event
  • $rawmsg - returns the raw server line message
  • $rawbytes - returns the undecoded raw line message.
  • $site - return the part after the @ in $address
  • $wildsite - returns the address of the user triggering the event in the format *!*@host
  • $ulevel - returns the level of the user that was matched for the triggered event.
  • $clevel - returns the matching event level for a triggered event


They apply to:

There a few more local identifier related to IRC which exists only in specific IRC events/case:

Non IRC events

Here is a list for non IRC events:

  • $filename - used inside on filesent, on getfail, on midiend, on waveend, on songend, on nosound, on playend, on mp3end, returns the filename that was involved
  • $hotline - used inside on hotlink, returns the full line containing the word which made the event triggers.
  • $hotlink - used inside on hotlink, returns informations about the context in which the on hotlink event triggered
  • $hotlinepos - used inside on hotlink, returns line number and word position of the matched word
  • $parseline - used inside on parseline, returns the line being parsed
  • $parsetype - used inside on parseline, returns the type of message, in/out
  • $parseutf - used inside on parseline, returns $true if the line is going to be utf8 encoded/decoded after the event
  • $target - used inside events which accept a window parameter, returns the name of the window
  • $agentname - used inside on agent, returns the name of the agent.
  • $window - returns the name of the window that was left in a 'leave' menu {} event, whereas $leftwin is not a local identifier
  • $ctrlenter - used inside on input, returns $true if keys control+enter have been used to trigger the event.
  • $inpaste - used inside on input, returns $true if the event is triggering because you are pasting (multiple lines usually), not because you pressed enter.
  • $did - used inside on dialog, returns the ID of the control that is triggering the event
  • $dname - used inside on dialog, returns the name of the dialog that is triggering the event
  • $devent - used inside on dialog, returns the name of the event that is triggering the on dialog event.
  • $keyval - used inside on keydown and on keyup, returns the value of the keypress, always a number.
  • $keychar - used inside on keydown and on keyup, returns the character of the keypress.
  • $keyrpt - used inside on keydown, returns $true if the event triggers because the key is held down.
  • $menu - used inside menu { } event, returns the name of the menu
  • $menutype - used inside menu { } event, returns the type of the menu
  • $menucontext - used inside menu { } event, returns the context in which the popup was created
  • $sockbr - used inside socket events where /sockread is allowed, returns the number of bytes read
  • $sockname - used inside socket events, returns the name of the socket
  • $signal - used inside on signal event, returns the name of the signal.
  • $iaddress - used inside on dns, returns the ip address, if available
  • $raddress - used inside on dns, returns the resolved address
  • $naddress - used inside on dns, returns the address being resolved
  • $modefirst - used inside any channel specific mode event (on op, on dehelp, but not on rawmode or on mode), returns $true if the mode you're dealing with is the first
  • $modelast - used inside any channel specific mode event (on op, on dehelp, but not on rawmode or on mode), returns $true if the mode you're dealing with is the last
  • $mode - used typically inside on rawmode, returns the Nth nick affected by a mode.

$1-

Additionally $1- is filled with a message, applicable in the following events: