From WikiChip
Difference between revisions of "mirc/on events/on nick"
< mirc‎ | on events

m (→‎Parameters: Add this)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
{{mIRC Guide}}
+
{{mirc title|On Nick - Events}}
 
The '''ON NICK''' event triggers when a user is on the same channel as you, and they change their nickname.
 
The '''ON NICK''' event triggers when a user is on the same channel as you, and they change their nickname.
  
−
This event fills the '''{{mIRC|$chan}}''', '''{{mIRC|$newnick}}''', and '''{{mIRC|$nick}}''' identifiers.
+
This event fills the '''{{mIRC|$newnick}}''' and '''{{mIRC|$nick}}''' identifiers.
  
 
{| class="wikitable" style="line-height: 25px; margin-left: 75px;"
 
{| class="wikitable" style="line-height: 25px; margin-left: 75px;"
 
|-
 
|-
 
! Identifier !! Description
 
! Identifier !! Description
−
|-
 
−
| '''$chan''' || The channel name where the event occurred. This can also be '''#'''.
 
 
|-
 
|-
 
| '''$newnick''' || The new nickname of the user. You can use it with $comchan for example.
 
| '''$newnick''' || The new nickname of the user. You can use it with $comchan for example.
Line 17: Line 15:
 
== Synopsis ==
 
== Synopsis ==
 
<pre>ON <level>:NICK:<commands></pre>
 
<pre>ON <level>:NICK:<commands></pre>
 +
 +
== Parameters ==
 +
<span style="display: inline-block; width: 105px;">'''<level>'''</span>The corresponding {{mIRC|access levels}} for the event to trigger.
 +
 +
<span style="display: inline-block; width: 105px;">'''<commands>'''</span>The commands to be performed when the event listener's criteria is met.
 +
  
 
== Example ==
 
== Example ==
 
Echo the nickname change, and disregard mIRC's default nick change message:
 
Echo the nickname change, and disregard mIRC's default nick change message:
 
<source lang="mIRC">ON ^*:NICK: {
 
<source lang="mIRC">ON ^*:NICK: {
−
   echo $chan * $nick |==> $newnick
+
   echo $comchan($newnick,1) * $nick |==> $newnick
  
 
   ; Halt the default mIRC message
 
   ; Halt the default mIRC message
Line 32: Line 36:
 
Echo to the channel when the local nickname is changed, and halt mIRC's default message:
 
Echo to the channel when the local nickname is changed, and halt mIRC's default message:
 
<source lang="mIRC">ON ME:^*:NICK: {
 
<source lang="mIRC">ON ME:^*:NICK: {
−
   echo $chan You are now ==> $newnick
+
   echo $comchan($newnick,1) You are now ==> $newnick
  
 
   ; Halt the default mIRC message
 
   ; Halt the default mIRC message
Line 40: Line 44:
 
The example above should have an output resembling the following:
 
The example above should have an output resembling the following:
 
<pre>You are now ==> whoMe</pre>
 
<pre>You are now ==> whoMe</pre>
 +
 +
<source lang="mIRC">
 +
Because ON NICK is not associated with # or $chan, to show a nick change message in all channels you share with that nick, you can use $comchan. You can simulate mIRC's default Nick Change message in channels with:
 +
 +
ON ^*:NICK:{
 +
  var %i $comchan($newnick,0)
 +
  while (%i) {
 +
    echo -ctg nick $chan(%i) * # $iif($nick == $me,Your nick # is now,$nick is now known as) $newnick
 +
    dec %i
 +
  }
 +
; You can precede HALTDEF with a semi-colon to compare this messages with the default
 +
haltdef
 +
}
 +
</source>
  
 
== Compatibility ==
 
== Compatibility ==

Latest revision as of 06:54, 6 February 2024

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

The ON NICK event triggers when a user is on the same channel as you, and they change their nickname.

This event fills the $newnick and $nick identifiers.

Identifier Description
$newnick The new nickname of the user. You can use it with $comchan for example.
$nick The user's previous nickname.

Synopsis[edit]

ON <level>:NICK:<commands>

Parameters[edit]

<level>The corresponding access levels for the event to trigger.

<commands>The commands to be performed when the event listener's criteria is met.


Example[edit]

Echo the nickname change, and disregard mIRC's default nick change message: 

ON ^*:NICK: {
  echo $comchan($newnick,1) * $nick |==> $newnick
 
  ; Halt the default mIRC message
  haltdef
}

The results of the above example resemble the following: 

* Mr_SOCKS |==> noLaundry

Echo to the channel when the local nickname is changed, and halt mIRC's default message: 

ON ME:^*:NICK: {
  echo $comchan($newnick,1) You are now ==> $newnick
 
  ; Halt the default mIRC message
  haltdef
}

The example above should have an output resembling the following: 

You are now ==> whoMe
Because ON NICK is not associated with # or $chan, to show a nick change message in all channels you share with that nick, you can use $comchan. You can simulate mIRC's default Nick Change message in channels with:
 
ON ^*:NICK:{
  var %i $comchan($newnick,0)
  while (%i) {
    echo -ctg nick $chan(%i) * # $iif($nick == $me,Your nick # is now,$nick is now known as) $newnick
    dec %i
  }
 ; You can precede HALTDEF with a semi-colon to compare this messages with the default
 haltdef
}

Compatibility[edit]

Added: mIRC v2.1a
Added on: 28 Feb 1995
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.


See Also[edit]

v · d · e mIRC on event list

A on Action, on Active, on Agent, on Appactive

B on Ban

C on Char, on Chat, on Chatclose, on Chatopen, on Close, on Connect, on Connectfail, on Ctcpreply

D on Dccserver, on Dehelp, on Deop, on Deowner, on Devoice, on Dialog, on Disconnect, on Dns

E on Error, on Exit

F on Filercvd, on Filesent

G on Getfail

H on Help, on Hotlink

I on Input, on Invite

J on Join

K on Keydown, on Keyup, on Kick

L on Load, on Logon

M on Midiend, on Mode, on Mp3end

N on Nick, on Nosound, on Notice, on Notify

O on Op, on Open, on Owner

P on Parseline, on Part, on Ping, on Playend, on Pong

Q on Queryclose, on Queryopen, on Quit

R on Rawmode

S on Sendfail, on Serv, on Servclose, on Servermode, on Serverop, on Servopen, on Signal, on Snotice,  on Sockclose, on Socklisten, on Sockopen, on Sockread, on Sockwrite, on Start

T on Text, on Topic

U on Udpread, on Udpwrite, on Unban, on Unload, on Unotify, on Usermode

V on Vcmd, on Voice

W on Wallops, on Waveend

Retrieved from "https://en.wikichip.org/w/index.php?title=mirc/on_events/on_nick&oldid=102241"