Project

General

Profile

$ial » History » Version 14

Per Amundsen, 02/23/2023 01:46 PM

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 13 Per Amundsen
table(ktable).
20
|*Parameter*|*Description*|
21
| nick/mask | Nick or mask to lookup. (can be a [[Scripting_Wildcards<notextile>|</notextile>wildcard]]) |
22
| [N] | If N = 0, number of lookup matches, otherwise the Nth match. (optional, default i 1) |
23 1 Per Amundsen
24
*Properties*
25
26 13 Per Amundsen
table(ktable).
27
|*Property*|*Description*|
28
| .nick | The user nick. |
29
| .user | The user ident. |
30
| .host | The user hostname. |
31
| .addr | The user ident@hostname. |
32
| .mark | The user [[/ialmark<notextile>|</notextile>mark]]. |
33
| .gecos | The user realname/fullname. |
34
| .name | The user realname/fullname. |
35 14 Per Amundsen
| .realname | The user realname/fullname. *(AdiIRC only)* |
36 13 Per Amundsen
| .account | The user account name. ([[IRCv3]] feature) |
37
| .isaway | Returns [[$true]] if the user is away, otherwise [[$false]]. *(AdiIRC only)* |
38
| .away | Returns [[$true]] if the user is away, otherwise [[$false]]. |
39
| .bot | Returns [[$true]] if the user is marked as a "IRCv3 bot":https://ircv3.net/specs/extensions/bot-mode, otherwise [[$false]]. |
40
| .id | Returns a unique id for this user. |
41
| | bot - TODO |
42 1 Per Amundsen
43
*Example*
44
45
<pre>
46
; Print the address 'ident!nick@hostname' for 'nick'.
47
//echo -ag $ial(nick)
48
49
; Print the number of matches for wildcard search 'nick*'.
50
//echo -ag $ial(nick*, 0)
51
52
; Print the realname for second match using wildcard search 'nick*'.
53
//echo -ag $ial(nick*, 2).realname
54
</pre>