$ulist » History » Version 4
Per Amundsen, 05/24/2018 10:13 AM
| 1 | 1 | Per Amundsen | _Added in 1.9.7_ |
|---|---|---|---|
| 2 | |||
| 3 | *$ulist(nick!userid@address,L,N)* |
||
| 4 | |||
| 5 | Returns the Nth address in the Users list that matches the specified address and level. |
||
| 6 | |||
| 7 | 4 | Per Amundsen | If you do not specify a full address, it completes the address with [[Scripting_Wildcards|wildcards]]. |
| 8 | 1 | Per Amundsen | If you do not specify N, the first matching address is returned. |
| 9 | If you specify L, only matching addresses that contain the specified level are returned. |
||
| 10 | |||
| 11 | L and N are optional, but if you specify L, you must specify N. |
||
| 12 | |||
| 13 | *Parameters* |
||
| 14 | |||
| 15 | nick!userid@address - Address to match. |
||
| 16 | L - Access level to match. |
||
| 17 | 2 | Per Amundsen | N - The Nth match. |
| 18 | 1 | Per Amundsen | |
| 19 | *Properties* |
||
| 20 | |||
| 21 | .info - Returns the information field of the matched address. |
||
| 22 | |||
| 23 | *Example* |
||
| 24 | |||
| 25 | <pre> |
||
| 26 | ; Lookup all addresss and print the number of matches. |
||
| 27 | 3 | Per Amundsen | //echo -ag $ulist(*,0) |
| 28 | 1 | Per Amundsen | |
| 29 | ; Lookup any address and print the first one. |
||
| 30 | 3 | Per Amundsen | //echo -ag $ulist(*,1) |
| 31 | 1 | Per Amundsen | </pre> |