foundational_lib 1.0 → 1.0.1

data/docs/html/html/globals_defs.html

@@ -234,8 +234,8 @@ $(document).ready(function(){initNavTree('globals_defs.html',''); initResizable(
 <li>FOUNDATIONAL_LIB_ISUPPER
 : <a class="el" href="foundationallib_8h.html#a3a380549ad8322435d5e71e50e8ce3ab">foundationallib.h</a>
 </li>
-<li>FOUNDATIONAL_LIB_likely
-: <a class="el" href="foundationallib_8h.html#ac909034d71737927c60e65083adfcad2">foundationallib.h</a>
+<li>FOUNDATIONAL_LIB_LIKELY
+: <a class="el" href="foundationallib_8h.html#a185a69e43b731c26d7c273df01c58110">foundationallib.h</a>
 </li>
 <li>FOUNDATIONAL_LIB_LOW_MEMORY_USAGE
 : <a class="el" href="foundationallib_8h.html#aaed4a976ebb512f38e8810088009da91">foundationallib.h</a>

data/docs/html/html/globals_f.html

@@ -343,8 +343,8 @@ $(document).ready(function(){initNavTree('globals_f.html',''); initResizable();
 <li>FOUNDATIONAL_LIB_ISUPPER
 : <a class="el" href="foundationallib_8h.html#a3a380549ad8322435d5e71e50e8ce3ab">foundationallib.h</a>
 </li>
-<li>FOUNDATIONAL_LIB_likely
-: <a class="el" href="foundationallib_8h.html#ac909034d71737927c60e65083adfcad2">foundationallib.h</a>
+<li>FOUNDATIONAL_LIB_LIKELY
+: <a class="el" href="foundationallib_8h.html#a185a69e43b731c26d7c273df01c58110">foundationallib.h</a>
 </li>
 <li>FOUNDATIONAL_LIB_list_comprehension_worker()
 : <a class="el" href="foundationallib_8h.html#a9352809ca180e9037a018d1223230a4b">foundationallib.h</a>
@@ -416,7 +416,7 @@ $(document).ready(function(){initNavTree('globals_f.html',''); initResizable();
 : <a class="el" href="foundationallib_8h.html#a37f47069b896fd8703b1ffa1adae1c1c">foundationallib.h</a>
 </li>
 <li>FOUNDATIONAL_LIB_safe_mul()
-: <a class="el" href="foundationallib_8h.html#a757628ba53c2104b2eea206232ef47e6">foundationallib.h</a>
+: <a class="el" href="foundationallib_8h.html#a786c21a755e3c5cdd37d1ad0a781a6dc">foundationallib.h</a>
 </li>
 <li>FOUNDATIONAL_LIB_safe_mul_ptr()
 : <a class="el" href="foundationallib_8h.html#a6f61f67b477bb06d8ff0be499abef538">foundationallib.h</a>

data/docs/html/html/globals_func_f.html

@@ -260,7 +260,7 @@ $(document).ready(function(){initNavTree('globals_func_f.html',''); initResizabl
 : <a class="el" href="foundationallib_8h.html#aa2d9d0510d58fc28406e14cdbb6bcd6d">foundationallib.h</a>
 </li>
 <li>FOUNDATIONAL_LIB_safe_mul()
-: <a class="el" href="foundationallib_8h.html#a757628ba53c2104b2eea206232ef47e6">foundationallib.h</a>
+: <a class="el" href="foundationallib_8h.html#a786c21a755e3c5cdd37d1ad0a781a6dc">foundationallib.h</a>
 </li>
 <li>FOUNDATIONAL_LIB_safe_mul_ptr()
 : <a class="el" href="foundationallib_8h.html#a6f61f67b477bb06d8ff0be499abef538">foundationallib.h</a>

data/docs/html/html/navtreedata.js

@@ -49,7 +49,7 @@ var NAVTREE =
 var NAVTREEINDEX =
 [
 "annotated.html",
-"foundationallib_8h.html#a8edfa1b2c68493478b23a23eba1b65e1",
+"foundationallib_8h.html#a8ed5dba8537e7a764a57dadb9550fec4",
 "struct_set.html#a7fb84713e171a21a8160a4e375dd6653"
 ];
 

data/docs/html/html/navtreeindex0.js

@@ -50,6 +50,7 @@ var NAVTREEINDEX0 =
 "foundationallib_8h.html#a169d0d926e4d10afbf8a7ee76a67ae02":[1,0,0,0,125],
 "foundationallib_8h.html#a16b0c569cb070613fec0155a4a9f3cf8":[1,0,0,0,432],
 "foundationallib_8h.html#a16efbcc831dd6acb0bbf54fd962fbb78":[1,0,0,0,95],
+"foundationallib_8h.html#a185a69e43b731c26d7c273df01c58110":[1,0,0,0,44],
 "foundationallib_8h.html#a1a2bb40d173c5bdb687de71a2ed6f449":[1,0,0,0,318],
 "foundationallib_8h.html#a1aa01c1b183700116ce5967e6550d870":[1,0,0,0,354],
 "foundationallib_8h.html#a1aaaa16b02c4ca0e840e550de5f32c5b":[1,0,0,0,373],
@@ -204,11 +205,11 @@ var NAVTREEINDEX0 =
 "foundationallib_8h.html#a70092c4e6b1194a2b12107ffe3acf99b":[1,0,0,0,139],
 "foundationallib_8h.html#a70d4b33fad86a51b6e8319d589cdfd03":[1,0,0,0,367],
 "foundationallib_8h.html#a73c9b56bf6724b9e3d5ac3c7b83990ba":[1,0,0,0,237],
-"foundationallib_8h.html#a757628ba53c2104b2eea206232ef47e6":[1,0,0,0,197],
 "foundationallib_8h.html#a76612472bd48de2f850875859e7a2d95":[1,0,0,0,185],
 "foundationallib_8h.html#a76f531029da44ba0310181385f247cb1":[1,0,0,0,334],
 "foundationallib_8h.html#a77a859de730e1937d5c199be940b8b15":[1,0,0,0,246],
 "foundationallib_8h.html#a78114ccda2eb6b91020fe92decb92b73":[1,0,0,0,217],
+"foundationallib_8h.html#a786c21a755e3c5cdd37d1ad0a781a6dc":[1,0,0,0,197],
 "foundationallib_8h.html#a79827295b96c68cf5a084183e00bdef5":[1,0,0,0,211],
 "foundationallib_8h.html#a7a182e8fd588340efa0bd978dcb15d27":[1,0,0,0,313],
 "foundationallib_8h.html#a7a5589db3204ffe99d33c084aed55d6d":[1,0,0,0,259],
@@ -248,6 +249,5 @@ var NAVTREEINDEX0 =
 "foundationallib_8h.html#a8d33356cbbd847e42d86a32b1bded9e1":[1,0,0,0,356],
 "foundationallib_8h.html#a8d33d53e03af3b74236b251bfb56b227":[1,0,0,0,440],
 "foundationallib_8h.html#a8e4e5d5e7a4d71183a8e1b7ef3ab292d":[1,0,0,0,186],
-"foundationallib_8h.html#a8ecfd8dcd79e154f29fa8d5808d610fa":[1,0,0,0,142],
-"foundationallib_8h.html#a8ed5dba8537e7a764a57dadb9550fec4":[1,0,0,0,116]
+"foundationallib_8h.html#a8ecfd8dcd79e154f29fa8d5808d610fa":[1,0,0,0,142]
 };

data/docs/html/html/navtreeindex1.js

@@ -1,5 +1,6 @@
 var NAVTREEINDEX1 =
 {
+"foundationallib_8h.html#a8ed5dba8537e7a764a57dadb9550fec4":[1,0,0,0,116],
 "foundationallib_8h.html#a8edfa1b2c68493478b23a23eba1b65e1":[1,0,0,0,310],
 "foundationallib_8h.html#a8f8e89d030736bd06edac3c06b553852":[1,0,0,0,418],
 "foundationallib_8h.html#a8feaaf3e53d5f3950c4c46500e3c9598":[1,0,0,0,304],
@@ -102,7 +103,6 @@ var NAVTREEINDEX1 =
 "foundationallib_8h.html#ac6b17b423933d2ce1598fa00c8079788":[1,0,0,0,341],
 "foundationallib_8h.html#ac6e57afea02486dc38abc79194e6077d":[1,0,0,0,179],
 "foundationallib_8h.html#ac73f0b8f8caed0422c9c40463d9960d3":[1,0,0,0,180],
-"foundationallib_8h.html#ac909034d71737927c60e65083adfcad2":[1,0,0,0,44],
 "foundationallib_8h.html#ac93374de71c0fb0812ebe7b2db35b77e":[1,0,0,0,267],
 "foundationallib_8h.html#aca51972a58f76df9a39da5338df9c2ec":[1,0,0,0,248],
 "foundationallib_8h.html#aca8fe76c794e57102cab2b1f43263c4d":[1,0,0,0,245],
@@ -201,8 +201,8 @@ var NAVTREEINDEX1 =
 "globals_defs.html":[1,1,4],
 "globals_e.html":[1,1,0,4],
 "globals_f.html":[1,1,0,5],
-"globals_func.html":[1,1,1,0],
 "globals_func.html":[1,1,1],
+"globals_func.html":[1,1,1,0],
 "globals_func_b.html":[1,1,1,1],
 "globals_func_c.html":[1,1,1,2],
 "globals_func_d.html":[1,1,1,3],

data/docs/html/html/search/all_5.js

@@ -75,7 +75,7 @@ var searchData=
   ['foundational_5flib_5fisprint_145',['FOUNDATIONAL_LIB_ISPRINT',['../foundationallib_8h.html#a2cfaa2600de4be9c76bd1ad768ddb98d',1,'foundationallib.h']]],
   ['foundational_5flib_5fisspace_146',['FOUNDATIONAL_LIB_ISSPACE',['../foundationallib_8h.html#aa6596acef91f412badb4324746f30dd8',1,'foundationallib.h']]],
   ['foundational_5flib_5fisupper_147',['FOUNDATIONAL_LIB_ISUPPER',['../foundationallib_8h.html#a3a380549ad8322435d5e71e50e8ce3ab',1,'foundationallib.h']]],
-  ['foundational_5flib_5flikely_148',['FOUNDATIONAL_LIB_likely',['../foundationallib_8h.html#ac909034d71737927c60e65083adfcad2',1,'foundationallib.h']]],
+  ['foundational_5flib_5flikely_148',['FOUNDATIONAL_LIB_LIKELY',['../foundationallib_8h.html#a185a69e43b731c26d7c273df01c58110',1,'foundationallib.h']]],
   ['foundational_5flib_5flist_5fcomprehension_5fworker_149',['FOUNDATIONAL_LIB_list_comprehension_worker',['../foundationallib_8h.html#a9352809ca180e9037a018d1223230a4b',1,'foundationallib.h']]],
   ['foundational_5flib_5flow_5fmemory_5fusage_150',['FOUNDATIONAL_LIB_LOW_MEMORY_USAGE',['../foundationallib_8h.html#aaed4a976ebb512f38e8810088009da91',1,'foundationallib.h']]],
   ['foundational_5flib_5fmemchr_151',['FOUNDATIONAL_LIB_MEMCHR',['../foundationallib_8h.html#acc6fd4b3361386dcfe655076d2575c16',1,'foundationallib.h']]],
@@ -99,7 +99,7 @@ var searchData=
   ['foundational_5flib_5fsafe_5fadd_5f3_169',['FOUNDATIONAL_LIB_safe_add_3',['../foundationallib_8h.html#a500c2f75e0f2363c30a89a78bf7b6826',1,'foundationallib.h']]],
   ['foundational_5flib_5fsafe_5fadd_5f3_5fptr_170',['FOUNDATIONAL_LIB_safe_add_3_ptr',['../foundationallib_8h.html#aa2d9d0510d58fc28406e14cdbb6bcd6d',1,'foundationallib.h']]],
   ['foundational_5flib_5fsafe_5fincrement_171',['FOUNDATIONAL_LIB_safe_increment',['../foundationallib_8h.html#a37f47069b896fd8703b1ffa1adae1c1c',1,'foundationallib.h']]],
-  ['foundational_5flib_5fsafe_5fmul_172',['FOUNDATIONAL_LIB_safe_mul',['../foundationallib_8h.html#a757628ba53c2104b2eea206232ef47e6',1,'foundationallib.h']]],
+  ['foundational_5flib_5fsafe_5fmul_172',['FOUNDATIONAL_LIB_safe_mul',['../foundationallib_8h.html#a786c21a755e3c5cdd37d1ad0a781a6dc',1,'foundationallib.h']]],
   ['foundational_5flib_5fsafe_5fmul_5fptr_173',['FOUNDATIONAL_LIB_safe_mul_ptr',['../foundationallib_8h.html#a6f61f67b477bb06d8ff0be499abef538',1,'foundationallib.h']]],
   ['foundational_5flib_5fset_5faggressive_5fdie_174',['FOUNDATIONAL_LIB_set_aggressive_die',['../foundationallib_8h.html#a0a577c599bb9bf448567ca9d8cf321dc',1,'foundationallib.h']]],
   ['foundational_5flib_5fsize_5fstring_5fof_5fnumber_5fsize_5fplus_5fzero_5fterminator_175',['FOUNDATIONAL_LIB_SIZE_STRING_OF_NUMBER_SIZE_PLUS_ZERO_TERMINATOR',['../foundationallib_8h.html#aa6ac073fb7a2b9bcd12e39a02f7cbd2a',1,'foundationallib.h']]],

data/docs/html/html/search/defines_2.js

@@ -33,7 +33,7 @@ var searchData=
   ['foundational_5flib_5fisprint_866',['FOUNDATIONAL_LIB_ISPRINT',['../foundationallib_8h.html#a2cfaa2600de4be9c76bd1ad768ddb98d',1,'foundationallib.h']]],
   ['foundational_5flib_5fisspace_867',['FOUNDATIONAL_LIB_ISSPACE',['../foundationallib_8h.html#aa6596acef91f412badb4324746f30dd8',1,'foundationallib.h']]],
   ['foundational_5flib_5fisupper_868',['FOUNDATIONAL_LIB_ISUPPER',['../foundationallib_8h.html#a3a380549ad8322435d5e71e50e8ce3ab',1,'foundationallib.h']]],
-  ['foundational_5flib_5flikely_869',['FOUNDATIONAL_LIB_likely',['../foundationallib_8h.html#ac909034d71737927c60e65083adfcad2',1,'foundationallib.h']]],
+  ['foundational_5flib_5flikely_869',['FOUNDATIONAL_LIB_LIKELY',['../foundationallib_8h.html#a185a69e43b731c26d7c273df01c58110',1,'foundationallib.h']]],
   ['foundational_5flib_5flow_5fmemory_5fusage_870',['FOUNDATIONAL_LIB_LOW_MEMORY_USAGE',['../foundationallib_8h.html#aaed4a976ebb512f38e8810088009da91',1,'foundationallib.h']]],
   ['foundational_5flib_5fmemchr_871',['FOUNDATIONAL_LIB_MEMCHR',['../foundationallib_8h.html#acc6fd4b3361386dcfe655076d2575c16',1,'foundationallib.h']]],
   ['foundational_5flib_5fmemcmp_872',['FOUNDATIONAL_LIB_MEMCMP',['../foundationallib_8h.html#a954ba73b0400368c815a0d27e67ea237',1,'foundationallib.h']]],

data/docs/html/html/search/functions_5.js

@@ -46,7 +46,7 @@ var searchData=
   ['foundational_5flib_5fsafe_5fadd_5f2_5fptr_567',['FOUNDATIONAL_LIB_safe_add_2_ptr',['../foundationallib_8h.html#a61ed415504a0cad67a3de862310027a7',1,'foundationallib.h']]],
   ['foundational_5flib_5fsafe_5fadd_5f3_568',['FOUNDATIONAL_LIB_safe_add_3',['../foundationallib_8h.html#a500c2f75e0f2363c30a89a78bf7b6826',1,'foundationallib.h']]],
   ['foundational_5flib_5fsafe_5fadd_5f3_5fptr_569',['FOUNDATIONAL_LIB_safe_add_3_ptr',['../foundationallib_8h.html#aa2d9d0510d58fc28406e14cdbb6bcd6d',1,'foundationallib.h']]],
-  ['foundational_5flib_5fsafe_5fmul_570',['FOUNDATIONAL_LIB_safe_mul',['../foundationallib_8h.html#a757628ba53c2104b2eea206232ef47e6',1,'foundationallib.h']]],
+  ['foundational_5flib_5fsafe_5fmul_570',['FOUNDATIONAL_LIB_safe_mul',['../foundationallib_8h.html#a786c21a755e3c5cdd37d1ad0a781a6dc',1,'foundationallib.h']]],
   ['foundational_5flib_5fsafe_5fmul_5fptr_571',['FOUNDATIONAL_LIB_safe_mul_ptr',['../foundationallib_8h.html#a6f61f67b477bb06d8ff0be499abef538',1,'foundationallib.h']]],
   ['foundational_5flib_5fstatic_5fassert_5fmsg_572',['FOUNDATIONAL_LIB_STATIC_ASSERT_MSG',['../foundationallib_8h.html#a5a11b59026f061e60d97fa8b3626e13f',1,'foundationallib.h']]],
   ['free_5farray_573',['free_array',['../foundationallib_8h.html#a7d48c3cdcc509a538faba6b7426eea52',1,'foundationallib.h']]],

data/docs/src/foundationallib.h

@@ -114,7 +114,7 @@ FOUNDATIONAL_LIB_STATIC_ASSERT_MSG((sizeof(size_t) <= 8 && FOUNDATIONAL_LIB_SIZE
 
 #endif
 #ifndef FOUNDATIONAL_LIB_UNSAFE_FUNCTIONS_ENABLED
-// Default true
+/* Default true */
 #define FOUNDATIONAL_LIB_UNSAFE_FUNCTIONS_ENABLED 1
 #endif
 
@@ -330,7 +330,7 @@ FOUNDATIONAL_LIB_STATIC_ASSERT_MSG((sizeof(size_t) <= 8 && FOUNDATIONAL_LIB_SIZE
 #endif
 
 #ifndef FOUNDATIONAL_LIB_FPUTC
-#define FOUNDATIONAL_LIB_FPUTC putc
+#define FOUNDATIONAL_LIB_FPUTC fputc
 #endif
 
 #ifndef FOUNDATIONAL_LIB_STRPBRK
@@ -417,10 +417,10 @@ FOUNDATIONAL_LIB_STATIC_ASSERT_MSG((sizeof(size_t) <= 8 && FOUNDATIONAL_LIB_SIZE
 #endif
 
 #if defined(__GNUC__) || defined(__clang__)
-#define FOUNDATIONAL_LIB_likely(x) __builtin_expect(!!(x), 1)
+#define FOUNDATIONAL_LIB_LIKELY(x) __builtin_expect(!!(x), 1)
 #define FOUNDATIONAL_LIB_UNLIKELY(x) __builtin_expect(!!(x), 0)
 #else
-#define FOUNDATIONAL_LIB_likely(x) (x)
+#define FOUNDATIONAL_LIB_LIKELY(x) (x)
 #define FOUNDATIONAL_LIB_UNLIKELY(x) (x)
 #endif
 
@@ -437,8 +437,12 @@ FOUNDATIONAL_LIB_STATIC_ASSERT_MSG((sizeof(size_t) <= 8 && FOUNDATIONAL_LIB_SIZE
 #endif /* assert checking. */
 
 #ifdef __GNUC__
-/** @brief Safely multiply 2 numbers to avoid unsigned integer overflows and security and stability issues. We never, NEVER want any of those things. Ever. */
-FOUNDATIONAL_LIB_CONST
+/**
+ * @brief
+ * Safely multiply 2 numbers to avoid unsigned integer overflows and security
+ * and stability issues. We never, NEVER want any of those things. Ever.
+ */
+
 static inline size_t FOUNDATIONAL_LIB_safe_mul(size_t a, size_t b)
 {
     size_t result;
@@ -520,8 +524,12 @@ static inline int FOUNDATIONAL_LIB_safe_add_2_ptr(size_t a, size_t b, size_t *ou
 }
 
 #else  /* GNUC */
-/** @brief Safely multiply 2 numbers to avoid unsigned integer overflows and security and stability issues. We never, NEVER want any of those things. Ever. */
-FOUNDATIONAL_LIB_CONST
+/**
+ * @brief
+ * Safely multiply 2 numbers to avoid unsigned integer overflows and security
+ * and stability issues. We never, NEVER want any of those things. Ever.
+ */
+
 static inline size_t FOUNDATIONAL_LIB_safe_mul(size_t a, size_t b)
 {
     size_t result;
@@ -617,7 +625,6 @@ static inline int FOUNDATIONAL_LIB_safe_add_3_ptr(size_t a, size_t b, size_t c,
 
 // Adjust as needed. On embedded platforms or low memory systems, you might want to change the algorithm to be somewhat lower than 1.5x
 // new len calculations need to be checked, before and after this, for overflow.
-
 #ifndef FOUNDATIONAL_LIB_LOW_MEMORY_USAGE
 #define FOUNDATIONAL_LIB_LOW_MEMORY_USAGE 12
 #endif
@@ -2112,7 +2119,7 @@ FOUNDATIONAL_LIB_FUNC void print_short_ptr_array_to_stream(const short **array,
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         FOUNDATIONAL_LIB_FPRINTF(stream, "%d", *array[i]);
         if (i < size - 1)
@@ -2138,7 +2145,7 @@ FOUNDATIONAL_LIB_FUNC void print_ulong_array_to_stream(const unsigned long *arra
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         FOUNDATIONAL_LIB_FPRINTF(stream, "%lu", array[i]);
         if (i < size - 1)
@@ -2165,7 +2172,7 @@ FOUNDATIONAL_LIB_FUNC void print_ulong_ptr_array_to_stream(const unsigned long *
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         FOUNDATIONAL_LIB_FPRINTF(stream, "%lu", *array[i]);
         if (i < size - 1)
@@ -2190,7 +2197,7 @@ FOUNDATIONAL_LIB_FUNC void print_long_array_to_stream(const long *array, size_t
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         FOUNDATIONAL_LIB_FPRINTF(stream, "%ld", array[i]);
         if (i < size - 1)
@@ -2217,7 +2224,7 @@ FOUNDATIONAL_LIB_FUNC void print_long_ptr_array_to_stream(const long **array, si
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         FOUNDATIONAL_LIB_FPRINTF(stream, "%ld", *array[i]);
         if (i < size - 1)
@@ -2244,7 +2251,7 @@ FOUNDATIONAL_LIB_FUNC void print_ulong_long_array_to_stream(const unsigned long
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         const unsigned long long value = array[i];
         char buffer[FOUNDATIONAL_LIB_SIZE_STRING_OF_NUMBER_SIZE_PLUS_ZERO_TERMINATOR];
@@ -2275,7 +2282,7 @@ FOUNDATIONAL_LIB_FUNC void print_ulong_long_ptr_array_to_stream(const unsigned l
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         const unsigned long long value = *(array[i]);
         char buffer[FOUNDATIONAL_LIB_SIZE_STRING_OF_NUMBER_SIZE_PLUS_ZERO_TERMINATOR];
@@ -2305,7 +2312,7 @@ FOUNDATIONAL_LIB_FUNC void print_long_long_array_to_stream(const long long *arra
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         const unsigned long long value = array[i];
         char buffer[FOUNDATIONAL_LIB_SIZE_STRING_OF_NUMBER_SIZE_PLUS_ZERO_TERMINATOR];
@@ -2338,7 +2345,7 @@ FOUNDATIONAL_LIB_FUNC void print_long_long_ptr_array_to_stream(const long long *
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         const long long value = *(array[i]);
 
@@ -2369,7 +2376,7 @@ FOUNDATIONAL_LIB_FUNC void print_float_array_to_stream(const float *array, size_
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         FOUNDATIONAL_LIB_FPRINTF(stream, "%f", array[i]);
         if (i < size - 1)
@@ -2396,7 +2403,7 @@ FOUNDATIONAL_LIB_FUNC void print_float_ptr_array_to_stream(const float **array,
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         FOUNDATIONAL_LIB_FPRINTF(stream, "%f", *array[i]);
         if (i < size - 1)
@@ -2422,7 +2429,7 @@ FOUNDATIONAL_LIB_FUNC void print_double_array_to_stream(const double *array, siz
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         FOUNDATIONAL_LIB_FPRINTF(stream, "%lf", array[i]);
         if (i < size - 1)
@@ -2449,7 +2456,7 @@ FOUNDATIONAL_LIB_FUNC void print_double_ptr_array_to_stream(const double **array
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         FOUNDATIONAL_LIB_FPRINTF(stream, "%lf", *array[i]);
         if (i < size - 1)
@@ -2475,7 +2482,7 @@ FOUNDATIONAL_LIB_FUNC void print_size_t_array_to_stream(const size_t *array, siz
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
 #pragma GCC diagnostic push
 #pragma GCC diagnostic ignored "-Wpragmas"
@@ -2508,7 +2515,7 @@ FOUNDATIONAL_LIB_FUNC void print_size_t_ptr_array_to_stream(const size_t **array
 {
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_FPUTC('[', stream);
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
 #pragma GCC diagnostic push
 #pragma GCC diagnostic ignored "-Wpragmas"
@@ -2559,7 +2566,7 @@ FOUNDATIONAL_LIB_FUNC void *arraydup(const void *array, size_t num_mem, size_t s
         return NULL;
     }
 
-    for (size_t i = 0; i < tot_size; i++)
+    for (size_t i = 0; i < tot_size; ++i)
     {
         duplicate[i] = ((char *)array)[i];
     }
@@ -3440,7 +3447,7 @@ FOUNDATIONAL_LIB_FUNC char **split(const char *str, size_t *output_size, const c
     const char *ptr;
 
     /* Split the string into tokens */
-    for (size_t i = 0; i < *output_size; i++)
+    for (size_t i = 0; i < *output_size; ++i)
     {
         ptr = FOUNDATIONAL_LIB_STRSTR(token_start, delim);
 
@@ -3540,7 +3547,7 @@ FOUNDATIONAL_LIB_FUNC char *join(const char **array, size_t count, const char *d
     size_t total_length;
 
     total_length = 1; // NUL byte
-    for (size_t i = 0; i < count; i++)
+    for (size_t i = 0; i < count; ++i)
     {
         const size_t new_len = FOUNDATIONAL_LIB_STRLEN(array[i]);
         lens[i] = new_len;
@@ -4154,7 +4161,7 @@ FOUNDATIONAL_LIB_FUNC size_t array_total_string_length(char **array, size_t coun
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     size_t length = 0;
 
-    for (size_t i = 0; i < count; i++)
+    for (size_t i = 0; i < count; ++i)
     {
         // NOTE: Do not check for overflows here.
         length += FOUNDATIONAL_LIB_STRLEN(array[i]);
@@ -4253,7 +4260,7 @@ FOUNDATIONAL_LIB_FUNC char *reverse_string(const char *str)
     size_t length = FOUNDATIONAL_LIB_STRLEN(new_str);
     size_t i, j;
 
-    for (i = 0, j = length - 1; i < j; i++, j--)
+    for (i = 0, j = length - 1; i < j; ++i, j--)
     {
         char temp = new_str[i];
         new_str[i] = new_str[j];
@@ -4574,7 +4581,7 @@ FOUNDATIONAL_LIB_FUNC int is_string_numeric(const char *str)
 
     const size_t len = FOUNDATIONAL_LIB_STRLEN(str);
 
-    for (size_t i = 0; i < len; i++)
+    for (size_t i = 0; i < len; ++i)
     {
         if (!FOUNDATIONAL_LIB_ISDIGIT(str[i]))
         {
@@ -4605,7 +4612,7 @@ FOUNDATIONAL_LIB_FUNC int is_string_alphanumeric(const char *str)
 
     size_t len = FOUNDATIONAL_LIB_STRLEN(str);
 
-    for (size_t i = 0; i < len; i++)
+    for (size_t i = 0; i < len; ++i)
     {
         if (!FOUNDATIONAL_LIB_ISALNUM(str[i]))
         {
@@ -4814,7 +4821,7 @@ FOUNDATIONAL_LIB_FUNC ssize_t find_first_of(const char *str, const char *char_se
 
     const char *result = strpbrk(str, char_set);
 
-    return FOUNDATIONAL_LIB_likely(result != NULL) ? result - str : -1;
+    return FOUNDATIONAL_LIB_LIKELY(result != NULL) ? result - str : -1;
 }
 
 /**
@@ -4932,7 +4939,7 @@ FOUNDATIONAL_LIB_FUNC size_t common_prefix_length(const char *str1, const char *
 
     const size_t min_len = (len1 < len2) ? len1 : len2;
 
-    for (size_t i = 0; i < min_len; i++)
+    for (size_t i = 0; i < min_len; ++i)
     {
         if (str1[i] != str2[i])
         {
@@ -4962,7 +4969,7 @@ FOUNDATIONAL_LIB_FUNC size_t common_suffix_length(const char *str1, const char *
 
     const size_t min_len = (len1 < len2) ? len1 : len2;
 
-    for (size_t i = 1; i <= min_len; i++)
+    for (size_t i = 1; i <= min_len; ++i)
     {
         if (str1[len1 - i] != str2[len2 - i])
         {
@@ -5004,7 +5011,7 @@ FOUNDATIONAL_LIB_FUNC char *string_to_title_case(const char *str)
 
     int make_upper = 1; // Start with the first character as uppercase
 
-    for (size_t i = 0; i < len; i++)
+    for (size_t i = 0; i < len; ++i)
     {
         if (FOUNDATIONAL_LIB_ISSPACE(str[i]))
         {
@@ -5043,7 +5050,7 @@ FOUNDATIONAL_LIB_FUNC int find_max_int_in_array(const int *array, size_t size)
 
     int max = array[0];
 
-    for (size_t i = 1; i < size; i++)
+    for (size_t i = 1; i < size; ++i)
     {
         if (array[i] > max)
         {
@@ -5074,7 +5081,7 @@ FOUNDATIONAL_LIB_FUNC int find_min_int_in_array(const int *array, size_t size)
 
     int min = array[0];
 
-    for (size_t i = 1; i < size; i++)
+    for (size_t i = 1; i < size; ++i)
     {
         if (array[i] < min)
         {
@@ -7784,7 +7791,7 @@ FOUNDATIONAL_LIB_FUNC char *concatenate_strings(const char *str1, const char *st
  *
  *        If should_free_after_use is non-zero, a new dynamically allocated array with the replacements made.
  *        If should_free_after_use is zero, output aliases source, and they refer to the same memory.
- * @param should_free_after_use A pointer to a int indicating whether
+ * @param should_free_after_use A pointer to a int indicating whether one should free the memory after using the function.
  * @param num_matches A pointer to a variable to store the number of replacements made.
  * @param matches_max A pointer to the maximum number of replacements to make. If zero, there is no maximum.
  *
@@ -8297,7 +8304,7 @@ FOUNDATIONAL_LIB_FUNC void map_ints(int *array, size_t size, int (*transform)(in
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(transform);
 
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         array[i] = transform(array[i]);
     }
@@ -8340,7 +8347,7 @@ FOUNDATIONAL_LIB_FUNC int reduce_ints(int *array, size_t size, int (*operation)(
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(operation);
 
     int result = array[0];
-    for (size_t i = 1; i < size; i++)
+    for (size_t i = 1; i < size; ++i)
     {
         result = operation(result, array[i]);
     }
@@ -8393,7 +8400,7 @@ FOUNDATIONAL_LIB_FUNC int filter_ints(int *source, size_t source_size, int *dest
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(condition);
 
     size_t count = 0;
-    for (size_t i = 0; i < source_size; i++)
+    for (size_t i = 0; i < source_size; ++i)
     {
         if (condition(source[i]))
         {
@@ -8438,7 +8445,7 @@ FOUNDATIONAL_LIB_FUNC void map(void *array, size_t size, size_t elem_size, void
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(array);
     FOUNDATIONAL_LIB_ASSERT_ARGUMENT_IF_ENABLED(transform);
 
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         transform(((char *)array) + i * elem_size);
     }
@@ -8488,12 +8495,12 @@ FOUNDATIONAL_LIB_FUNC void reduce(void *array, size_t size, size_t elem_size, vo
     char *char_result = (char *)result;
 
     /* Initialize the result with the first element */
-    for (size_t i = 0; i < elem_size; i++)
+    for (size_t i = 0; i < elem_size; ++i)
     {
         char_result[i] = char_array[i];
     }
 
-    for (size_t i = 1; i < size; i++)
+    for (size_t i = 1; i < size; ++i)
     {
         operation(char_result, char_array + i * elem_size);
     }
@@ -8551,18 +8558,19 @@ FOUNDATIONAL_LIB_FUNC size_t filter(void *source, size_t source_size, size_t ele
     char *char_destination = (char *)destination;
 
     size_t count = 0;
-    for (size_t i = 0; i < source_size; i++)
+    for (size_t i = 0; i < source_size; ++i)
     {
         if (condition(char_source + i * elem_size))
         {
             if (count < dest_size)
             {
-                for (size_t j = 0; j < elem_size; j++)
+                for (size_t j = 0; j < elem_size; ++j)
                 {
                     char_destination[count * elem_size + j] = char_source[i * elem_size + j];
                 }
             }
-            count++;
+
+            ++count;
         }
     }
     return count;
@@ -9641,18 +9649,18 @@ FOUNDATIONAL_LIB_FUNC int string_array_uniq(const char **array, size_t size, cha
     }
 
     // Initialize all elements to NULL
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         (*output)[i] = NULL;
     }
 
     // Iterate through the input array to find unique strings
-    for (size_t i = 0; i < size; i++)
+    for (size_t i = 0; i < size; ++i)
     {
         int is_unique = 1;
 
         // Check if the current string is not equal to any previous strings
-        for (size_t j = 0; j < count; j++)
+        for (size_t j = 0; j < count; ++j)
         {
             if ((*output)[j] != NULL && FOUNDATIONAL_LIB_STRCMP(array[i], (*output)[j]) == 0)
             {
@@ -12059,7 +12067,7 @@ FOUNDATIONAL_LIB_FUNC int is_valid_utf8(const char *str, size_t len)
         if ((str[i] & 0x80) == 0)
         {
             // ASCII character (0xxxxxxx)
-            i++;
+            ++i;
         }
         else if ((str[i] & 0xE0) == 0xC0)
         {

data/foundationallib.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name        = 'foundational_lib'
-  s.version     = "1.0"
+  s.version     = "1.0.1"
   s.summary     = 'Backup for foundationallib in case it gets taken down (https://www.github.com/gregoryc/foundationallib).'
   s.description = "#{File.read("README.md")}"
   s.authors     = ['Gregory Cohen']