# $username

Returns the username of the specified user

Syntax

    $username(<nickname>)

Description

Returns the username of the specified irc user IF it is known.
The username is known if $isWellKnown returns 1.
The username is generally known if the user is on a channel with you or has an open query with you.
Detailed explaination:
KVirc has an internal database of users that are currently visible by *this client*: this includes users on open channels and queries.
The other IRC users are NOT in the database: this means that KVIrc knows NOTHING about them and can't return any information immediately. In this case this function will return an EMPTY string.
If an user is in the database then at least his nickname is known.
The username and hostname is known only if the server provides this information spontaneously or after a KVIrc request.
KVIrc requests user informations for all the users in open queries and channels. These informations take some time to be received: in this interval of time KVIrc knows only the user's nickname. This function will return the string "*" in this case.

See also
$iswellknown, [$fnc]$hostname[/fnc], awhois

Main index, Function index

KVirc 3.0.0 documentation
Generated by root at Thu Apr 29 12:41:05 2004