shishi_key_value_set(3)

📦
version 1.0.3 · 2 versions
  • 1.0.3 · debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.0.2 · ubuntu jammy
, in debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ NAME ✨

shishi_key_value_set — bestie, this is an API function from the shishi manual (section 3, library calls only, we're fancy like that 💅). It sets the value of a key. That's it. That's the whole gig.

🌸 SYNOPSIS 🌸

#include <shishi.h>

void shishi_key_value_set(Shishi_key * key, const char * value);

Like, it returns void. No return value. Nothing to check. She simply does the thing and leaves. 👑

🎀 ARGUMENTS 🎀

  • Shishi_key * key — the structure that holds key information. This is the one getting its glow-up. ✨
  • const char * value — an input array with key data. The raw material, the ingredients, the ~content~.

💖 DESCRIPTION 💖

Okay so here's the tea: this function sets the key value and the length in the key structure. Both. At once. Multitasking queen behavior. 💅

And the way it works? The value gets copied into the key. Which means — and this is the part everyone always asks about — you can totally deallocate value right after calling this function, and the value inside the key will be completely fine. Not modified. Not haunted. Not giving "dangling pointer" at all. 🫶

no cap, the copy is doing the heavy lifting so you don't have to 🧚

😭 REPORTING BUGS 😭

Found a bug? Spill it to <bug-shishi@gnu.org>. They wanna know. fr fr.

Copyright © 2002-2022 Simon Josefsson.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

(Translation: take it, share it, remix it, just keep the receipt. 🧾✨)

🌈 SEE ALSO 🌈

The full documentation for shishi is maintained as a Texinfo manual. If the info and shishi programs are properly installed at your site, the command

info shishi

should give you access to the complete manual. Iconic. Go read it. 📖💜

shishi version 1.0.3, page shishi_key_value_set(3) — mwah, that's a wrap, bestie 🎀🦋💖

📦 where this page comes from