kpg1Kygp1

Creates a GRP group holding keyword/value pairs read from an AST KeyMap

Description:

This function is the inverse of kpg1Kymp1. It extracts the values from the supplied AST KeyMap and creates a set of " name=value" strings which it appends to a supplied group (or creates a new group). If the KeyMap contains nested KeyMaps, then the " name" associated with each primitive value stored in the returned group is a hierarchical list of component names separated by dots.

Invocation

void kpg1Kygp1( AstKeyMap ∗keymap, Grp ∗∗igrp, const char ∗prefix, int ∗status )

Arguments

keymap
A pointer to the KeyMap. Numerical entries which have bad values (VAL__BADI for integer entries or VAL__BADD for floating point entries) are not copied into the group.
igrp
A location at which is stored a pointer to the Grp structure to which the name=value strings are to be appended. A new group is created and a pointer to it is returned if the supplied Grp structure is not valid.
prefix
A string to append to the start of each key extracted from the supplied KeyMap. If NULL, no prefix is used.
status
Pointer to the inherited status value.

Notes: