Function for retreiving a list of friend numbers

This should allow clients to sync the Tox friend list with their UI/etc.
lists.

1 files changed, 8 insertions, 0 deletions

diff --git a/toxcore/tox.h b/toxcore/tox.h
index b17ca36f..bd13b998 100644
--- a/toxcore/tox.h
+++ b/toxcore/tox.h
@@ -221,6 +221,14 @@ TOX_USERSTATUS tox_get_selfuserstatus(Tox *tox);
  */
 void tox_set_sends_receipts(Tox *tox, int friendnumber, int yesno);
 
+/* Allocate and return a list of valid friend id's. List must be freed by the
+ * caller.
+ *
+ * retun 0 if success.
+ * return -1 if failure.
+ */
+int tox_get_friendlist(void *tox, int **out_list, uint32_t *out_list_length);
+
 /* Set the function that will be executed when a friend request is received.
  *  Function format is function(uint8_t * public_key, uint8_t * data, uint16_t length)
  */