PLMKSTRM(3plplot)

📦
version 5.15.0 · 12 versions
, in ubuntu stonking

✨ PLMKSTRM (3plplot) — the PLplot API, bestie edition ✨

okay so we're diving into the PLplot API manual, specifically plmkstrm, and honestly? she's a little icon with a little baggage. let's get into it 💅

🌸 NAME 🌸

plmkstrm — creates a new stream and makes it the default. that's it, that's the whole gig. main character energy fr 🎀

🦋 SYNOPSIS 🦋

plmkstrm(p_strm)

short, sweet, slays. 💖

✨ DESCRIPTION ✨

So here's the tea: plmkstrm creates a new stream and makes it the default. periodt. 🔥

Now, how is she different from plsstrm(3plplot)? Well bestie, plsstrm makes you bring your own stream number, but plmkstrm is out here doing the work for you — a free stream number is found, and returned. iconic behavior, no cap. 👑

Unfortunately (and yes, the original doc literally says "unfortunately" 😭), I have to start at stream 1 and work upward, since stream 0 is preallocated. Like, stream 0 is taken, she's booked and busy, so we begin the search at 1 and climb from there. 🪜

And here's the deep lore: one of the big flaws in the PLplot API is that no initial, library-opening call is required. 💀 So because there's no "hey bestie, we're starting now" moment, stream 0 must be preallocated, and there is no simple way of determining whether it is already in use or not. Like... we just don't know. nobody knows. it's giving mystery. 🙈

Redacted form: plmkstrm(p_strm)

This function is used in examples 1 and 20. go look, i'll wait 🫶

💜 ARGUMENTS 💜

  • p_strm (PLINT_NC_SCALAR(3plplot), output) — the returned value of the stream number of the created stream. it's an output, so she hands you the number back — you don't bring your own. 🍓

🌈 AUTHORS 🌈

Many developers (who are credited at http://plplot.sourceforge.net/credits.php) have contributed to PLplot over its long history. shoutout to the whole squad, genuinely legends, every single one 🫡💖

⭐ SEE ALSO ⭐

PLplot documentation at http://plplot.sourceforge.net/documentation.php. go read, it's giving study date 📚✨

lowkey a reminder: nothing here is a suggestion to not read the docs — the docs are the moment, iykyk 🌸

alright bestie, that's the whole page 💅 — brought to you by the PLplot API man page, dated August, 2026, and delivered with love from your favorite unix-fluent gen z girlie. now go forth and stream responsibly 🎀🦋💖

📦 where this page comes from