strutf8.h

Aller à la documentation de ce fichier.

 
#ifndef __CAKE_UTF8_H__
#define __CAKE_UTF8_H__
 
#include "def.h"
#include "strutf16.h"
#include "array.h"
 
typedef struct cake_string_utf8 {
    uchar *bytes;
    ulonglong size;
    ulonglong length;
} Cake_String_UTF8;
 
typedef struct cake_list_string_utf8 {
    Cake_ArrayList data;
    Cake_String_UTF8 **list;
} Cake_List_String_UTF8;
 
typedef struct cake_string_utf8_pair {
    Cake_String_UTF8 *key;
    Cake_String_UTF8 *value;
} Cake_String_UTF8_Pair;
 
typedef struct cake_linkedlist_string_utf8_pair {
    Cake_String_UTF8_Pair *pair;
    struct cake_linkedlist_string_utf8_pair *next;
} Cake_LinkedList_String_UTF8_Pair;
 
typedef struct cake_strutf8_reader {
    Cake_String_UTF8 *utf;
    ulonglong pos;
} Cake_String_UTF8_Reader;
 
/* =============================== */
/* ========== FONCTIONS ========== */
/* =============================== */
 
CAKE_C CAKE_API void cake_create_strutf8(Cake_String_UTF8 *utf);
 
CAKE_C CAKE_API Cake_String_UTF8 *cake_strutf8(const char *value);
 
CAKE_C CAKE_API void cake_free_strutf8(Cake_String_UTF8 *utf);
 
 
CAKE_C CAKE_API void cake_create_strutf8_reader_str(Cake_String_UTF8_Reader *dest, const char *str);
 
CAKE_C CAKE_API void cake_create_strutf8_reader_utf(Cake_String_UTF8_Reader *dest, Cake_String_UTF8 *utf);
 
CAKE_C CAKE_API void cake_strutf8_reader_skip_char(Cake_String_UTF8_Reader *reader, char value);
 
CAKE_C CAKE_API void cake_strutf8_reader_skip_achar(Cake_String_UTF8_Reader *reader, const char *values, ulonglong size);
 
CAKE_C CAKE_API Cake_String_UTF8 *cake_strutf8_reader_read_line(Cake_String_UTF8_Reader *reader);
 
CAKE_C CAKE_API Cake_String_UTF8_Pair *cake_strutf8_pair(const char *key, const char *value);
 
CAKE_C CAKE_API void cake_free_strutf8_pair(Cake_String_UTF8_Pair *pair);
 
CAKE_C CAKE_API Cake_String_UTF8 *cake_strutf8_pre_alloc(ulonglong size);
 
CAKE_C CAKE_API Cake_List_String_UTF8 *cake_list_strutf8();
 
CAKE_C CAKE_API cake_bool cake_strutf8_copy(Cake_String_UTF8 *dest, Cake_String_UTF8 *src);
 
CAKE_C CAKE_API uchar cake_strutf8_add_wchar(Cake_String_UTF8 *dest, wchar_t value);
 
CAKE_C CAKE_API void cake_strutf8_add_wchar_array(Cake_String_UTF8 *dest, const wchar_t *str);
 
CAKE_C CAKE_API cake_bool cake_strutf8_add_char_array(Cake_String_UTF8 *dest, const char *str);
 
CAKE_C CAKE_API cake_bool cake_strutf8_add_bytes(Cake_String_UTF8 *dest, const cake_byte *bytes, ulonglong size);
 
 
CAKE_C CAKE_API uchar cake_strutf8_insert_wchar(Cake_String_UTF8 *utf, ulonglong index, wchar_t value);
 
CAKE_C CAKE_API cake_bool cake_strutf8_insert_char_array(Cake_String_UTF8 *utf, ulonglong index, const char *str);
 
CAKE_C CAKE_API cake_bool cake_list_strutf8_add_char_array(Cake_List_String_UTF8 *list, const char *str);
 
CAKE_C CAKE_API cake_bool cake_list_strutf8_remove(Cake_List_String_UTF8 *list, ulonglong index);
 
CAKE_C CAKE_API cake_bool cake_list_strutf8_insert(Cake_List_String_UTF8 *list, ulonglong index, const char *str);
 
 
/* ===== Modification ===== */
 
CAKE_C CAKE_API void cake_strutf8_reverse(Cake_String_UTF8 *utf);
 
/* ===== Suppression ===== */
 
CAKE_C CAKE_API cake_bool cake_strutf8_remove_index(Cake_String_UTF8 *utf, ulonglong index);
 
CAKE_C CAKE_API ulonglong cake_strutf8_remove_all(Cake_String_UTF8 *utf, const char *value);
 
CAKE_C CAKE_API cake_bool cake_strutf8_remove_start(Cake_String_UTF8 *utf, const char *value);
 
CAKE_C CAKE_API cake_bool cake_strutf8_remove_from_to(Cake_String_UTF8 *utf, ulonglong fromIndex, ulonglong toIndex);
 
CAKE_C CAKE_API cake_bool cake_strutf8_remove_from_to_internal(Cake_String_UTF8 *utf, ulonglong fromIndex, ulonglong toIndex);
 
 
/* ===== Conversion ===== */
 
 
CAKE_C CAKE_API void cake_strutf8_to_utf16(Cake_String_UTF8 *src, Cake_String_UTF16 *dest);
 
CAKE_C CAKE_API cake_bool cake_char_array_to_strutf8(const char *src, Cake_String_UTF8 *dest);
 
CAKE_C CAKE_API int cake_strutf8_decode(const uchar *src, char bytes);
 
CAKE_C CAKE_API uchar cake_strutf8_wchar_to_byte(wchar_t value, uchar **buffer);
 
/*
        Version avancée de cake_strutf8_wchar_to_byte.
 
        Convertit un caractère UTF-16 en suite d'octets UTF-8 et
        les stocks directement dans le buffer destination.
*/
CAKE_C CAKE_API void cake_strutf8_wchar_to_byte_ext(wchar_t value, uchar **buffer, ulonglong *index);
 
// Convertit une chaîne UTF-16 en UTF-8.
CAKE_C CAKE_API void cake_strutf16_to_strutf8(Cake_String_UTF16 *src, Cake_String_UTF8 *dest);
 
// Pas besoin d'utiliser cake_create_strutf8.
// Par contre si cette fonction est utilisée plusieurs fois sur le même Cake_String_UTF8,
// alors il faut le free entre temps.
CAKE_C CAKE_API void cake_wchar_array_to_strutf8(const wchar_t *src, Cake_String_UTF8 *dest);
 
CAKE_C CAKE_API void cake_wchar_array_to_strutf8_len(Cake_String_UTF8 *dest, const wchar_t *src, ulonglong len);
 
 
CAKE_C CAKE_API ulonglong cake_strutf8_to_ulonglong(Cake_String_UTF8 *utf);
 
CAKE_C CAKE_API void cake_ulonglong_to_char_array(ulonglong value, char *buffer);
 
CAKE_C CAKE_API char *cake_ulonglong_to_char_array_dyn(ulonglong value);
 
CAKE_C CAKE_API float cake_strutf8_to_float(Cake_String_UTF8 *utf, char decimalSeparator);
 
/* ===== Cleaner ===== */
 
// Nettoie la chaîne UTF-8 en utilisant free et en remettant les valeurs à 0 et NULL.
CAKE_C CAKE_API void cake_clear_strutf8(Cake_String_UTF8 *utf);
 
CAKE_C CAKE_API void cake_free_list_strutf8(Cake_List_String_UTF8 *list);
 
 
/* ===== Recherches ===== */
 
/*
        Fonction interne !
        Cette fonction est une des premières qui a été faite et nécessite d'être refaite pour une utilisation plus simple.
 
        Permet de trouver l'adresse dans une chaîne UTF-8 par rapport à un index, étant donné qu'un caractère peut avoir plusieurs octets,
        faire utf[6] peut avoir des effets indésirables, cette fonction parcourt la chaîne et compte les index.
*/
CAKE_C CAKE_API ulonglong cake_strutf8_index_by_index(const uchar *pArrayStart, uchar *pArrayEnd, ulonglong utfIndex, uchar **pStart, uchar **pEnd, cake_byte *bytes);
 
CAKE_C CAKE_API ulonglong cake_strutf8_index_by_index_reverse(Cake_String_UTF8 *utf, ulonglong utfIndex, cake_byte *bytes);
 
CAKE_C CAKE_API uchar *cake_strutf8_search_from_end(Cake_String_UTF8 *utf, const char *research, ulonglong *internalIndex);
 
CAKE_C CAKE_API uchar *cake_strutf8_search_from_start(Cake_String_UTF8 *utf, const char *research, ulonglong *internalIndex);
 
CAKE_C CAKE_API ulonglong cake_str_search(const char *str, char value, uchar **ptr);
 
CAKE_C CAKE_API uchar *cake_str_search_array(const char *str, const char *value);
 
/* ===== Vérificateurs ===== */
 
// Vérifie que la chaîne UTF-8 termine avec la sous-chaîne passée.
CAKE_C CAKE_API cake_bool cake_strutf8_end_with(Cake_String_UTF8 *utf, const char *str);
// Vérifie que la chaîne UTF-8 commence avec la sous-chaîne passée.
CAKE_C CAKE_API cake_bool cake_strutf8_start_with(Cake_String_UTF8 *utf, const char *research);
 
// Vérifie que la chaîne de caractères commence avec la sous-chaîne passée.
CAKE_C CAKE_API cake_bool cake_str_starts_with(const char *src, const char *str);
 
// Vérifie que la chaîne UTF-8 soit exactement égale à la chaîne de caractères passée.
CAKE_C CAKE_API cake_bool cake_strutf8_equals(const Cake_String_UTF8 *utf, const char *compare);
 
 
/* ===== Création ===== */
 
 
CAKE_C CAKE_API Cake_List_String_UTF8 *cake_strutf8_split(Cake_String_UTF8 *utf, const char *delim);
 
/* ===== Remplacement ===== */
 
 
CAKE_C CAKE_API ulonglong cake_strutf8_replace_all(Cake_String_UTF8 *utf, const char *old, const char *replacement);
 
CAKE_C CAKE_API cake_bool cake_strutf8_replace_start(Cake_String_UTF8 *utf, const char *old, const char *replacement);
 
CAKE_C CAKE_API cake_bool cake_strutf8_replace_end(Cake_String_UTF8 *utf, const char *old, const char *replacement);
 
CAKE_C CAKE_API cake_bool cake_strutf8_replace_from_start(Cake_String_UTF8 *utf, const char *old, const char *replacement);
 
 
CAKE_C CAKE_API cake_bool cake_strutf8_replace_from_end(Cake_String_UTF8 *utf, const char *old, const char *replacement);
 
CAKE_C CAKE_API void cake_strutf8_to_lower(Cake_String_UTF8 *utf);
 
 
/* ===== Autres ===== */
 
CAKE_C CAKE_API ulonglong cake_strutf8_wchar_array_calc_size(const wchar_t *str);
 
CAKE_C CAKE_API ulonglong cake_strutf8_length(Cake_String_UTF8 *utf);
 
// Equivalent de strlen.
CAKE_C CAKE_API ulonglong cake_str_count(const char *str);
 
CAKE_C CAKE_API uint cake_str_hex_to_uint(const uchar *str);
 
CAKE_C CAKE_API void cake_strutf8_decode_url(Cake_String_UTF8 *utf);
 
CAKE_C CAKE_API uchar cake_strutf8_dec_to_char(uint value, uchar **buffer);
 
CAKE_C CAKE_API void cake_str_dec_to_hexchar(uchar value, uchar dest[2]);
 
CAKE_C CAKE_API cake_bool cake_str_equals(const char *str1, const char *str2);
 
CAKE_C CAKE_API ulonglong cake_str_number_of(const char *str, char value);
 
CAKE_C CAKE_API cake_bool cake_str_contains(const char *str, char value);
 
 
CAKE_C CAKE_API void cake_strutf8_vector_delete_callback(void *args);
CAKE_C CAKE_API void cake_strutf8_vector_delete_callback_ptr(void *args);
 
CAKE_C CAKE_API Cake_String_UTF8 *cake_strutf8_substring(Cake_String_UTF8 *from, ulonglong startIndex, ulonglong endIndex);
 
CAKE_C CAKE_API cake_bool cake_strutf8_set(Cake_String_UTF8 *dest, const char *value);
 
 
#endif