STSETC(3NCARG)

💫 STSETC — the NCAR Graphics glow-up 💫

okay bestie, gather round 🎀 this is a page from the NCAR GRAPHICS manual, and today we're learning about STSETC from section 3NCARG. It's the routine that sets the value of a Streamlines parameter of type CHARACTER. she's giving librarian-with-a-pastel-highlighter energy and honestly? iconic.

---

✨ NAME ✨

STSETC — Sets the value of a Streamlines parameter of type CHARACTER. literally that's it, that's the whole job, and she does it flawlessly 💅

---

🌸 SYNOPSIS 🌸

CALL STSETC (CNM,CVL)

that's the whole vibe right there — two args, no drama, no notes.

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_stsetc (char *cnm, char *cvl)

for my C girlies: same energy, lowercase name, char * everywhere. slay.

---

💖 DESCRIPTION 💖

• CNM (CHARACTER, input) — this is the name of the parameter you're about to hand a character value to. Important tea: only the first three characters of CNM actually get examined, so don't get cute with the rest of it. Those three characters have to be either entirely uppercase or entirely lowercase — mixed case is not recognized, periodt. 💀 And listen, the manual recommends you use the leftover characters to make your code readable for future-you (who will absolutely forget what any of this meant). Like, instead of ZFT, write ZFT - Zero Field Text String. ngl that's just good manners to your future self 🫶
• CVL (CHARACTER, input) — an expression, and the value of that expression is what gets handed to the parameter that CNM names. simple. clean. no cap.

🌈 C-BINDING DESCRIPTION 🌈

The C-binding argument descriptions are the same as the FORTRAN argument descriptions. same facts, different font, bestie — nothing new to learn here ✨

---

🔥 USAGE 🔥

This routine lets you set the current value of Streamlines parameters that are of type CHARACTER. That's the whole mission statement.

For a complete list of parameters available in this utility, go see the streamlines_params man page. yes, the full menu, go read it, I'll wait 🍓

---

⭐ EXAMPLES ⭐

Use the ncargex command to see the following relevant examples: fcover, ffex00. go look at them, they're right there, they're free 💅

---

🎀 ACCESS 🎀

To use STSETC or c_stsetc, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. order matters, bestie, don't freestyle it 🙈

---

💌 MESSAGES 💌

See the streamlines man page for a description of all Streamlines error messages and/or informational messages. if something goes sideways, that's where the receipts live 😭

---

👑 SEE ALSO 👑

• Online: stgetc, stgeti, stgetr, stinit, stream, streamlines, streamlines_params, strset, stseti, stsetr, stuixy, stumsl, stumta, stumxy, ncarg_cbind. the whole friend group, all tagged ✨
• Hardcopy: NCAR Graphics Fundamentals, UNIX Version for when you want the physical lore 📖

---

🦋 COPYRIGHT 🦋

Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.

keep this part exactly as it is, bestie — it's the legal tea and it is not ours to remix 💜

---

reminder: this page is from the UNIX manual, dated April 1993, under the manual name NCAR GRAPHICS, section 3NCARG. the header said STSETC(3NCARG) and the footer said UNIX / April 1993 / STSETC(3NCARG) — so there you go, the whole origin story 🌸

k byeee, go set some character parameters, you absolute main character 💖✨🎀🦋🌸💅🫶