utf8.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
#include <stddef.h>
#include <stdbool.h>
#include <stdio.h>
 
/* ============================================================================
 * UTF-8 Decoding Functions
 * ========================================================================== */
 
int utf8_decode(const uint8_t *s, uint32_t *codepoint);
 
/* ============================================================================
 * UTF-8 Display Width Calculation
 * ========================================================================== */
 
int utf8_display_width(const char *str);
 
int utf8_display_width_n(const char *str, size_t max_bytes);
 
/* ============================================================================
 * UTF-8 Validation Functions
 * ========================================================================== */
 
bool utf8_is_valid(const char *str);
 
bool utf8_is_ascii_only(const char *str);
 
size_t utf8_char_count(const char *str);
 
size_t utf8_to_codepoints(const char *str, uint32_t *out_codepoints, size_t max_codepoints);
 
int utf8_next_char_bytes(const char *str, size_t max_bytes);
 
int utf8_continuation_bytes_needed(unsigned char first_byte);
 
int utf8_read_and_insert_continuation_bytes(char *buffer, size_t *cursor, size_t *len, size_t max_len,
                                            int continuation_bytes, int (*read_byte_fn)(void));
 
/* ============================================================================
 * UTF-8 String Search Functions
 * ========================================================================== */
 
const char *utf8_strcasestr(const char *haystack, const char *needle);
 
void utf8_write_lowercase(FILE *output, const char *text);