$nick (nick) - Revision history

Albie: added wiki links and removed a some what pointless see also link.

2010-10-31T14:46:04Z

added wiki links and removed a some what pointless see also link.

← Older revision		Revision as of 14:46, 31 October 2010
Line 27:		Line 27:
	[[while_loops\|while]] (%i <= $nick(#help.script, 0)) {		[[while_loops\|while]] (%i <= $nick(#help.script, 0)) {
	[[echo]] -a $nick(#help.script, %i).pnick has been idle for [[$duration]]($nick(#help.script, %i).idle)		[[echo]] -a $nick(#help.script, %i).pnick has been idle for [[$duration]]($nick(#help.script, %i).idle)
	inc %i		[[inc]] %i
	}		}

Line 40:		Line 40:
	alias idletest {		alias idletest {
	var %i = 1, %idle = 0, %nick		var %i = 1, %idle = 0, %nick
	~~[[while_loops\|~~while]] (%i <= $nick(#, 0)) {		while (%i <= $nick(#, 0)) {
	[[if]] ($nick(#, %i).idle > %idle) {		[[if]] ($nick(#, %i).idle > %idle) {
	%idle = $nick(#, %i).idle		%idle = $nick(#, %i).idle
Line 59:		Line 59:

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

	[[Category:Nick and Address Identifiers]]		[[Category:Nick and Address Identifiers]]

Albie: 'idled' examples changed to idle.

2010-10-31T14:38:25Z

'idled' examples changed to idle.

← Older revision		Revision as of 14:38, 31 October 2010
Line 32:		Line 32:
	The example above returns all nicks on the channel with their prefixes and idle time.		The example above returns all nicks on the channel with their prefixes and idle time.
	The output could e.g. be:		The output could e.g. be:
	@BlackShroud has been ~~idled~~ for 17hrs 30mins 28secs		@BlackShroud has been idle for 17hrs 30mins 28secs
	@Dana has been ~~idled~~ for 14hrs 24mins 9secs		@Dana has been idle for 14hrs 24mins 9secs
	@epicaL has been ~~idled~~ for 2days 7hrs 49secs		@epicaL has been idle for 2days 7hrs 49secs
	@Microbe has been ~~idled~~ for 6hrs 19mins 45secs		@Microbe has been idle for 6hrs 19mins 45secs

	To get longest idle time on channel:		To get longest idle time on channel:

Albie: added note about idle time

2010-10-31T14:31:54Z

added note about idle time

← Older revision		Revision as of 14:31, 31 October 2010
Line 40:		Line 40:
	alias idletest {		alias idletest {
	var %i = 1, %idle = 0, %nick		var %i = 1, %idle = 0, %nick
	[[while_loops\|while]] (%i <= $nick(#, 0)) {		[[while_loops\|while]] (%i <= $nick(#, 0)) {
	[[if]] ($nick(#, %i).idle > %idle) {		[[if]] ($nick(#, %i).idle > %idle) {
	%idle = $nick(#, %i).idle		%idle = $nick(#, %i).idle
	%nick = $nick(#, %i)		%nick = $nick(#, %i)
	}		}
	[[inc]] %i		[[inc]] %i
	}		}
	[[msg]] $chan %nick has the longest idle on $chan that is $duration(%idle)		[[msg]] $chan %nick has the longest idle time on $chan that is $duration(%idle)
	}		}

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

	== See Also ==		== Note ==
			The ''idle'' property only holds information that your client has seen.
			If a user has been idle since you've joined that channel the users idle time will be the length you've been in the channel.

			Therefore the ''idle'' property will not match the idle time a server returns in [[Raw 317]] as that is a clients idle time, not a user on a said channel.

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

	[[Category:Nick and Address Identifiers]]		[[Category:Nick and Address Identifiers]]

Albie: has been idled -> has been idle and changed an example to use the full channel name instead of just #

2010-10-31T14:18:14Z

has been idled -> has been idle and changed an example to use the full channel name instead of just #

← Older revision		Revision as of 14:18, 31 October 2010
Line 25:		Line 25:

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

Zyberdog: added an example with .idle, fixed a typo

2005-11-24T19:06:23Z

added an example with .idle, fixed a typo

← Older revision		Revision as of 19:06, 24 November 2005
Line 8:		Line 8:
	a = all nicks, o = ops, h = halfops, v = voiced, r = regular		a = all nicks, o = ops, h = halfops, v = voiced, r = regular

	~~Parameter~~ $nick takes ''color'', ''pnick'', ''idle'' as possible ~~parameters~~.		The identifier $nick takes ''color'', ''pnick'', ''idle'' as possible properties.

	'''color''' returns the color of nick in nicklist specified in mIRC's options.		'''color''' returns the color of nick in nicklist specified in mIRC's options.
Line 22:		Line 22:
	$nick(#foo, 0, r) ;returns the number of regular people on #foo		$nick(#foo, 0, r) ;returns the number of regular people on #foo
	$nick(#foo, 0, a, ov) ;returns the total number of nicks on channel #foo excluded ops and voices.		$nick(#foo, 0, a, ov) ;returns the total number of nicks on channel #foo excluded ops and voices.
			$nick(#foo, Dana).idle ;returns the idletime (on channel) in seconds for the nickname Dana on #foo

	[[var]] %i = 1		[[var]] %i = 1

Zyberdog: tweaked

2005-11-21T22:00:05Z

tweaked

← Older revision		Revision as of 22:00, 21 November 2005
Line 17:		Line 17:
	== Examples ==		== Examples ==

	$nick(#foo, 0) returns the the total number of nicknames on #foo		$nick(#foo, 0) ;returns the the total number of nicknames on #foo
	$nick(#foo, 1) returns the 1st nickname on #foo		$nick(#foo, 1) ;returns the 1st nickname on #foo
	$nick(#foo, 1, v) returns the 1st voice 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.		$nick(#foo, 0, r) ;returns the number of regular people on #foo
			$nick(#foo, 0, a, ov) ;returns the total number of nicks on channel #foo excluded ops and voices.

	[[var]] %i = 1		[[var]] %i = 1
Line 28:		Line 29:
	}		}

	~~Returns~~ all nicks on channel with their prefixes and idle time.		The example above returns all nicks on the channel with their prefixes and idle time.
	Ex:		The output could e.g. be:
	@BlackShroud has been idled for 17hrs 30mins 28secs		@BlackShroud has been idled for 17hrs 30mins 28secs
	@Dana has been idled for 14hrs 24mins 9secs		@Dana has been idled for 14hrs 24mins 9secs
Line 48:		Line 49:
	}		}

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

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

	[[Category:Nick and Address Identifiers]]		[[Category:Nick and Address Identifiers]]

Tovrleaf at 07:19, 28 October 2005

2005-10-28T07:19:26Z

New page

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