CHR(3)

🎀 NAME 🎀

chr — character constant conversion routines. Also hii bestie, this is the CHR(3) page, and we're about to make character constants make sense, periodt. 💅

✨ SYNOPSIS ✨

#include <ast.h>

int          chresc(const char* s, char** e);
int          chrtoi(const char* s);

🌸 DESCRIPTION 🌸

Okay so chresc converts and returns the next character constant in the 0-terminated string s. If e is not 0, then *e is set to point to the next character in s on return. When the end of s is reached, 0 is returned and e is not modified. 🫶

chrtoi converts the 0-terminated string s to an int and returns the value. The characters in s are converted in order from the left and shifted into the int value until up to the number of characters in an int is reached. This operation is inherently machine-dependent — highkey not universal — but at least it's defined in one place, which is a slay. ✨

The following \ escape sequences are recognized:

• \ooo — the character represented by the octal code ooo.
• \xxx — the character represented by the hex code xx.
• \a — alert (bell).
• \b — backspace.
• \f — formfeed.
• \n — newline.
• \r — carriage return.
• \t — horizontal tab.
• \v — vertical tab.
• \E — ESC (escape).
• \\ — backslash.

🚨 important vibe check: other characters following \ are undefined (although for backwards compatibility they translate to themselves). So like… don't build your whole personality on that, bestie. 😭

🦋 SEE ALSO 🦋

str(3) — go read it, iykyk. 💖

✨ okay that's the page! CHR(3) from the Library Functions Manual, and there's no date on this footer — iconic minimal behavior, ngl. catch you in the next manpage 💅🫶🌈