mirror of
https://github.com/theoludwig/libcproject.git
synced 2024-11-08 22:31:31 +01:00
Théo LUDWIG
06b34b115b
BREAKING CHANGE: Functions signatures changed.
If you want to preserve the same behavior, you should pass explictly the space character to trim:
Example: `string_trim(" Hello ")` => `string_trim(" Hello ", ' ')`
224 lines
5.3 KiB
C
224 lines
5.3 KiB
C
#ifndef __LIBCPROJECT_STRING__
|
|
#define __LIBCPROJECT_STRING__
|
|
|
|
#include <stdbool.h>
|
|
#include <stdio.h>
|
|
#include <stdlib.h>
|
|
|
|
#include "character.h"
|
|
#include "convert.h"
|
|
#include "hash_map.h"
|
|
#include "types.h"
|
|
|
|
/**
|
|
* @brief Return the length of a string (excluding '\0').
|
|
*
|
|
* @param string_value
|
|
* @since v1.0.0
|
|
*/
|
|
size_t string_get_length(const string_t string_value);
|
|
|
|
/**
|
|
* @brief Converts all the alphabetic characters in a string to uppercase.
|
|
*
|
|
* @param string_value
|
|
* @since v1.0.0
|
|
*/
|
|
string_t string_to_uppercase(string_t string_value);
|
|
|
|
/**
|
|
* @brief Converts all the alphabetic characters in a string to lowercase.
|
|
*
|
|
* @param string_value
|
|
* @since v1.0.0
|
|
*/
|
|
string_t string_to_lowercase(string_t string_value);
|
|
|
|
/**
|
|
* @brief Replace all the occurrences of search value into replace value in the string.
|
|
*
|
|
* @param string_value
|
|
* @param search A character search value.
|
|
* @param replace A character containing the text to replace for match.
|
|
* @since v1.0.0
|
|
*/
|
|
string_t string_replace(string_t string_value, char search, char replace);
|
|
|
|
/**
|
|
* @brief Removes all `character` from the start of a string.
|
|
*
|
|
* @param string_value
|
|
* @since v1.0.0
|
|
*/
|
|
string_t string_trim_start(string_t string_value, char character);
|
|
|
|
/**
|
|
* @brief Removes all `character` from the end of a string.
|
|
*
|
|
* @param string_value
|
|
* @since v1.0.0
|
|
*/
|
|
string_t string_trim_end(string_t string_value, char character);
|
|
|
|
/**
|
|
* @brief Removes all `character` from the start and end of a string.
|
|
*
|
|
* @param string_value
|
|
* @since v1.0.0
|
|
*/
|
|
string_t string_trim(string_t string_value, char character);
|
|
|
|
/**
|
|
* @brief Return the copy of a string.
|
|
*
|
|
* @param string_value
|
|
* @since v1.0.0
|
|
*/
|
|
string_t string_copy(const string_t string_value);
|
|
|
|
/**
|
|
* @brief Capitalizes the string.
|
|
*
|
|
* @param string_value
|
|
* @since v1.0.0
|
|
*/
|
|
string_t string_capitalize(string_t string_value);
|
|
|
|
/**
|
|
* @brief Returns the total number of occurrences of the given character in the string.
|
|
*
|
|
* @param string_value
|
|
* @param character
|
|
* @since v1.0.0
|
|
*/
|
|
size_t string_total_occurrences_of_character(string_t string_value, char character);
|
|
|
|
/**
|
|
* @brief Reverse the characters in an array.
|
|
*
|
|
* @param string_value
|
|
* @since v1.0.0
|
|
*/
|
|
string_t string_reverse(const string_t string_value);
|
|
|
|
/**
|
|
* @brief Check if two strings are equals.
|
|
*
|
|
* @param string1
|
|
* @param string2
|
|
* @return true if the strings are equals, false otherwise.
|
|
* @since v1.0.0
|
|
*/
|
|
bool string_equals(const string_t string1, const string_t string2);
|
|
|
|
/**
|
|
* @brief Check if the string is a integer.
|
|
*
|
|
* @param string_value
|
|
* @return true if the string is a integer, false otherwise.
|
|
* @since v1.0.0
|
|
*/
|
|
bool string_get_is_integer(const string_t string_value);
|
|
|
|
/**
|
|
* @brief Split a string into substrings using the specified separator and return them as an array and update the pointer `result_size` to the resulting size of the created array.
|
|
*
|
|
* @param string_value
|
|
* @param separator
|
|
* @param result_size
|
|
* @since v1.0.0
|
|
*/
|
|
string_t* string_split(const string_t string_value, char separator, size_t* result_size);
|
|
|
|
/**
|
|
* @brief Adds all the elements of an array into a string, separated by the specified separator string.
|
|
*
|
|
* @param array
|
|
* @param separator
|
|
* @param array_length
|
|
* @since v1.0.0
|
|
*/
|
|
string_t string_join(string_t* array, const char separator, size_t array_length);
|
|
|
|
/**
|
|
* @brief Concatenate two strings.
|
|
*
|
|
* @param string1
|
|
* @param string2
|
|
* @since v1.0.0
|
|
*/
|
|
string_t string_concatenate(string_t string1, string_t string2);
|
|
|
|
/**
|
|
* @brief Check if a string contains only unique characters.
|
|
*
|
|
* @param string
|
|
* @return true if string contains only unique characters, false otherwise.
|
|
* @since v1.0.0
|
|
*/
|
|
bool string_get_has_unique_characters(const string_t string);
|
|
|
|
/**
|
|
* @brief Returns the part of the string between the start and end indexes (both included).
|
|
*
|
|
* @param string_value
|
|
* @param index_start
|
|
* @param index_end
|
|
* @since v1.0.0
|
|
*/
|
|
string_t string_substring(const string_t string_value, size_t index_start, size_t index_end);
|
|
|
|
/**
|
|
* @brief Check if a string contains a substring.
|
|
*
|
|
* @param string_value
|
|
* @param substring
|
|
* @return true if the string contains the substring, false otherwise.
|
|
* @since v1.0.0
|
|
*/
|
|
bool string_get_is_substring(const string_t string_value, const string_t substring);
|
|
|
|
/**
|
|
* @brief Format a number to a string with specified separator.
|
|
*
|
|
* @param number
|
|
* @param separator
|
|
* @since v1.0.0
|
|
* @code
|
|
* string_get_formatted_number(1000, " ") // "1 000"
|
|
* string_get_formatted_number(1000, ",") // "1,000"
|
|
* @endcode
|
|
*/
|
|
string_t string_get_formatted_number(const long long number, string_t separator);
|
|
|
|
/**
|
|
* @brief Returns a pointer to the last occurrence of character in the string.
|
|
*
|
|
* @param string_value
|
|
* @param character
|
|
* @since v1.0.0
|
|
*/
|
|
string_t string_get_last_occurence_of_character(const string_t string_value, char character);
|
|
|
|
/**
|
|
* @brief Check if a string starts with a substring.
|
|
*
|
|
* @param string_value
|
|
* @param prefix
|
|
* @return true if the string starts with the substring, false otherwise.
|
|
* @since v1.0.0
|
|
*/
|
|
bool string_starts_with(const string_t string_value, const string_t prefix);
|
|
|
|
/**
|
|
* @brief Check if a string ends with a substring.
|
|
*
|
|
* @param string_value
|
|
* @param prefix
|
|
* @return true if the string ends with the substring, false otherwise.
|
|
* @since v1.0.0
|
|
*/
|
|
bool string_ends_with(const string_t string_value, const string_t prefix);
|
|
|
|
#endif
|