added $realname function

git-svn-id: https://svn.kvirc.de/svn/trunk/kvirc@3554 17fca916-40b9-46aa-a4ea-0a15b648b75c

4 files changed, 62 insertions, 1 deletions

diff --git a/src/kvirc/kvs/kvi_kvs_corefunctions.cpp b/src/kvirc/kvs/kvi_kvs_corefunctions.cpp
index 526a457e8..0e20980bb 100644
--- a/src/kvirc/kvs/kvi_kvs_corefunctions.cpp
+++ b/src/kvirc/kvs/kvi_kvs_corefunctions.cpp
@@ -106,6 +106,7 @@ namespace KviKvsCoreFunctions
 		_REGFNC("r",r)
 		_REGFNC("rand",rand)
 		_REGFNC("real",real)
+		_REGFNC("realname",realname)
 		_REGFNC("receivedBytes",receivedBytes)
 		_REGFNC("rsort",rsort)
 		// s_z
diff --git a/src/kvirc/kvs/kvi_kvs_corefunctions.h b/src/kvirc/kvs/kvi_kvs_corefunctions.h
index ffb16b8b4..c864fffc4 100644
--- a/src/kvirc/kvs/kvi_kvs_corefunctions.h
+++ b/src/kvirc/kvs/kvi_kvs_corefunctions.h
@@ -115,6 +115,7 @@ namespace KviKvsCoreFunctions
 	KVSCF(r);
 	KVSCF(rand);
 	KVSCF(real);
+	KVSCF(realname);
 	KVSCF(receivedBytes);
 	KVSCF(rsort);
 	// s_z
diff --git a/src/kvirc/kvs/kvi_kvs_corefunctions_mr.cpp b/src/kvirc/kvs/kvi_kvs_corefunctions_mr.cpp
index 5d6a2f3af..e70299383 100644
--- a/src/kvirc/kvs/kvi_kvs_corefunctions_mr.cpp
+++ b/src/kvirc/kvs/kvi_kvs_corefunctions_mr.cpp
@@ -631,6 +631,65 @@ namespace KviKvsCoreFunctions
 	}
 
 	/*
+		@doc: realname
+		@type:
+			function
+		@title:
+			$realname
+		@short:
+			Returns the realname of the specified user
+		@syntax:
+			<string> $realname(<nickname:string>)
+		@description:
+			Returns the realname of the specified IRC user IF it is known.[br]
+			The realname is known if [fnc]$isWellKnown[/fnc] returns 1.[br]
+			The realname is generally known if the user is on a channel with you
+			or has an open query with you.[br]
+			Detailed explaination:[br]
+			KVIrc has an internal database of users that are currently
+			visible by *this client*: this includes users on open channels
+			and queries.[br] 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.[br]
+			If a user is in the database, at least his nickname is known.[br]
+			The username and hostname are known only if the server provides that information
+			spontaneously or after a KVIrc request.[br]
+			KVIrc requests user information for all the users in open queries
+			and channels. This information takes some time to be retrieved,
+			in this interval of time KVIrc knows only the user's nickname.
+			This function will return the string "*" in this case.[br]
+		@seealso:
+			[fnc]$isWellKnown[/fnc], [fnc]$hostname[/fnc], [fnc]$username[/fnc], [cmd]awhois[/cmd]
+	*/
+
+	KVSCF(realname)
+	{
+		QString szNick;
+
+		KVSCF_PARAMETERS_BEGIN
+			KVSCF_PARAMETER("nick",KVS_PT_NONEMPTYSTRING,0,szNick)
+		KVSCF_PARAMETERS_END
+
+		if(KVSCF_pContext->window()->console())
+		{
+			if(KVSCF_pContext->window()->console()->isConnected())
+			{
+				KviIrcUserEntry * e = KVSCF_pContext->window()->connection()->userDataBase()->find(szNick);
+				if(e)
+				{
+					KVSCF_pRetBuffer->setString(e->realName());
+					return true;
+				}
+			}
+		}
+
+		KVSCF_pRetBuffer->setNothing();
+		return true;
+	}
+
+
+	/*
 		@doc: receivedBytes
 		@type:
 			function
diff --git a/src/kvirc/kvs/kvi_kvs_corefunctions_sz.cpp b/src/kvirc/kvs/kvi_kvs_corefunctions_sz.cpp
index e0827da1f..987fe464f 100644
--- a/src/kvirc/kvs/kvi_kvs_corefunctions_sz.cpp
+++ b/src/kvirc/kvs/kvi_kvs_corefunctions_sz.cpp
@@ -977,7 +977,7 @@ namespace KviKvsCoreFunctions
 			in this interval of time KVIrc knows only the user's nickname.
 			This function will return the string "*" in this case.[br]
 		@seealso:
-			[fnc]$isWellKnown[/fnc], [$fnc]$hostname[/fnc], [cmd]awhois[/cmd]
+			[fnc]$isWellKnown[/fnc], [fnc]$hostname[/fnc], [fnc]$realname[/fnc], [cmd]awhois[/cmd]
 	*/
 
 	KVSCF(username)