Function string_tokenize

string/std_string.c:2944–3007

* @brief This function tokenizes the content of the given String object using the specified delimiters. * It returns an array of String objects, each representing a token. The number of tokens is * stored in the variable pointed to by @p count. If the input String object or delimiters are NULL, * the function returns NULL and logs an error. * * @param str The String object to tokenize. Must n

 * @return An array of String objects, each representing a token, or NULL if an error occurs.
 */
String** string_tokenize(const String* str, const char* delimiters, int* count) {
    STRING_LOG("[string_tokenize]: Function start.");

    if (str == NULL || delimiters == NULL) {
        STRING_LOG("[string_tokenize]: Error - Invalid input (str or delimiters is NULL).");
        return NULL;
    }

    size_t num_tokens = 0;
    char* temp_str = string_strdup(str->dataStr); 
    if (temp_str == NULL) {
        STRING_LOG("[string_tokenize]: Error - Memory allocation failed for temp_str.");
        return NULL;
    }

    char* token = strtok(temp_str, delimiters);
    while (token != NULL) {
        num_tokens++;
        token = strtok(NULL, delimiters);
    }
    free(temp_str);

    STRING_LOG("[string_tokenize]: Number of tokens found: %zu.", num_tokens);

    String** tokens = (String**)malloc(num_tokens * sizeof(String*));
    if (tokens == NULL) {
        STRING_LOG("[string_tokenize]: Error - Memory allocation failed for tokens array.");
        return NULL;
    }

    // Tokenize again to fill the array
    temp_str = string_strdup(str->dataStr);
    if (temp_str == NULL) {
        STRING_LOG("[string_tokenize]: Error - Memory allocation failed for temp_str (second pass).");
        free(tokens);
        return NULL;
    }

    token = strtok(temp_str, delimiters);
    size_t idx = 0;

    while (token != NULL && idx < num_tokens) {
        tokens[idx] = string_create(token);
        if (tokens[idx] == NULL) {
            STRING_LOG("[string_tokenize]: Error - Failed to create token string at index %zu.", idx);
            for (size_t i = 0; i < idx; ++i) {
                string_deallocate(tokens[i]);
            }
            free(tokens);
            free(temp_str);

            return NULL;
        }
        idx++;
        token = strtok(NULL, delimiters);
    }
    free(temp_str);
    *count = num_tokens;