Function string_create

string/std_string.c:370–422

* @brief Creates a new String object initialized with the given initial string. * * This function allocates memory for a new String object and initializes it with the provided initial string. * If the initial string is not provided (i.e., NULL), the String object will be created with an empty string. * The function also initializes a memory pool for efficient memory management of the string d

 * @return A pointer to the newly created String object, or exits the program with an error if memory allocation fails.
 */
String* string_create(const char* initialStr) {
    STRING_LOG("[string_create]: Creating string with initial content: %s", initialStr ? initialStr : "(null)");

    String* str = (String*)malloc(sizeof(String));
    if (!str) {
        STRING_LOG("Error: Memory allocation failed for String object in string_create.");
        return NULL;
    }

    size_t initialSize = initialStr ? strlen(initialStr) : 0;
    str->size = initialSize;
    str->capacitySize = 32 + initialSize; // +1 for null terminator

    STRING_LOG("[string_create]: Initial size: %zu, Capacity size: %zu", initialSize, str->capacitySize);


    /* Size the per-string bump pool to this string's actual needs (with a
     * little headroom so a few in-place growths stay contiguous), NOT a fixed
     * 1 MB. A fixed huge pool made N strings cost N MB (e.g. 100000 strings ->
     * ~100 GB -> malloc fails -> dataStr NULL -> crash). Anything that outgrows
     * this small block transparently spills to tracked heap allocations in
     * memory_pool_allocate, so growth still works for large strings. */
    size_t initialPoolSize = (str->capacitySize + 1) * 4;
    if (initialPoolSize < 128) {
        initialPoolSize = 128;
    }
    str->pool = memory_pool_create(initialPoolSize);
    if (!str->pool) {
        STRING_LOG("[string_create]: Error: Memory pool creation failed in string_create.");
        free(str);
        return NULL;
    }

    str->dataStr = (char*) memory_pool_allocate(str->pool, str->capacitySize);
    if (!str->dataStr) {
        STRING_LOG("[string_create]: Error: Memory pool allocation failed in string_create.");
        memory_pool_destroy(str->pool);
        free(str);
        return NULL;
    }

    if (initialStr) {
        strcpy(str->dataStr, initialStr);
        STRING_LOG("[string_create]: String initialized with content: %s", str->dataStr);
    }
    else {
        str->dataStr[0] = '\0';
    }

    registry_add(str);  /* track for safe (idempotent) deallocation */
    STRING_LOG("[string_create]: String creation successful.");
    return str;
}


/**