1 files changed, 56 insertions, 0 deletions
diff --git a/misc/examples/arc_demo.c b/misc/examples/arc_demo.c
new file mode 100644
index 00000000..087f90ac
--- /dev/null
+++ b/misc/examples/arc_demo.c
@@ -0,0 +1,56 @@
+#include <stdio.h>
+#include <string.h>
+
+void int_drop(int* x) {
+    printf("drop: %d\n", *x);
+}
+
+// carc implements its own clone method using reference counting,
+// so 'i_valclone' is not required to be defined (ignored).
+
+#define i_type Arc          // set type name to be defined (instead of 'carc_int')
+#define i_val int
+#define i_valdrop int_drop  // optional, just to display the elements destroyed
+#include <stc/carc.h>       // Arc
+
+#define i_keyboxed Arc    // note: use i_keyboxed instead of i_key for carc/cbox elements
+#include <stc/csset.h>      // csset_Arc (like: std::set<std::shared_ptr<int>>)
+
+#define i_valboxed Arc    // note: as above.
+#include <stc/cvec.h>       // cvec_Arc (like: std::vector<std::shared_ptr<int>>)
+
+int main()
+{
+    c_auto (cvec_Arc, vec)   // declare and init vec, call cvec_Arc_drop() at scope exit
+    c_auto (csset_Arc, set)  // declare and init set, call csset_Arc_drop() at scope exit
+    {
+        const int years[] = {2021, 2012, 2022, 2015};
+        c_forrange (i, c_arraylen(years))
+            cvec_Arc_push(&vec, Arc_from(years[i]));
+
+        printf("vec:");
+        c_foreach (i, cvec_Arc, vec) printf(" %d", *i.ref->get);
+        puts("");
+
+        // add odd numbers from vec to set
+        c_foreach (i, cvec_Arc, vec)
+            if (*i.ref->get & 1)
+                csset_Arc_insert(&set, Arc_clone(*i.ref)); // copy shared pointer => increments counter.
+
+        // erase the two last elements in vec
+        cvec_Arc_pop_back(&vec);
+        cvec_Arc_pop_back(&vec);
+
+        printf("vec:");
+        c_foreach (i, cvec_Arc, vec) printf(" %d", *i.ref->get);
+
+        printf("\nset:");
+        c_foreach (i, csset_Arc, set) printf(" %d", *i.ref->get);
+
+        c_with (Arc p = Arc_clone(vec.data[0]), Arc_drop(&p)) {
+            printf("\n%d is now owned by %ld objects\n", *p.get, *p.use_count);
+        }
+
+        puts("\nDone");
+    }
+}