Next: Abstract

GRP

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

Starlink User Note 150.10
D.S. Berry
20th October 2012

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
- Debugging Routines
Routine Descriptions
- GRP_ALARM - Notify the user of an event in the life of a watched group
- 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_MSG - Assign an element of a group to a message token
- 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_SAME - Determine if two GRP identifiers refer to the same 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_SHOW - List contents ofa group to the screen
- GRP_SLAVE - Returns the identifier of the group which is owned by the specified group
- GRP_SOWN - Establish one group as the owner of another group
- GRP_VALID - Determine if a group identifier is valid
- GRP_WATCH - Watch for events in the life of a specified group
GRP Error Status Values
Packages Called From Within GRP
Acknowledgements
Changes and New Features in V3.7
Changes and New Features in V3.6
Changes and New Features in V3.5
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.7 Programmer's Manual

CCLRC / Rutherford Appleton Laboratory Particle Physics & Astronomy Research Council

Starlink Project

Contents

GRP

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

CCLRC / Rutherford Appleton Laboratory
Particle Physics & Astronomy Research Council