View source for $ulist

Returns the Nth address in the Users list that matches the specified address and level.

 $ulist(nick!userid@address,L,N)

* Properties: info

You can specify a [[wildcard]] address or a * to match any address in the user list. If you don't specify a full address, it completes the address with wildcards. If you don't specify ''N'', the first matching address is returned.

If you specify ''L'', only matching addresses that contain the specified level are returned.

Using the 'info' property it will return the info-line for the matched userlist entry.

* Note: ''L'' and ''N'' are optional, but if you specify ''L'', you must specify ''N''.

== Example ==

The following example will loop through the userlist and print/echo each entry.

 [[var]] %x = 1
 [[While loops|while]] (%x < $ulist(*!*@*,0)) {
   [[echo]] -a * %x [[DollarPlus|$+]] ) Mask: $ulist(*!*@*,%x) Level: [[$level]]($ulist(*!*@*,%x)) Info: [[$iif]]($ulist(*!*@*,%x).info,[[$v1]],none)
   [[inc]] %x
 }

== See Also ==
* [[Access Levels]] for more information on mIRCs internal userlist.

[[Category:Userlist]]
[[Category:Remote Identifiers]]