Project

General

Profile

$ial » History » Version 12

Per Amundsen, 02/10/2023 06:36 AM

1 1 Per Amundsen
_Added in 1.9.0_
2
3
*$ial*
4
5
Returns [[$true]] if Internal Address List is enabled, otherwise [[$false]].
6
7
_Always returns [[$true]] in AdiIRC._
8
9
-----------------------------------------------------------------------------
10
11
_Added in 1.9.0_
12
13
*$ial(nick/mask,[N])*
14
15
Returns the Nth address matching mask in the Internal Address List.
16
17
*Parameters*
18
19 9 Per Amundsen
nick/mask - Nick or mask to lookup. (can be a [[Scripting_Wildcards|wildcard]])
20 1 Per Amundsen
[N] - If N = 0, number of lookup matches, otherwise the Nth match. (optional, default i 1)
21
22
*Properties*
23
24
.nick - The user nick.
25
.user - The user ident.
26
.host - The user hostname.
27
.addr - The user ident@hostname.
28
.mark - The user [[/ialmark|mark]].
29 7 Per Amundsen
.gecos - The user realname/fullname.
30 5 Per Amundsen
.name - The user realname/fullname.
31 3 Per Amundsen
.realname - The user realname/fullname. (AdiIRC only)
32 6 Per Amundsen
.account - The user account name. ([[IRCv3]] feature)
33 10 Per Amundsen
.isaway - Returns [[$true]] if the user is away, otherwise [[$false]]. *(AdiIRC only)*
34 4 Per Amundsen
.away - Returns [[$true]] if the user is away, otherwise [[$false]].
35 12 Per Amundsen
.bot - Returns [[$true]] if the user is marked as a "IRCv3 bot":https://ircv3.net/specs/extensions/bot-mode, otherwise [[$false]].
36 8 Per Amundsen
.id - Returns a unique id for this user.
37 11 Per Amundsen
-bot - TODO
38 1 Per Amundsen
39
*Example*
40
41
<pre>
42
; Print the address 'ident!nick@hostname' for 'nick'.
43
//echo -ag $ial(nick)
44
45
; Print the number of matches for wildcard search 'nick*'.
46
//echo -ag $ial(nick*, 0)
47
48
; Print the realname for second match using wildcard search 'nick*'.
49
//echo -ag $ial(nick*, 2).realname
50
</pre>