RKCVTHAN(3)

💖 RKCVTHAN — okay bestie, let's talk character conversion 💖

So this is a page from the Library Functions Manual, and it's all about RkCvtHan and RkwCvtHan. Two icons, one job. Let's get into it. ✨

🌸 NAME 🌸

RkCvtHan, RkwCvtHan — these cuties convert double-width symbols, alphanumeric characters, hiragana, and katakana into single-width characters. That's the whole vibe. 💅

🎀 SYNOPSIS 🎀

#include <canna/RK.h>
int RkCvtHan(dst, maxdst, src, srclen)
unsigned char *dst;
int maxdst;
unsigned char *src;
int srclen;
int RkwCvtHan(dst, maxdst, src, srclen)
wchar_t *dst;
int maxdst;
wchar_t *src;
int srclen;

Like, look at them. So tidy. 🫶

🦋 DESCRIPTION 🦋

Okay so RkCvtHan takes the srclen bytes of your double-width symbol, alphanumeric, hiragana, and katakana data and converts them to single-width characters, starting from the area at src. Lowkey a glow-up for your text. 💖

Heads up bestie: a null character in src is not treated as the end of the string. She does not stop for nulls. Periodt.

The conversion result goes into the area dst. Characters that aren't subject to conversion get copied over exactly as they are — no notes, no changes, we respect them. 👑

When the byte length of the result would exceed maxdst -1, the conversion result gets truncated so it lines up with character boundaries in the EUC code. And dst gets padded with null characters at the end if possible. Both src and dst are represented using EUC code. iykyk.

RkwCvtHan is literally just the wchar_t version of RkCvtHan. Same energy, different type. The arguments that specify a length are regarded as counting character length instead of byte length. 🌈

And here's the wild part — NULL can be specified in dst. When you do that, NULL overrides the entire conversion result. Like, no result for you. 💀

🔥 RETURN VALUE 🔥

This function returns the byte length of the conversion result — or the character length if you're using RkwCvtHan. 🎀

But if the value of maxdst is invalid? It returns 0. That's it. That's the whole story. 😭

💜 SEE ALSO 💜

(no cap, the original doesn't list any other pages here — just the vibes)

This was RKCVTHAN(3) from the Library Functions Manual, brought to you with love, and no cap whatsoever. Thanks for reading bestie, you ate. 💅✨🦋🎀💖