summaryrefslogtreecommitdiffhomepage
path: root/docs
diff options
context:
space:
mode:
authorTyge Løvset <[email protected]>2022-04-22 12:20:31 +0200
committerTyge Løvset <[email protected]>2022-04-22 12:20:31 +0200
commit8f57f3d331de4cb4aa7d06862c2de3424eb1ba5b (patch)
tree1a730578475e4d6e260948578cd0c2a5fd4463f4 /docs
parent182099800f230f876fb46dac9f1f49a4fe3c3981 (diff)
downloadSTC-modified-8f57f3d331de4cb4aa7d06862c2de3424eb1ba5b.tar.gz
STC-modified-8f57f3d331de4cb4aa7d06862c2de3424eb1ba5b.zip
Readded push()/emplace() to all containers missing them. Made _hash function required for i_key_bind, _eq is derived from _cmp.
Diffstat (limited to 'docs')
-rw-r--r--docs/cdeq_api.md2
-rw-r--r--docs/cmap_api.md18
-rw-r--r--docs/cset_api.md1
-rw-r--r--docs/csmap_api.md3
-rw-r--r--docs/csset_api.md1
5 files changed, 15 insertions, 10 deletions
diff --git a/docs/cdeq_api.md b/docs/cdeq_api.md
index 3cd4fece..aa528aa2 100644
--- a/docs/cdeq_api.md
+++ b/docs/cdeq_api.md
@@ -51,7 +51,9 @@ cdeq_X_value* cdeq_X_emplace_front(cdeq_X* self, i_valraw raw);
void cdeq_X_pop_front(cdeq_X* self);
cdeq_X_value* cdeq_X_push_back(cdeq_X* self, i_val value);
+cdeq_X_value* cdeq_X_push(cdeq_X* self, i_val value); // alias for push_back()
cdeq_X_value* cdeq_X_emplace_back(cdeq_X* self, i_valraw raw);
+cdeq_X_value* cdeq_X_emplace(cdeq_X* self, i_valraw raw); // alias for emplace_back()
void cdeq_X_pop_back(cdeq_X* self);
cdeq_X_iter cdeq_X_insert(cdeq_X* self, size_t idx, i_val value); // move value
diff --git a/docs/cmap_api.md b/docs/cmap_api.md
index 69257779..645b0bd0 100644
--- a/docs/cmap_api.md
+++ b/docs/cmap_api.md
@@ -67,11 +67,10 @@ cmap_X_iter cmap_X_find(const cmap_X* self, i_keyraw rkey);
cmap_X_result cmap_X_insert(cmap_X* self, i_key key, i_val mapped); // no change if key in map
cmap_X_result cmap_X_insert_or_assign(cmap_X* self, i_key key, i_val mapped); // always update mapped
-cmap_X_result cmap_X_put(cmap_X* self, i_key key, i_val mapped); // alias for insert_or_assign
+cmap_X_result cmap_X_push(cmap_X* self, i_key key, i_val mapped); // alias for insert
cmap_X_result cmap_X_emplace(cmap_X* self, i_keyraw rkey, i_valraw rmapped); // no change if rkey in map
cmap_X_result cmap_X_emplace_or_assign(cmap_X* self, i_keyraw rkey, i_valraw rmapped); // always update rmapped
-cmap_X_result cmap_X_put_raw(cmap_X* self, i_keyraw rkey, i_valraw rmapped); // alias for emplace_or_assign
size_t cmap_X_erase(cmap_X* self, i_keyraw rkey); // return 0 or 1
cmap_X_iter cmap_X_erase_at(cmap_X* self, cmap_X_iter it); // return iter after it
@@ -276,8 +275,9 @@ typedef struct {
#define Viking_init() ((Viking){cstr_null, cstr_null})
-static inline bool Viking_eq(const Viking* a, const Viking* b) {
- return cstr_equals_s(a->name, b->name) && cstr_equals_s(a->country, b->country);
+static inline int Viking_cmp(const Viking* a, const Viking* b) {
+ int c = cstr_cmp(&a->name, &b->name);
+ return c ? c : cstr_cmp(&a->country, &b->country);
}
static inline uint32_t Viking_hash(const Viking* a, int ignored) {
@@ -298,7 +298,7 @@ static inline void Viking_drop(Viking* vk) {
#define i_key_bind Viking
#define i_val int
// i_key_bind auto-binds:
-// #define i_eq Viking_eq
+// #define i_cmp Viking_cmp
// #define i_hash Viking_hash
// #define i_keyfrom Viking_clone
// #define i_keydrop Viking_drop
@@ -361,8 +361,10 @@ static inline uint64_t RViking_hash(const RViking* raw, size_t ignore) {
uint64_t hash = c_strhash(raw->name) ^ (c_strhash(raw->country) >> 15);
return hash;
}
-static inline bool RViking_eq(const RViking* rx, const RViking* ry) {
- return strcmp(rx->name, ry->name) == 0 && strcmp(rx->country, ry->country) == 0;
+
+static inline int RViking_cmp(const RViking* rx, const RViking* ry) {
+ int c = strcmp(rx->name, ry->name);
+ return c ? c : strcmp(rx->country, ry->country);
}
static inline Viking Viking_from(RViking raw) {
@@ -379,7 +381,7 @@ static inline RViking Viking_toraw(const Viking* vk) {
#define i_keyraw RViking
// i_key_bind macro will make these functions auto-bind:
// #define i_hash RViking_hash
-// #define i_eq RViking_eq
+// #define i_cmp RViking_cmp
// #define i_keyfrom Viking_from // uses _from because i_keyraw is defined
// #define i_keyto Viking_toraw
// #define i_keydrop Viking_drop
diff --git a/docs/cset_api.md b/docs/cset_api.md
index e429c5ae..d9b412da 100644
--- a/docs/cset_api.md
+++ b/docs/cset_api.md
@@ -46,6 +46,7 @@ cset_X_value* cset_X_get_mut(cset_X* self, i_keyraw rkey);
cset_X_iter cset_X_find(const cset_X* self, i_keyraw rkey);
cset_X_result cset_X_insert(cset_X* self, i_key key);
+cset_X_result cset_X_push(cset_X* self, i_key key); // alias for insert.
cset_X_result cset_X_emplace(cset_X* self, i_keyraw rkey);
size_t cset_X_erase(cset_X* self, i_keyraw rkey); // return 0 or 1
diff --git a/docs/csmap_api.md b/docs/csmap_api.md
index 012a7d58..e73e6562 100644
--- a/docs/csmap_api.md
+++ b/docs/csmap_api.md
@@ -63,11 +63,10 @@ csmap_X_value* csmap_X_back(const csmap_X* self);
csmap_X_result csmap_X_insert(csmap_X* self, i_key key, i_val mapped); // no change if key in map
csmap_X_result csmap_X_insert_or_assign(csmap_X* self, i_key key, i_val mapped); // always update mapped
-csmap_X_result csmap_X_put(csmap_X* self, i_key key, i_val mapped); // alias for insert_or_assign()
+csmap_X_result csmap_X_push(csmap_X* self, i_key key, i_val mapped); // alias for insert()
csmap_X_result csmap_X_emplace(csmap_X* self, i_keyraw rkey, i_valraw rmapped); // no change if rkey in map
csmap_X_result csmap_X_emplace_or_assign(csmap_X* self, i_keyraw rkey, i_valraw rmapped); // always update rmapped
-csmap_X_result csmap_X_put_raw(csmap_X* self, i_keyraw rkey, i_valraw rmapped); // alias for emplace_or_assign
size_t csmap_X_erase(csmap_X* self, i_keyraw rkey);
csmap_X_iter csmap_X_erase_at(csmap_X* self, csmap_X_iter it); // returns iter after it
diff --git a/docs/csset_api.md b/docs/csset_api.md
index 0ce8e811..57d23ee6 100644
--- a/docs/csset_api.md
+++ b/docs/csset_api.md
@@ -42,6 +42,7 @@ csset_X_value* csset_X_find_it(const csset_X* self, i_keyraw rkey, csset_X
csset_X_iter csset_X_lower_bound(const csset_X* self, i_keyraw rkey); // find closest entry >= rkey
csset_X_result csset_X_insert(csset_X* self, i_key key);
+csset_X_result csset_X_push(csset_X* self, i_key key); // alias for insert()
csset_X_result csset_X_emplace(csset_X* self, i_keyraw rkey);
size_t csset_X_erase(csset_X* self, i_keyraw rkey);