Function string_compare

string/std_string.c:592–608

* @brief Compares two String objects lexicographically. * * This function compares two String objects lexicographically. * If either string is NULL, the NULL string is considered less than the non-NULL string. * If both are NULL, they are considered equal. * * @param str1 The first String object to compare. Can be NULL. * @param str2 The second String object to compare. Can be NULL. *

 *         - A value greater than 0 if str1 is greater than str2
 */
int string_compare(const String* str1, const String* str2) {
    STRING_LOG("[string_compare]: Comparing two strings.\n");

    if (str1 == NULL || str2 == NULL) {
        if (str1 == str2) {
            STRING_LOG("[string_compare]: Both strings are NULL. Returning 0 (equal).\n");
            return 0;  
        }

        STRING_LOG("[string_compare]: One or both String objects are NULL.\n");
        return (str1 == NULL) ? -1 : 1;  
    }
    int result = strcmp(str1->dataStr, str2->dataStr);
    STRING_LOG("[string_compare]: Comparison result is %d.\n", result);

    return result;
}


/**