Function string_push_back

string/std_string.c:996–1032

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

 * @param chItem The character to append.
 */
void string_push_back(String* str, char chItem) {
    STRING_LOG("[string_push_back]: Pushing back character '%c' into the String object.\n", chItem);

    if (str == NULL) {
        STRING_LOG("[string_push_back]: Error - The String object is NULL.\n");
        return;
    }
    if (str->pool == NULL) {
        STRING_LOG("[string_push_back]: Error - The String has no memory pool.\n");
        return;
    }


    MemoryPoolString* oldToFree = NULL;
    if (str->dataStr == NULL || str->size + 1 >= str->capacitySize) {
        size_t newCapacity = str->capacitySize ? str->capacitySize * 2 : 32;
        while (newCapacity < str->size + 2) {
            newCapacity *= 2;
        }
        
        bool ok;
        oldToFree = sstr_grow_keep_old(str, newCapacity, &ok);  // grow, reclaiming the old buffer
        if (!ok) {
            STRING_LOG("[string_push_back]: Error - Memory allocation failed.\n");
            return;
        }
        STRING_LOG("[string_push_back]: Resized the string to new capacity: %zu.\n", newCapacity);
    }
    str->dataStr[str->size] = chItem;
    str->size++;
    str->dataStr[str->size] = '\0';
    if (oldToFree) {
        memory_pool_destroy(oldToFree);
    }

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


/**