SUN/31.5

Starlink Project
Starlink User Note 31.5

R.F. Warren-Smith &
A.J. Chipperfield

27 April 1998

REF
Routines for Handling References to HDS Objects

Version 1.1

Programmer’s Manual

Abstract

It is sometimes useful to use the Hierarchical Data System HDS (SUN/92) to store references or pointers to other HDS objects. For instance, this allows the same data object to be used in several places without the need to have more than one copy. The REF library is provided to facilitate this data object referencing process and the subsequent accessing of objects which have been referenced in this way.

1 Introduction
2 Facilities
3 Using the package
4 Implementation
5 Error handling
6 Compiling and linking
A Routine Descriptions

REF_ANNUL – Annul a locator to a referenced object

REF_CRPUT – Create and write a reference object

REF_FIND – Get locator to data object (via reference if necessary)

REF_GET – Get locator to referenced data object

REF_NEW – Create a new reference object

REF_PUT – Write a reference into a reference object

B ADAM/Stand-alone Differences
C Machine-dependent Features
D Software Dependencies

Abstract

Contents