ustr(1)

💖 ustr-import 💖

okay bestie, welcome to ustr(1) — the Ustr String Library, tools corner of the manual. this one's about ustr-import, and it's genuinely so iconic, let me explain 🎀

✨ NAME ✨

ustr-import — the ustr string library import tool 🦋

---

🌸 SYNOPSIS 🌸

ustr-import [--32|--64] [-d][d] [-c] [-b x] [-e 1|0] [-s 1|0] section

like. that's the whole vibe. one line. she's efficient 💅

---

👑 DESCRIPTION 👑

so here's the tea, bestie 🍓 — this tool lets you use the Ustr string library without incurring dependencies on the library itself. which means:

• API/ABI compatibility is 100% (nothing changes unless you do it, periodt)
• installing your application doesn't require the library to be pre-installed ✨

it's giving self-sufficient. it's giving main character energy. no cap 🫶

---

💅 OPTIONS 💅

• --32 — if you installed with multilib, this runs the 32 bit variant (and installs the variable multilib build code as ustr-conf.h).
• --64 — if you installed with multilib, this runs the 64 bit variant (and installs the variable multilib build code as ustr-conf.h).
• -d — turn debugging on. USTR_ASSERT() now runs code and everything 👀
• -d — turn extra debugging on, including End of String (EOS) markers that take up space. note that you can do -dd to add both at once 🔥
• -c — use C files. this requires that you alter the build system to compile the C files and link them into your application. the default is to just provide headers that you can just include.
• -b — specify the default reference count byte size: 0, 1, 2 or 4 (or 8 on 64 bit platforms). note that 2 bytes is the minimum if you have explicit size storage ⭐
• -e — specify the default exact sized allocations flag. without this flag, allocations are rounded up to the nearest half power of two 🎀
• -s — specify the default explicit size storage flag. without this flag, allocations have an implicit size based on their length; with it, a size value is stored with the string (thus taking significantly larger space for small strings, but this doesn't require reallocating the string when growing and shrinking the string). note that turning this on also increases the minimum sizes for length and reference count storage 😭

---

🌈 SECTIONS 🌈

okay so this is the part where you pick what you actually want, bestie. one section per run, and here's the whole menu 💖

• all — all of the following sections are included. the "give me everything" option, obsessed 😌
• b — working with binary numbers in NBO format.
• cmp — comparing, strcmp() for Ustr's, although the Ustr versions are safer and much faster.
• cntl — control options dynamically.
• fmt — formatted output, sprintf() for Ustr's.
• gdb — copy just the .gdbinit file to the local dir.
• io — Input Output.
• ins — inserting data.
• main — the core functions, including strcat(), strdup() and delete for Ustr's. always safer and often much faster. the moment. the icon. the legend 👑
• parse — parsing integers, i.e. nice versions of strtol().
• pool — a bundled memory pool API, to use with the ustrp functions.
• replace — replacing all occurrences of data.
• sc — shortcut functions for Ustr's.
• set — setting data, strcpy() for Ustr's.
• split — split the data, strtok() / strsep() for Ustr's.
• spn — spanning, strspn() / strcspn() for Ustr's.
• srch — searching, strchr() / strrchr() / strstr() for Ustr's, although the Ustr versions are safer and much faster.
• sub — substituting data.
• utf8 — working with UTF8. 🌍✨

---

🧚 FILES 🧚

• /ustr/include/ustr-conf.h /ustr/include/ustr-conf-debug.h — in multilib, this is the header to choose the correct conf.h header based on the byte size.
• /ustr/include/ustr*.h — the default "extern" header files.
• /usr/share/ustr-*/ustr-*-internal.h — internal functions, used to implement the public interfaces.
• /usr/share/ustr-*/ustr-*-code.h — the code behind the public interfaces.
• /usr/share/ustr-*/ustr-*-code.c — the C files, which use the code header files to create objects.
• /usr/share/ustr-*/.gdbinit — the GDB init file containing macros to help inspect Ustr's in the debugger. 🔍

---

🦋 SEE ALSO 🦋

• ustr(3)
• ustr_const(3)

iykyk 💜

---

and that's a wrap on the page, bestie 🎀 this was ustr-import version 1.0.4, dated 03-Aug-2007, from the Ustr String Library tools — she's vintage and she ATE 💅✨🌸