From e9b978c37675ffcecdae7975cf177222120c9c66 Mon Sep 17 00:00:00 2001
From: Yannick Warnier <yannick.warnier@beeznest.com>
Date: Fri, 24 Oct 2008 05:01:16 +0200
Subject: [PATCH] [svn r16614] Added api_get_session_name()

---
 main/inc/lib/main_api.lib.php | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/main/inc/lib/main_api.lib.php b/main/inc/lib/main_api.lib.php
index 04dc3e6df6..70a658b3f8 100644
--- a/main/inc/lib/main_api.lib.php
+++ b/main/inc/lib/main_api.lib.php
@@ -1147,7 +1147,29 @@ function api_get_session_id()
 		return (int) $_SESSION['id_session'];
 	}
 }
-
+/**
+ * Gets the current or given session name
+ * @param   int     Session ID (optional)
+ * @return  string  The session name, or null if unfound
+ */
+function api_get_session_name($session_id)
+{
+    if (empty($session_id))
+    {
+        $session_id = api_get_session_id();
+        if (empty($session_id)) {return null;}
+    }
+    $t = Database::get_main_table(TABLE_MAIN_SESSION);
+    $s = "SELECT name FROM $t WHERE id = ".(int)$session_id;
+    $r = api_sql_query($s,__FILE__,__LINE__);
+    $c = Database::num_rows($r);
+    if ($c > 0) {
+        //technically, there can be only one, but anyway we take the first
+        $rec = Database::fetch_array($r);
+        return $rec['name'];
+    }
+    return null;
+}
 /**
 * Returns the value of a setting from the web-adjustable admin config settings.
 *