$ulist » History » Version 5
Per Amundsen, 02/23/2023 07:53 PM
| 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 | 5 | Per Amundsen | table(ktable). |
| 16 | |*Parameter*|*Description*| |
||
| 17 | | nick!userid@address | Address to match. | |
||
| 18 | | L | Access level to match. | |
||
| 19 | | N | The Nth match. | |
||
| 20 | 1 | Per Amundsen | |
| 21 | *Properties* |
||
| 22 | |||
| 23 | 5 | Per Amundsen | table(ktable). |
| 24 | |*Property*|*Description*| |
||
| 25 | | .info | Returns the information field of the matched address. | |
||
| 26 | 1 | Per Amundsen | |
| 27 | *Example* |
||
| 28 | |||
| 29 | <pre> |
||
| 30 | ; Lookup all addresss and print the number of matches. |
||
| 31 | 3 | Per Amundsen | //echo -ag $ulist(*,0) |
| 32 | 1 | Per Amundsen | |
| 33 | ; Lookup any address and print the first one. |
||
| 34 | 3 | Per Amundsen | //echo -ag $ulist(*,1) |
| 35 | 1 | Per Amundsen | </pre> |