Function string_append

string/std_string.c:937–984

* @brief Appends a C-string to the end of the String object. * * This function appends the contents of `strItem` to the end of the String object. * If necessary, it reallocates memory to accommodate the additional characters. * * @param str The String object to which the string will be appended. Must not be NULL. * @param strItem The C-string to append. Must not be NULL. */

 * @param strItem The C-string to append. Must not be NULL.
 */
void string_append(String *str, const char *strItem) {
    STRING_LOG("[string_append]: Appending string '%s' to the String object.\n", strItem);

    if (str == NULL) {
        STRING_LOG("[string_append]: Error - The String object is NULL.\n");
        return;
    }
    if (str->pool == NULL) {
        STRING_LOG("[string_append]: Error - The String has no memory pool.\n");
        return;
    }
    if (strItem == NULL) {
        STRING_LOG("[string_append]: Error - The strItem is NULL.\n");
        return;
    }
    size_t strItemLength = strlen(strItem);
    if (strItemLength == 0) { 
        STRING_LOG("[string_append]: The strItem is empty, nothing to append.\n");
        return;
    }

    MemoryPoolString* oldToFree = NULL;
    if (str->size + strItemLength >= str->capacitySize) {
        size_t needed = str->size + strItemLength + 1;
        size_t newCapacity = str->capacitySize ? str->capacitySize : 32;

        while (newCapacity < needed) {
            newCapacity *= 2;
        }

        bool ok;
        oldToFree = sstr_grow_keep_old(str, newCapacity, &ok);
        if (!ok) {
            STRING_LOG("[string_append]: Error - Memory allocation failed.\n");
            return;
        }
        STRING_LOG("[string_append]: Resized the string to new capacity: %zu.\n", newCapacity);
    }

    memcpy(str->dataStr + str->size, strItem, strItemLength);
    str->dataStr[str->size + strItemLength] = '\0';
    str->size += strItemLength;
    if (oldToFree) {
        memory_pool_destroy(oldToFree);
    }

    STRING_LOG("[string_append]: Appended successfully, new size: %zu.\n", str->size);
}


/**