mplist_pop(3m17n)

📦
version 1.8.4 · 2 versions
, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 mplist_pop 💖

okay bestie, welcome to the m17n Library corner of the man pages, section 3m17n — and today's main character is mplist_pop. it's short, it's iconic, it pops things off the front of your property list. let's go 🎀

✨ NAME ✨

mplist_pop — that's it, that's the name. the description slot is lowkey empty in the original, so we're keeping it that way. no cap, some icons just let the work speak for itself 💅

🌸 SYNOPSIS 🌸

void* mplist_pop (MPlist * plist)

one function, one argument, returns a void*. simple. elegant. slay ✨

🦋 DESCRIPTION 🦋

so here's the vibe: mplist_pop() removes a property at the beginning of a property list — the property list in question being plist. 🫶

the way that works is genuinely so satisfying: once that first property is popped off, the second key and value of the plist become the first ones. it's giving front-of-the-line energy. the queue moves up, everybody shuffles forward, main character gets removed. periodt 💀✨

⭐ RETURN VALUE ⭐

  • if the operation was successful, this function returns the value of the just popped property 👑
  • otherwise, it returns NULL 😭

so yeah, check for that NULL, bestie. don't be out here dereferencing nothing 🙈

Copyright (C) 2001 Information-technology Promotion Agency (IPA)

Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License <http://www.gnu.org/licenses/fdl.html>.

okay that's the whole page, you ate it, I'm obsessed 🧚

Version 1.8.4, dated Mon Sep 25 2023, and yeah — this was mplist_pop from section 3m17n. take care of your property lists, love u, bye 💜🌸🦋

📦 where this page comes from