Diff: srand_from_pubnub_time.h

Revision:

2:4d49720c7200

diff -r 9fbec3606b08 -r 4d49720c7200 srand_from_pubnub_time.h
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/srand_from_pubnub_time.h	Fri Nov 11 22:46:57 2016 +0000
@@ -0,0 +1,25 @@
+#if !defined INC_SRAND_FROM_PUBNUB_TIME
+#define      INC_SRAND_FROM_PUBNUB_TIME
+
+
+#include "pubnub_api_types.h"
+
+
+/** This helper function will call the C standard srand() function with the seed
+    taken from the time returned from Pubnub's `time` operation (which can
+    be initiated with pubnub_time()).
+    
+    It's useful if you want a high-fidelity time used for srand() and on 
+    embedded system that don't have a Real-Time Clock.
+    
+    Keep in mind that this requires a round-trip to Pubnub, so it will take
+    some time, depending on your network, at least miliseconds. So, it's best
+    used only once, at the start of your program.
+    
+    @param pbp The Pubnub context to use to get time
+    @return 0: OK, -1: error (srand() was not called)
+*/
+int srand_from_pubnub_time(pubnub_t *pbp);
+
+
+#endif /* !defined INC_SRAND_FROM_PUBNUB_TIME */
\ No newline at end of file