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);

size_t utf8_prefix_bytes_for_width(const char *str, size_t max_bytes, int max_width);

bool utf8_output_enabled(void);
 
/* ============================================================================
 * 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);
 
/* ============================================================================
 * UTF-8 String Search Functions
 * ========================================================================== */

const char *utf8_strcasestr(const char *haystack, const char *needle);

void utf8_write_lowercase(FILE *output, const char *text);