ARMVAM(3NCARG)

✨ ARMVAM — it's giving "move that area map, bestie" ✨

okay so welcome to the NCAR GRAPHICS manual page for ARMVAM, and honestly? this one is a whole vibe. it does exactly one thing and it does it flawlessly: it moves an area map from one integer array to another. that's it. that's the girl. 💅

---

💖 NAME 💖

ARMVAM — moves an area map from one integer array to another. no cap, that's literally the entire job description. 🫶

---

🎀 SYNOPSIS 🎀

CALL ARMVAM (IAM,IAN,LAN)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_armvam (int *iam, int *ian, int lan)

---

🌸 DESCRIPTION 🌸

so let's meet the cast, bestie, because every icon needs her entourage:

• IAM — (an input array of type INTEGER) — an array containing an area map that has at least been initialized by a call to ARINAM.

note, babes: as part of initializing the area map, ARINAM stores the dimension of MAP in MAP(1); therefore, the dimension does not have to be given as an argument in calls to ARMVAM. she already knows her own size, she's that self-aware. 💅

• IAN — (an input array, dimensioned LAN, of type INTEGER) — an array to which the area map in the array IAM is to be moved. this is the new home, the glow-up destination, the apartment she's moving into. 🏠✨
• LAN — (an input expression of type INTEGER) — the length of the array IAN. this may be less than or greater than the length of the array IAM. no rules, just range. 🔥

---

🧚 C-BINDING DESCRIPTION 🧚

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

---

✨ USAGE ✨

this routine may be used for two purposes, and both of them are valid and iconic:

1. to pack an area map down into the smallest possible space in the area map array — a little spring cleaning, a little declutter, main character energy 🧹✨
2. during recovery from an area map array overflow condition, to move the area map from a smaller array to a larger array — aka when she's outgrown her current situation and needs a bigger closet 💀👑

the area-map array IAM must at least have been initialized by a call to ARINAM, and it may have appeared in calls to one or more of AREDAM, ARPRAM, ARGTAI, ARDRLN, and ARSCAM. she's been around, she's got history, she's well-traveled. 🦋

important, fr fr: if the arrays IAM and IAN overlap in memory, they must start at the same location in memory. that's not a suggestion, bestie, that's the law. 🚨

---

🌈 EXAMPLES 🌈

use the ncargex command to see the following relevant examples: arex02. go look, it's cute, it'll make it click. 💖

---

👑 ACCESS 👑

to use ARMVAM or c_armvam, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. yes, order matters, she's particular like that. 🌸

---

😭 MESSAGES 😭

see the areas man page for a description of all Areas error messages and/or informational messages. if something's giving chaos, that's where the receipts live. 🧾

---

💀 SEE ALSO 💀

Online: areas, areas_params, ardbpa, ardrln, argeti, argetr, argtai, arinam, arpram, arscam, arseti, arsetr, ncarg_cbind

Hardcopy: NCAR Graphics Contouring and Mapping Tutorial

---

💅 COPYRIGHT 💅

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

---

okay bestie that's the whole page, you ate that. 🫶

this has been the UNIX manual page for ARMVAM(3NCARG), dated March 1993 — yes she's vintage, yes she still slays, periodt. 🌟