STRINGSIZE(3)

💖 STRINGSIZE(3) — Library Functions Manual edition 🫶

okay so bestie, this is the glow-up of the page for all the little string-measuring icons in the Library Functions Manual, and it's genuinely so useful — no cap 💅

🎀 NAME 🎀

The squad is stringsize, stringwidth, stringnwidth, runestringsize, runestringwidth, and runestringnwidth — and their whole thing is the graphical size of strings ✨

🌸 SYNOPSIS 🌸

#include <u.h>
#include <libc.h>
#include <draw.h>

Point stringsize(Font *f, char *s)

int   stringwidth(Font *f, char *s)

int   stringnwidth(Font *f, char *s, int n)

Point runestringsize(Font *f, Rune *s)

int   runestringwidth(Font *f, Rune *s)

int   runestringnwidth(Font *f, Rune *s, int n)

🦋 DESCRIPTION 🦋

Okay so these routines compute the geometrical extent of character strings when they're drawn on the display. The most straightforward one, stringsize, returns a Point representing the vector from upper left to lower right of the NUL-terminated string s drawn in font f. stringwidth returns just the x component. stringnwidth returns the width of the first n characters of s 💖

The routines beginning with rune are analogous, but they accept an array of runes rather than UTF-encoded bytes. Cute, right? 🧚

🌷 FILES 🌷

• /lib/font/bit — directory of fonts 🎀

🔥 SOURCE 🔥

The source lives at /src/libdraw — that's the spot, bestie 💅

👑 SEE ALSO 👑

• addpt(3)
• cachechars(3)
• subfont(3)
• draw(3)
• draw(3) — yes, it's listed twice on the page, and we're keeping it exactly like that, periodt 💀
• image(7)
• font(7)

💀 DIAGNOSTICS 💀

⚠️ heads up bestie: because strings are loaded dynamically, these routines may generate I/O to the server and produce calls to the graphics error function. That's the diagnostics tea ☕✨

okay bye bestie — footer sign-off: STRINGSIZE(3) from the Library Functions Manual, and no separate source/version or date was printed in the footer, so I'm not inventing one 💖✨