Difference between revisions of "$ulist"

From Scriptwiki
Jump to: navigation, search
 
Line 5: Line 5:
 
* Properties: info
 
* Properties: info
  
You can specify a [[Wildcards|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.
+
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.
 
If you specify ''L'', only matching addresses that contain the specified level are returned.

Revision as of 21:34, 24 November 2005

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 (%x < $ulist(*!*@*,0)) {
  echo -a * %x $+ ) Mask: $ulist(*!*@*,%x) Level: $level($ulist(*!*@*,%x)) Info: $iif($ulist(*!*@*,%x).info,$v1,none)
  inc %x
}

See Also

For more information on mIRCs internal userlist, see Access Levels