From 0a6b8dcd73d6a51f0b7534d495e684811e44ecff Mon Sep 17 00:00:00 2001
From: Tyge Løvset <60263450+tylov@users.noreply.github.com>
Date: Fri, 1 Jan 2021 00:29:40 +0100
Subject: Update cmap_api.md

---
 docs/cmap_api.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

(limited to 'docs')

diff --git a/docs/cmap_api.md b/docs/cmap_api.md
index 00c097cb..edbd90cf 100644
--- a/docs/cmap_api.md
+++ b/docs/cmap_api.md
@@ -137,8 +137,8 @@ int main()
     }
 
     // Add two new entries to the unordered map
-    cmap_str_put(&u, "BLACK", "#000000");
-    cmap_str_put(&u, "WHITE", "#FFFFFF");
+    cmap_str_emplace(&u, "BLACK", "#000000");
+    cmap_str_emplace(&u, "WHITE", "#FFFFFF");
 
     // Output values by key
     printf("The HEX of color RED is:[%s]\n", cmap_str_at(&u, "RED")->str);
@@ -175,7 +175,9 @@ int main()
         {110, cstr_from("Blue")},
         {120, cstr_from_fmt("#%08x", col)},
     });
-    cmap_id_put(&idnames, 80, cstr_from("White"));
+    
+    /* put replaces existing mapped value (unlike emplace and insert): */
+    cmap_id_put(&idnames, 110, cstr_from("White"));
 
     c_foreach (i, cmap_id, idnames)
         printf("%d: %s\n", i.ref->first, i.ref->second.str);
@@ -186,8 +188,7 @@ int main()
 ```
 Output:
 ```c
-80: White
 100: Red
-110: Blue
+110: White
 120: #cc7744ff
-```
\ No newline at end of file
+```
-- 
cgit v1.2.3


From 38b161aa8e14a2b19aaa8c840fd6292b01e2a7ea Mon Sep 17 00:00:00 2001
From: Tyge Løvset <60263450+tylov@users.noreply.github.com>
Date: Fri, 1 Jan 2021 00:47:53 +0100
Subject: Update cmap_api.md

---
 docs/cmap_api.md | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

(limited to 'docs')

diff --git a/docs/cmap_api.md b/docs/cmap_api.md
index edbd90cf..85569e63 100644
--- a/docs/cmap_api.md
+++ b/docs/cmap_api.md
@@ -158,26 +158,28 @@ The HEX of color BLACK is:[#000000]
 ```
 
 ### Example 2
-For illustration, this example uses a cmap with cstr_t as mapped value, instead of `using_cmap_strval(id, int)` macro.
-We must therefore pass new constructed cstr_t objects to the map when inserting, instead of `const char*` strings.
+This example uses a cmap with cstr_t as mapped value, by the `using_cmap_strval(id, int)` macro.
 ```c
 #include "stc/cstr.h"
 #include "stc/cmap.h"
 
-using_cmap(id, int, cstr_t, cstr_del);
+/* cmap<int, cstr>: */
+using_cmap_strval(id, int);
 
 int main()
 {
     uint32_t col = 0xcc7744ff;
     cmap_id idnames = cmap_inits;
     c_push_items(&idnames, cmap_id, {
-        {100, cstr_from("Red")},
-        {110, cstr_from("Blue")},
-        {120, cstr_from_fmt("#%08x", col)},
+        {100, "Red"},
+        {110, "Blue"},
     });
-    
-    /* put replaces existing mapped value (unlike emplace and insert): */
-    cmap_id_put(&idnames, 110, cstr_from("White"));
+    /* put replaces existing mapped value: */
+    cmap_id_put(&idnames, 110, "White");
+    /* put a constructed mapped value into map: */
+    cmap_id_put_mapped(&idnames, 120, cstr_from_fmt("#%08x", col));
+    /* emplace inserts only when key does not exist: */
+    cmap_id_emplace(&idnames, 100, "Green");
 
     c_foreach (i, cmap_id, idnames)
         printf("%d: %s\n", i.ref->first, i.ref->second.str);
-- 
cgit v1.2.3