anyascii-zig

a Zig port of the anyascii C implementation.

Converts Unicode characters to their best ASCII representation AnyAscii provides ASCII-only replacement strings for practically all Unicode characters. Text is converted character-by-character without considering the context. The mappings for each script are based on popular existing romanization systems. Symbolic characters are converted based on their meaning or appearance. All ASCII characters in the input are left unchanged, every other character is replaced with printable ASCII characters. Unknown characters and some known characters are replaced with an empty string and removed.

This project uses Zig mach (0.14.0-dev.2577+271452d22) but it is also compatible with:

• Zig 0.13.0
• Zig master (as of 1/11/25)

Use in your project

# or pick a specific branch or commit
zig fetch --save https://github.com/sweetbbak/anyascii-zig/archive/refs/heads/main.zip

in build.zig:

// Add anyascii.zig dependency.
const anyascii = b.dependency("anyascii-zig", .{
    .target = target,
    .optimize = optimize,
});
exe.root_module.addImport("anyascii", anyascii.module("anyascii"));

Using the C library

build the shared library and the static library

zig build -Doptimize=ReleaseFast

install the given header file at include/anyascii.h and the shared object (or static object) to your prefered location

#include "../include/anyascii.h"

#include <stdio.h>
#include <stdlib.h>

static char* actual;

int main() {
    actual = malloc(256);
    anyascii(0xD55C, actual); // 한
    printf("anyascii: %s\n", actual);  // Han (Korean)

    char* output = malloc(256);
    anyascii_string("René François Lacôte", output);

    printf("anyascii_string: %s\n", output);
}

you can try out the simple example in the example directory:

zig build -Doptimize=ReleaseFast

gcc -o ascii example/anyascii.c \
    -Wall -Wextra -Werror -Os -fPIE \
    -I./include -L zig-out/lib \
    -l:libanyascii.a -lc

./ascii

Examples

links

upstream anyascii that this project is ported from: anyascii

used this project for reference: anyascii/go

learned about anyascii and got the idea from here: zigzedd/anyascii.zig