Initial commit

README.md

@@ -0,0 +1,56 @@
+# CgeStr - Unicode String Library for C
+
+A lightweight, dependency-free C library for UTF-8 string processing with full
+Unicode support.
+
+## Features
+
+- UTF-8 encoding and decoding
+- UTF-16 encoding and decoding
+- Unicode case mapping: lowercase, uppercase, titlecase, case folding
+- Full case mapping functions returning multiple runes when needed
+- Character classification: isControl, isDigit, isLetter, isSpace, and others
+- Unicode category lookup via `CgeRuneCategory`
+- Case-sensitive and case-insensitive string comparison
+- Substring and rune search
+- Prefix and suffix checking
+- String trimming (left, right, both)
+- String splitting by rune
+- Iteration over Unicode code points using callback interface
+
+## Build Systems
+
+- CMake - supports Linux, macOS, Windows (MSVC, MinGW)
+- Makefile.posix - for GCC/Clang on POSIX systems
+- Makefile.mingw - for MinGW on Windows
+- Makefile.win32 - for MSVC with NMake
+
+Builds a static library. No shared library or external dependencies.
+
+## Usage Example
+
+```c
+#include "CgeStr.h"
+#include <stdio.h>
+
+void print_rune(uint32_t rune, void* user) {
+    printf("U+%04X ", rune);
+}
+
+int main() {
+    CgeStr str = CGE_STR_LIT("Héllo, 世界!");
+    CgeStrIter(str, print_rune, NULL);
+    printf("\n");
+    return 0;
+}
+```
+
+## Portability
+
+- Written in C89+stdint.h
+- No dynamic memory allocation
+- No external dependencies
+
+## License
+
+0BSD - a permissive license with no attribution required.