CHAR-GENERAL-CATEGORY(3scm)

🎀 char-general-category(3scm) — Scheme Programmer's Manual 🎀

okay bestie, welcome to the char-gen...-category(3scm) page from the Scheme Programmer's Manual 💅✨. This is the little Scheme procedure that does a whole vibe check on a character and tells you its Unicode general category. no cap, it's giving "small function, big Unicode energy."

🌸 NAME 🌸

char-general-category — Unicode character category 🦋

📚 LIBRARY 📚

(import (rnrs))                     ;R6RS
(import (rnrs unicode))             ;R6RS

✨ SYNOPSIS ✨

(char-general-category char)

💖 DESCRIPTION 💖

okay so this procedure returns a symbol representing the Unicode general category of char. That's the whole vibe: you hand it a character, it hands you back the category symbol. periodt. 💅

The category is one of the following symbols — all of them, bestie, we're not skipping a single one 👑:

• Lu — Letter, uppercase
• Ll — Letter, lowercase
• Lt — Letter, titlecase
• Lm — Letter, modifier
• Lo — Letter, other
• Mn — Mark, nonspacing
• Mc — Mark, spacing combining
• Me — Mark, enclosing
• Nd — Number, decimal digit
• Nl — Number, letter
• No — Number, other
• Pc — Punctuation, connector
• Pd — Punctuation, dash
• Ps — Punctuation, open
• Pe — Punctuation, close
• Pi — Punctuation, initial quote
• Pf — Punctuation, final
• Po — Punctuation, other
• Sm — Symbol, math
• Sc — Symbol, currency
• Sk — Symbol, modifier
• So — Symbol, other
• Zs — Separator, space
• Zl — Separator, line
• Zp — Separator, paragraph
• Cc — Other, control
• Cf — Other, format
• Cs — Other, surrogate
• Co — Other, private use
• Cn — Other, not assigned

🫶 RETURN VALUES 🫶

Returns a single symbol. that's it. one symbol. iconic. 💯

🌈 EXAMPLES 🌈

look at these cuties:

(char-general-category #\a)
   => Ll
(char-general-category #\space)
   => Zs
(char-general-category #\x10FFFF)
   => Cn

Ll for the lowercase a, Zs for space, and Cn for #\x10FFFF — the examples ate, fr fr. 🔥

🔥 APPLICATION USAGE 🔥

This procedure commonly appears in Scheme readers. Both R6RS and R7RS define the lexical syntax in terms of Unicode general categories. Another use is in algorithms for rendering text. ✨

That's literally main-character energy in a reader, iykyk.

💀 COMPATIBILITY 💀

This procedure is only present in R6RS (but any implementation that supports Unicode will necessarily have access to the data). The exact values returned will depend on which version of the Unicode database was used to generate the lookup tables. ngl, that's the fine print, bestie. 🙈

🚨 ERRORS 🚨

This procedure can raise exceptions with the following condition types:

• &assertion (R6RS) — The wrong number of arguments was passed or an argument was outside its domain.

not the vibe, but good to know 🫶.

👀 SEE ALSO 👀

char-alphabetic?(3scm)

go give your other Unicode bestie a look 💅.

⭐ STANDARDS ⭐

R6RS

💜 AUTHORS 💜

This page is part of the scheme-manpages project. It includes materials from the RnRS documents. More information can be found at https://github.com/schemedoc/manpages/.

---

made with 💖 from the char-gen...-category(3scm) besties, dated 2021-02-21 — bye bestie, go slay some Unicode 🫶✨