GQSGUS(3NCARG)

💖 GQSGUS — the "who's on the guest list rn?" of NCAR Graphics 💖

(that's a 3NCARG manual page, bestie — Inquire set of segment names in use)

okay so real talk, this one is genuinely one of the most useful little routines in the whole GKS friend group. GQSGUS literally retrieves what segment names are currently in use. that's it. that's the whole job. and it ate. 💅

---

✨ SYNOPSIS ✨

CALL GQSGUS(N,ERRIND,OL,SGNA)

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/gks.h>

void ginq_set_seg_names(Gint num_elems_appl_list, Gint start_pos, Gint
*err_ind, Gint_list *seg_names, Gint *length_list);

---

🌸 DESCRIPTION 🌸

bestie, let's go through the whole squad one by one, no skipping:

• N (Integer, Input) — the set member you're asking for. like, which one in the list, girl. 👑
• ERRIND (Integer, Output) — the vibe check result. if the GKS state is WSOP (workstation open), WSAC (workstation active), or SGOP (segment open), then ERRIND comes back as "0" — slay, we're good. otherwise ERRIND comes back as "7" and, um, not slay. 😭
• OL (Integer, Output) — literally just how many segment names are currently in use. the headcount. the number of girlies at the function. 💀
• SGNA (Integer, Output) — the actual name, the main character herself. if the GKS state is WSOP (workstation open), WSAC (workstation active), or SGOP (segment open), and if OL is larger than zero, then SGNA is returned as the name in the *N*th element of the list of segment names that are currently in use. otherwise? SGNA is undefined — like, it's not ghosting you on purpose, it just genuinely does not exist. 🙈

---

🎀 USAGE 🎀

for NCAR GKS, segment names are integers between 0 and 99 inclusive — go peek at the man page for GCRSG if you need the receipts. iykyk.

so, you want the whole list of every segment name currently in use? here's the routine, step by step, no cap:

1. first, figure out how many segment names are in use — make an initial call to GQSGUS with a first argument of "1". 🫶
2. if ERRIND comes back as "0", then OL will tell you how many segments are currently in use. periodt.
3. then, to get the actual list of all segment names currently in use, call GQSGUS in a loop on N from 1 to OL, and retrieve the N values of SGNA returned from such calls. boom. the whole guest list. 🔥

not me telling you to loop — yes bestie, you literally loop, that's the move, that's the whole vibe.

---

🌈 ACCESS 🌈

to use GKS routines, load the NCAR GKS-0A library ncarg_gks. load her. let her in. 💜

---

⭐ SEE ALSO ⭐

Online: gevtm, gactm, gclsg, gcrsg, gcsgwk, gqopsg, gdsg, gssgt., ginq_set_seg_names

Hardcopy: "User's Guide for NCAR GKS-0A Graphics"

(go read those too, they're all part of the same friend group, it's giving ✨lore✨)

---

👑 COPYRIGHT 👑

Copyright (C) 1987-2009 University Corporation for Atmospheric Research

The use of this Software is governed by a License Agreement.

okay so legally i have to be the responsible one here: that license agreement is not a vibe suggestion, it's real. respect her. 💖

---

and that's the page!! 🦋 from the UNIX girlies, March 1993, on the GQSGUS(3NCARG) tip — mwah, go get those segment names, bestie, you're gonna eat 💅✨🎀