Next: Abstract

GRP

Routines for Managing Groups of Objects
Version 3.4
Programmer's Manual

Starlink User Note 150.8
D.S. Berry
21st October 2009

CCLRC / Rutherford Appleton Laboratory
Particle Physics & Astronomy Research Council

Starlink Project

Retrieve hardcopy

Abstract
Introduction
- Facilities Provided by GRP
- An Example of a Simple GRP Application
  - Example Code
  - Examples of Possible User Responses
    - Indirection.
    - Modification.
Names
- Case Sensitivity
Groups and Group Identifiers
Group Expressions
- Elements and Delimiters
- Editing of Names
- Indirection Elements
- Modification Elements
- Nesting Within Group Expressions
- Flagging a Group Expression
- Comments Within Group Expressions
- Escaping the Special Characters in a Group Expression
- The Order of Names Within a Group
Using GRP Routines
- Symbolic Constants and Status Values
- Creating and Deleting Groups
- Storing Names in a Group
- Retreiving Names from a Group
- Retrieving Attributes of Names
- Deleting Names
- Changing the Characters Used to Control the Syntax of Group Expressions
  - Suppressing the Use of Selected Control Characters
- Creating Associations Between Groups
Compiling and Linking
Alphabetical List of Routines
Classified List of Routines
- Creating and Deleting Groups
- Enquiring Group Attributes
- Setting Group Attributes
- Enquiring Name Attributes
- Retreiving Names
- Storing Names
- Deleting Names
- Creation and Control of Identifiers
- ADAM Parameter System Routines
Routine Descriptions
- GRP_COPY - Copy a section of an existing group to a new group
- GRP_DELET - Delete a group from the GRP system
- GRP_GET - Returns a set of names contained in a group
- GRP_GETCC - Returns requested control characters for the specified group
- GRP_GETCS - Determine the case sensitivity of a group
- GRP_GROUP - Append a list of names obtained from the environment to a previously created group
- GRP_GRPEX - Append a list of names contained within a supplied group expression to a previously created group
- GRP_GRPSZ - Returns the number of names in a group
- GRP_GTYPE - Retrieve the type string stored with a group
- GRP_HEAD - Finds the group which is at the head of an owner-slave chain
- GRP_INDEX - Searches for a given name and if found, returns its index
- GRP_INFOC - Retrieve an item of character information about a name
- GRP_INFOI - Retrieve an item of integer information about a name
- GRP_LIST - Write names to a text file specified by the environment
- GRP_LISTF - Write names to a specified text file
- GRP_NEW - Create a new empty group
- GRP_OWN - Returns the identifier of the group which owns the specified group
- GRP_PTYPE - Associate a new type string with a group
- GRP_PURGE - Purge duplicate entries from a group
- GRP_PUT - Put a given set of literal names into a group
- GRP_PUT1 - Put a single name into a group
- GRP_REMOV - Remove all occurrences of a given name from a group
- GRP_SETCC - Sets requested control characters for the specified group
- GRP_SETCS - Establish the case sensitivity of a group
- GRP_SETSZ - Reduce the size of a group
- GRP_SOWN - Establish one group as the owner of another group
- GRP_VALID - Determine if a group identifier is valid
GRP Error Status Values
Packages Called From Within GRP
Acknowledgements
Changes and New Features in V3.4
Changes and New Features in V3.3
Changes and New Features in V3.2
Changes and New Features in V3.1
Changes and New Features in V3.0
Changes and New Features in V2.0
Changes and New Features in V1.1
About this document ...

Next: Abstract

GRP Routines for Managing Groups of Objects Version 3.4 Programmer's Manual

CCLRC / Rutherford Appleton Laboratory Particle Physics & Astronomy Research Council

Starlink Project

Contents

GRP

Routines for Managing Groups of Objects
Version 3.4
Programmer's Manual

CCLRC / Rutherford Appleton Laboratory
Particle Physics & Astronomy Research Council