initial version of tox_loop

1 files changed, 36 insertions, 0 deletions

diff --git a/toxcore/tox.h b/toxcore/tox.h
index 75757b6f..0be019cd 100644
--- a/toxcore/tox.h
+++ b/toxcore/tox.h
@@ -990,6 +990,42 @@ uint32_t tox_iteration_interval(const Tox *tox);
  */
 void tox_iterate(Tox *tox, void *user_data);
 
+/**
+ * Run tox_iterate() any time a packet arrives, only returns after tox_loop_stop().
+ */
+uint32_t tox_loop(Tox *tox, void *user_data);
+
+/**
+ * Tell tox_loop() to return.
+ */
+void tox_loop_stop(Tox *tox);
+
+/**
+ * No extra parameters.
+ */
+typedef void tox_loop_begin_cb(Tox *tox, void *user_data);
+
+
+/**
+ * Set the callback for the `loop_begin` event. Pass NULL to unset.
+ *
+ * Callback ran when tox_loop() calls into tox_iterate(), the client can lock a mutex here.
+ */
+void tox_callback_loop_begin(Tox *tox, tox_loop_begin_cb *callback);
+
+/**
+ * No extra parameters.
+ */
+typedef void tox_loop_end_cb(Tox *tox, void *user_data);
+
+
+/**
+ * Set the callback for the `loop_end` event. Pass NULL to unset.
+ *
+ * Callback ran when tox_loop() is finished with tox_iterate(), the client can unlock the mutex here.
+ */
+void tox_callback_loop_end(Tox *tox, tox_loop_end_cb *callback);
+
 
 /*******************************************************************************
  *