Add plugin get_barejid_from_roster function

2 files changed, 15 insertions, 0 deletions

diff --git a/apidocs/c/profapi.h b/apidocs/c/profapi.h
index a8c8673c..04da8a4e 100644
--- a/apidocs/c/profapi.h
+++ b/apidocs/c/profapi.h
@@ -145,6 +145,12 @@ Retrieve the nickname for a given barejid if it is in the roster.
 char* prof_get_name_from_roster(const char *barejid);
 
 /**
+Retrieve the barejid for a given nickname if it is in the roster.
+@return the users barejid e.g. "eddie@server.tld", or NULLL if the nickname is not in the roster.
+*/
+char* prof_get_barejid_from_roster(const char *name);
+
+/**
 Retrieve nicknames of all occupants in a chat room, when in a chat room window.
 @return nicknames of all occupants in the current room or an empty list if not in a chat room window.
 */
diff --git a/apidocs/python/src/prof.py b/apidocs/python/src/prof.py
index 7ee282a9..eafaeeb7 100644
--- a/apidocs/python/src/prof.py
+++ b/apidocs/python/src/prof.py
@@ -262,6 +262,15 @@ def get_name_from_roster(barejid):
     pass
 
 
+def get_barejid_from_roster(name):
+    """Retrieve the barejid for a given nickname if it is in the roster.
+
+    :return: the users barejid e.g. "eddie@server.tld", or ``None`` if the nickname is not in the roster.
+    :rtype: str
+    """
+    pass
+
+
 def get_current_occupants(): 
     """Retrieve nicknames of all occupants in a chat room, when in a chat room window.