feat: add mathematics_max, mathematics_min

Also add `mathematics_max_values` and
`mathematics_min_values` to check in array.

lib/mathematics.c

@@ -36,3 +36,35 @@ unsigned long long mathematics_factorial(unsigned long long number) {
 int64_t mathematics_opposite(int64_t number) {
   return number * -1;
 }
+
+int64_t mathematics_max(int64_t number1, int64_t number2) {
+  return number1 > number2 ? number1 : number2;
+}
+
+int64_t mathematics_max_values(int64_t *values, size_t values_length) {
+  int64_t max = 0;
+  if (values_length <= 0) {
+    return max;
+  }
+  max = values[0];
+  for (size_t index = 1; index < values_length; index++) {
+    max = mathematics_max(max, values[index]);
+  }
+  return max;
+}
+
+int64_t mathematics_min(int64_t number1, int64_t number2) {
+  return number1 > number2 ? number2 : number1;
+}
+
+int64_t mathematics_min_values(int64_t *values, size_t values_length) {
+  int64_t min = 0;
+  if (values_length <= 0) {
+    return min;
+  }
+  min = values[0];
+  for (size_t index = 1; index < values_length; index++) {
+    min = mathematics_min(min, values[index]);
+  }
+  return min;
+}

lib/mathematics.h

@@ -5,6 +5,7 @@
 
 #include <errno.h>
 #include <stdbool.h>
+#include <stdlib.h>
 
 #include "types.h"
 
@@ -71,7 +72,54 @@ unsigned long long mathematics_factorial(unsigned long long number);
  *
  * @param number
  * @return int64_t
+ *
+ * @code
+ * mathematics_opposite(7) // -7
+ *
+ * mathematics_opposite(-7) // 7
+ * @endcode
+ * @since vTODO
  */
 int64_t mathematics_opposite(int64_t number);
 
+/**
+ * @brief Returns the largest number between 2 numbers.
+ *
+ * @param number1
+ * @param number2
+ * @return int64_t
+ * @since vTODO
+ */
+int64_t mathematics_max(int64_t number1, int64_t number2);
+
+/**
+ * @brief Returns the largest number between multiple numbers. If the array is empty, returns 0.
+ *
+ * @param values
+ * @param values_length
+ * @return int64_t
+ * @since vTODO
+ */
+int64_t mathematics_max_values(int64_t *values, size_t values_length);
+
+/**
+ * @brief Returns the smallest number between 2 numbers.
+ *
+ * @param number1
+ * @param number2
+ * @return int64_t
+ * @since vTODO
+ */
+int64_t mathematics_min(int64_t number1, int64_t number2);
+
+/**
+ * @brief Returns the smallest number between multiple numbers. If the array is empty, returns 0.
+ *
+ * @param values
+ * @param values_length
+ * @return int64_t
+ * @since vTODO
+ */
+int64_t mathematics_min_values(int64_t *values, size_t values_length);
+
 #endif

lib/string.h

@@ -224,6 +224,7 @@ bool string_get_is_substring(const string_t string, const string_t substring);
  * @param number
  * @param separator
  * @return string_t
+ *
  * @code
  * string_get_formatted_number(1000, " ") // "1 000"
  * string_get_formatted_number(1000, ",") // "1,000"
@@ -270,7 +271,10 @@ bool string_ends_with(const string_t string, const string_t prefix);
  * @param string
  * @param substring
  * @return size_t
- * @example string_position_of("hello world", 'e') // 2
+ *
+ * @code
+ * string_position_of("hello world", 'e') // 2
+ * @endcode
  * @since v4.2.0
  */
 size_t string_position_of(const string_t string, const char character);
@@ -281,7 +285,10 @@ size_t string_position_of(const string_t string, const char character);
  * @param string
  * @param character
  * @return size_t
- * @example string_last_position_of("hello world", 'o') // 8
+ *
+ * @code
+ * string_last_position_of("hello world", 'o') // 8
+ * @endcode
  * @since v4.2.0
  */
 size_t string_last_position_of(const string_t string, const char character);
@@ -293,7 +300,10 @@ size_t string_last_position_of(const string_t string, const char character);
  * @param pad_string The string to pad the current string with, to the left.
  * @param target_length
  * @return string_t
- * @example string_pad_start("hello", " ", 10) // "     hello"
+ *
+ * @code
+ * string_pad_start("hello", " ", 10) // "     hello"
+ * @endcode
  * @since vTODO
  */
 string_t string_pad_start(const string_t string, const string_t pad_string, size_t target_length);
@@ -304,8 +314,12 @@ string_t string_pad_start(const string_t string, const string_t pad_string, size
  * @param number
  * @param places
  * @return string_t
- * @example zero_pad(1, 2) // "01"
- * @example zero_pad(10, 2) // "10"
+ *
+ * @code
+ * string_zero_pad(1, 2) // "01"
+ *
+ * string_zero_pad(10, 2) // "10"
+ * @endcode
  * @since vTODO
  */
 string_t string_zero_pad(uint64_t number, size_t places);

test/mathematics_test.c

@@ -6,6 +6,11 @@ void mathematics_test() {
   mathematics_root_test();
   mathematics_square_root_test();
   mathematics_factorial_test();
+  mathematics_opposite_test();
+  mathematics_max_test();
+  mathematics_max_values_test();
+  mathematics_min_test();
+  mathematics_min_values_test();
 }
 
 void mathematics_absolute_value_test() {
@@ -56,3 +61,38 @@ void mathematics_factorial_test() {
   assert(mathematics_factorial(9) == 362880);
   assert(mathematics_factorial(10) == 3628800);
 }
+
+void mathematics_opposite_test() {
+  assert(mathematics_opposite(-7) == 7);
+  assert(mathematics_opposite(7) == -7);
+}
+
+void mathematics_max_test() {
+  assert(mathematics_max(0, 0) == 0);
+  assert(mathematics_max(0, 1) == 1);
+  assert(mathematics_max(2, 0) == 2);
+  assert(mathematics_max(54, 37) == 54);
+}
+
+void mathematics_max_values_test() {
+  int64_t values[] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9};
+  assert(mathematics_max_values(values, 10) == 9);
+
+  int64_t values2[] = {8, 6, 4, 7};
+  assert(mathematics_max_values(values2, 4) == 8);
+}
+
+void mathematics_min_test() {
+  assert(mathematics_min(0, 0) == 0);
+  assert(mathematics_min(3, 5) == 3);
+  assert(mathematics_min(2, 1) == 1);
+  assert(mathematics_min(54, 37) == 37);
+}
+
+void mathematics_min_values_test() {
+  int64_t values[] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9};
+  assert(mathematics_min_values(values, 10) == 0);
+
+  int64_t values2[] = {9, 6, 8, 7};
+  assert(mathematics_min_values(values2, 4) == 6);
+}

test/mathematics_test.h

@@ -17,4 +17,14 @@ void mathematics_square_root_test();
 
 void mathematics_factorial_test();
 
+void mathematics_opposite_test();
+
+void mathematics_max_test();
+
+void mathematics_max_values_test();
+
+void mathematics_min_test();
+
+void mathematics_min_values_test();
+
 #endif