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

m (Fix typos)
 
(14 intermediate revisions by one other user not shown)
Line 9: Line 9:
 
* {{mirc|$halted}} - returns $true if the default actions for this event has been halted
 
* {{mirc|$halted}} - returns $true if the default actions for this event has been halted
 
* {{mirc|$eventid}} - returns an ID so that dll can evaluate local identifiers during events.
 
* {{mirc|$eventid}} - returns an ID so that dll can evaluate local identifiers during events.
−
* {{mirc|$eventparms}} - if the event has a matchtext, returns the value of the matchtext with spacee preserved
+
* {{mirc|$eventparms}} - if the event has a matchtext, returns the value of the matchtext with spaces preserved
 
* {{mirc|$matchkey}} - if the event has a matchtext, returns the value of the matchtext, with spaces lost.
 
* {{mirc|$matchkey}} - if the event has a matchtext, returns the value of the matchtext, with spaces lost.
  
Line 15: Line 15:
  
 
* {{mirc|$address}} - returns the address of the user triggering the event in the format user@host
 
* {{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|$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|$nick}} - returns the nickname of the user triggering the event
 
* {{mirc|$rawmsg}} - returns the raw server line message
 
* {{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|$site}} - return the part after the @ in $address
 
* {{mirc|$wildsite}} - returns the address of the user triggering the event in the format *!*@host
 
* {{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:
 
They apply to:
Line 61: Line 66:
 
* {{mIRC|ctcp event}}
 
* {{mIRC|ctcp event}}
  
−
There a few more local identifier related to IRC which exists only in specific events:
+
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|$banmask}} - used inside {{mIRC|on ban}} and {{mIRC|on unban}}, returns the mask that is being banned/unbanned
Line 72: Line 77:
 
* {{mirc|$vnick}} - used inside the {{mIRC|on voice}} and {{mIRC|on devoice}} events, returns the name of the voiced/devoiced nickname
 
* {{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|$cd}} - used inside the {{mIRC|on chat}} and {{mIRC|on serv}} events, returns the current directory of the connected user
−
* {{mirc|$clevel}} - returns the matching event level for a triggered event
+
* {{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 ===
 
=== Non IRC events ===
Line 79: Line 85:
  
 
* {{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
 
* {{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
−
* {{mirc|$hotline}} - used inside {{mIRC|on hotlink}}
+
* {{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}}
+
* {{mirc|$hotlink}} - used inside {{mIRC|on hotlink}}, returns information about the context in which the on hotlink event triggered
−
* {{mirc|$hotlinepos}} - used inside {{mIRC|on hotlink}}
+
* {{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|$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|$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|$parseutf}} - used inside {{mIRC|on parseline}}, returns $true if the line is going to be utf8 encoded/decoded after the event
−
* {{mirc|$signal}} - used inside {{mIRC|on signal}}, returns the name of the signal
 
 
* {{mirc|$target}} - used inside events which accept a window parameter, returns the name of the window
 
* {{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|$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.
  
 
=== $1- ===
 
=== $1- ===
Line 93: Line 119:
 
Additionally '''$1-''' is filled with a message, applicable in the following events:
 
Additionally '''$1-''' is filled with a message, applicable in the following events:
  
−
* {{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}} returns the text that was sent by the user
+
* {{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 input}} - returns the text in the editbox
 
* {{mIRC|on kick}} - returns the kick message
 
* {{mIRC|on kick}} - returns the kick message

Latest revision as of 11:50, 13 February 2024

Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
v · d · e

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[edit]

  • $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 spaces preserved
  • $matchkey - if the event has a matchtext, returns the value of the matchtext, with spaces lost.

IRC related events which involve an user[edit]

  • $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[edit]

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 information 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-[edit]

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

Retrieved from "https://en.wikichip.org/w/index.php?title=mirc/local_identifiers&oldid=102299"