From 600cbb659ab695039d830ae7bfd2852c2e9cd0a0 Mon Sep 17 00:00:00 2001
From: Ivan Kozlovic <ivan@synadia.com>
Date: Thu, 4 Nov 2021 11:22:01 -0600
Subject: [PATCH] Added the C client

Signed-off-by: Ivan Kozlovic <ivan@synadia.com>
---
 developing-with-nats/reconnect/wait.md | 54 ++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/developing-with-nats/reconnect/wait.md b/developing-with-nats/reconnect/wait.md
index d878228e9..4ae6beb02 100644
--- a/developing-with-nats/reconnect/wait.md
+++ b/developing-with-nats/reconnect/wait.md
@@ -114,6 +114,27 @@ defer nc.Close()
 // Do something with the connection
 ```
 {% endtab %}
+
+{% tab title="C" %}
+```c
+natsConnection      *conn      = NULL;
+natsOptions         *opts      = NULL;
+natsStatus          s          = NATS_OK;
+
+s = natsOptions_Create(&opts);
+// Set some jitter to add to the reconnect wait duration: up to 500 milliseconds for non TLS connections and up to 2 seconds for TLS connections.
+if (s == NATS_OK)
+    s = natsOptions_SetReconnectJitter(opts, 500, 2000);
+if (s == NATS_OK)
+    s = natsConnection_Connect(&conn, opts);
+
+(...)
+
+// Destroy objects that were created
+natsConnection_Destroy(conn);
+natsOptions_Destroy(opts);
+```
+{% endtab %}
 {% endtabs %}
 
 You can also instead specify a custom reconnect delay callback that will be invoked by the library when the whole list of servers has been tried unsuccesfully. The library will wait for the duration returned by this callback.
@@ -134,4 +155,37 @@ defer nc.Close()
 // Do something with the connection
 ```
 {% endtab %}
+
+{% tab title="C" %}
+```c
+static int64_t
+_crd(natsConnection *nc, int attempts, void *closure)
+{
+    // Need to return how long library should wait.
+    // For example, let's wait the number of current attempts
+    // mutiplied by 1 second (1000 milliseconds):
+    return (int64_t) (attempts * 1000);
+}
+
+(...)
+
+natsConnection      *conn      = NULL;
+natsOptions         *opts      = NULL;
+natsStatus          s          = NATS_OK;
+
+s = natsOptions_Create(&opts);
+// Set a custom callback that returns some backoff duration. The library passes the number of attempts
+// of the whole list of server URLs, which can be useful to determine a specific delay.
+if (s == NATS_OK)
+    s = natsOptions_SetCustomReconnectDelay(opts, _crd, NULL);
+if (s == NATS_OK)
+    s = natsConnection_Connect(&conn, opts);
+
+(...)
+
+// Destroy objects that were created
+natsConnection_Destroy(conn);
+natsOptions_Destroy(opts);
+```
+{% endtab %}
 {% endtabs %}