Project

General

Profile

$ialchan » History » Revision 12

Revision 11 (Per Amundsen, 02/10/2023 06:36 AM) → Revision 12/13 (Per Amundsen, 02/23/2023 01:51 PM)

_Added in 1.9.0_ 

 *$ialchan(nick|mask,#,[N])* 

 Returns the Nth address on the specified channel matching nick or mask in the Internal Address List. 

 *Parameters* 

 table(ktable). 
 |*Parameter*|*Description*| 
 | nick<notextile>|</notextile>mask | nick|mask - Nick or mash to lookup. | 
 | <notextile>#</notextile> | - The channel to lookup on. | 
 | [N] | - If N = 0 number of addresses, otherwise the Nth address (default is 1). (optional) | 

 *Properties* 

 table(ktable). 
 |*Property*|*Description*| 
 | .pnick | - Returns the channelnick. (includes prefix) | 
 | .cnick | - Returns the nick in .@%+nick format. (Only the highest channel prefix is returned, *AdiIRC only*) | 
 | .nick | - Returns the nick. | 
 | .user | - Returns the ident. | 
 | .host | - Returns the hostname. | 
 | .addr | - Returns the address in ident@host format. | 
 | .mark | - The user [[/ialmark<notextile>|</notextile>mark]]. | [[/ialmark|mark]]. 
 | .gecos | - Returns the realname/fullname. | 
 | .account | - Returns the account name. ([[IRCv3]] feature) | 
 | .away | - Returns [[$true]] if the user is away, otherwise [[$false]]. | 
 | .bot | - Returns [[$true]] if the user is marked as a "IRCv3 bot":https://ircv3.net/specs/extensions/bot-mode, otherwise [[$false]]. | 

 *Example* 

 <pre> 
 ; Prints number of matches from 'nick' on '#channel'. 
 //echo -ag $ialchan(nick, #, 0) 

 ; Prints the first matc from 'nick' on '#channel'. 
 //echo -ag $ialchan(nick, #, 1) 
 </pre>