ICLOEM(3NCARG)

💖 ICLOEM 💖

okay bestie, so this one is from the NCAR GRAPHICS manual, section 3NCARG, and it's genuinely so useful it's not even funny.

✨ NAME ✨

ICLOEM — the little function you call to get the length of the non-blank portion of an error message. that's it. that's the whole job. and it ate. 💅

---

🌸 SYNOPSIS 🌸

LNGTH = ICLOEM(MESSG)

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

int c_icloem(char *messg)

---

👑 DESCRIPTION 👑

so the value of the expression ICLOEM(MESSG) is the actual length of the non-blank portion of the input character variable MESSG. literally just how many real characters are in there before the padding starts.

which means MESSG(1:ICLOEM(MESSG)) gives you the non-blank part of MESSG. iconic. no cap.

lowkey important caveat, bestie: this assumes the non-blank part of MESSG is left-justified in the character string, with blank fill to the right. which is exactly the case for all NCAR Graphics error messages in calls to SETER. so if you're living that SETER life, you're fine. 🫶

the argument of ICLOEM is as follows:

• MESSG — an input variable or constant of type CHARACTER. most likely an error message returned by a reference to the function SEMESS. (yes, SEMESS. the girlies know. iykyk. 💜)

💜 C-BINDING DESCRIPTION 💜

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. same energy, different syntax. slay.

---

🌈 EXAMPLES 🌈

use the ncargex command to see the following relevant examples: tseter, arex02. go look at them. they're right there. obsessed. ✨

---

🎀 ACCESS 🎀

to use ICLOEM or c_icloem, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. don't get cute with the order, bestie, the order matters. 💀

---

⭐ SEE ALSO ⭐

Online: entsr, eprin, errof, error_handling, fdum, icfell, nerro, retsr, semess, seter, ncarg_cbind

like a whole friend group. icfell is literally her sibling (fell = length, em = message... the way they're a matched set 😭).

---

🍓 COPYRIGHT 🍓

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

---

okay that's the whole page, bestie!! 🌸🦋 this one was documented back in March 1994 and it lives in the UNIX manual, filed under ICLOEM(3NCARG), source NCAR GRAPHICS. she's been serving error-message-length realness since before we were born and honestly?? respect. periodt. 👑💖