Editing mirc/identifiers/$nick

{{mirc title|$nick Identifier}}The '''$nick''' identifier will return the nickname associated with a triggered event.

This identifier can also be used to retrieve information about nicknames on a certain channel.

== Synopsis ==
<pre>$nick[(#,N/nick,aohvr,aohvr)[.property]]</pre>

== Parameters ==
<span style="display: inline-block; width: 105px;">'''#'''</span>The channel name to look up nickname information.

<span style="display: inline-block; width: 105px;">'''N/nick'''</span>Can be either a number to look up a particular Nth user (if N is 0, returns total matching users based on criteria), or can be a nickname to target a specific user.

<span style="display: inline-block; width: 105px;">'''aohvr'''</span>Optional: The first '''aohvr''' characters target all users of a '''specific type''', while the second '''aohvr''' excludes a '''specific type''' from the target list.

=== Specific Types ===
{| class="wikitable" style="margin-left: 105px;"
|-
! Types !! Description
|-
| '''a''' || All users
|-
| '''o''' || Operators
|-
| '''h''' || Helpers
|-
| '''v''' || Voiced
|-
| '''r''' || Regular users
|}


== Properties ==
{| class="wikitable" style="margin-left: 105px;"
|-
! Type !! Description
|-
| <span style="margin-right: 15px;">'''pnick'''</span> || <span style="padding-left: 15px;">Display the target result with their elevation level, eg: @,+,%. Regular users display normal.</span>
|-
| <span style="margin-right: 15px;">'''idle'''</span> || <span style="padding-left: 15px;">Operators</span>
|}

== Examples ==
Echo to the active screen the total amount of users in the channel:
<source lang="mIRC">//echo -a Total users: $iif($active ischan,$nick(#,0))</source>

Echo to the active screen the number of operators in the channel:
<source lang="mIRC">//echo -a Total users: $iif($active ischan,$nick(#,0,o))</source>

Echo to the active screen all elevated users only, excluding regular users:
<source lang="mIRC">//echo -a Total users: $iif($active ischan,$nick(#,0,a,r))</source>

Create an alias that will open a [[Custom windows - mIRC|custom @window]], and detail the user list:
<source lang="mIRC">alias getUserDetails {

  ; Make sure the active window is a channel
  if ($active ischan) {

    ; Set the %c variable to the channel name
    var %c = $active
    window @getUserDetails 350 350 650 300

    ; Clear the window justin in case it
    ; was already opened previously
    clear @getUserDetails

    ; Echo all of the user details
    echo @getUserDetails Channel: %c
    echo @getUserDetails $crlf $crlf
    echo @getUserDetails Total Users: $nick(%c,0)
    echo @getUserDetails Operators: $nick(%c,0,o)
    echo @getUserDetails Voices: $nick(%c,0,v)
    echo @getUserDetails Helpers: $nick(%c,0,h)
    echo @getUserDetails Regular Users: $nick(%c,0,r)
    echo @getUserDetails $crlf $crlf

    ; Below lists elevated users, whom are the ops/voices/helpers
    echo @getUserDetails Total Elevated Users: $nick(%c,0,a,r)
    echo @getUserDetails $crlf $crlf

    ; Lastly, list the nickname of the first nickname in the
    ; op list, voice list, helper list, and regular user list
    echo @getUserDetails First operator/voice/helper/regular users:
    echo @getUserDetails $lf $iif($nick(%c,1,o),$v1,NONE)
    echo @getUserDetails $lf $iif($nick(%c,1,v),$v1,NONE)
    echo @getUserDetails $lf $iif($nick(%c,1,h),$v1,NONE)
    echo @getUserDetails $lf $iif($nick(%c,1,r),$v1,NONE)
  }
}</source>

The above command is executed in a channel command-line by typing:
<pre>/getUserDetails</pre>

The results from the above will look something like this:

[[File:$nick identifer example results - mIRC.png|Shows the example results.]]

== Compatibility ==
{{mIRC compatibility|2.1a}}

== See Also ==
* {{mIRC|$chan}}
* [[On events - mIRC|ON Events]]
{{mIRC identifier list}}

[[Category:MIRC identifiers]]
@@ Line 1: / Line 1: @@
-{{mirc title|$nick identifier}}'''$nick''' can be called in two ways:
+{{mirc title|$nick Identifier}}The '''$nick''' identifier will return the nickname associated with a triggered event.
-# '''$nick''' will return the nickname associated with an IRC event.
-# '''$nick(#channel,index)''' retrieves information about nicknames on a specific channel.
+This identifier can also be used to retrieve information about nicknames on a certain channel.
 == Synopsis ==
-<pre>$nick</pre>
+<pre>$nick[(#,N/nick,aohvr,aohvr)[.property]]</pre>
-<pre>$nick(#,N/nick,aohvr,aohvr)</pre>
 == Parameters ==
@@ Line 32: / Line 29: @@
 |}
-Except for Type 'a' which has been defined as all users in the channel, channel modes given to users and pnick characters can also be used as nick types. This includes networks where channel owner is given mode +q and pnick character ! or ~, and superop is given mode +a and pnick character &. This next table assumes channel is at a network supporting the additional channel modes given to nicks.
+== Properties ==
 {| class="wikitable" style="margin-left: 105px;"
 |-
-! Add'l Types !! Description
+! Type !! Description
-|-
-| '''q''' || Channel Owner having mode +q
-|-
-| '''~''' || Channel Owner having pnick character ~
 |-
-| '''&''' || SuperOp (a.k.aa Protected Op)  having pnick character &
+| <span style="margin-right: 15px;">'''pnick'''</span> || <span style="padding-left: 15px;">Display the target result with their elevation level, eg: @,+,%. Regular users display normal.</span>
 |-
-| '''@''' || Operators
+| <span style="margin-right: 15px;">'''idle'''</span> || <span style="padding-left: 15px;">Operators</span>
-|-
-| '''%''' || Helpers
-|-
-| '''+''' || Voiced
 |}
-== Properties ==
-* '''.pnick''' - Returns the target result with their elevation level, eg: @,+,%. Regular users display normal.
-* '''.idle''' - Returns the current idle time for the nickname on the channel specified
-* '''.color''' - Returns the color for that user as set up in the Nick color dialog
 == Examples ==
@@ Line 111: / Line 94: @@
 [[File:$nick identifer example results - mIRC.png|Shows the example results.]]
-'''Note:''' A nick can have several channel modes, and the nicklist will display only the highest level. To have an exact count of the nicks displaying a certain nick type, you should have the 3rd parameter be the list of all types of that level and greater, then have the 4th parameter be the nick types greater than the specified level. For example, networks supporting levels above @Operator also give +o. ~ChannelOwner is given modes +qo and &ProtectedOp is given mode +ao. Some networks allow the Founder to give +q to several other users, so the ~ prefix isn't always an indication that someone is the channel owner/founder.
-<pre>//echo -a There are $nick($chan,0,~&o,~&) nicks at the @operator level excluding Owners and SuperOps</pre>
 == Compatibility ==
 {{mIRC compatibility|2.1a}}
-== See also ==
+== See Also ==
 * {{mIRC|$chan}}
-* {{mIRC|on events}}
+* [[On events - mIRC|ON Events]]
 {{mIRC identifier list}}
-[[Category:mIRC identifiers|nick]]
+[[Category:MIRC identifiers]]