[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

UNPACK DATA RECORD (PHOP,*,*,*)

Purpose

Use Unpack Data Record to unpack a data record returned by FORTRAN binding input device inquiries. The data record unpacked by Unpack Data Record consists of a header identifying the number of integers, reals, and character strings in the data record, followed by the actual data. The graPHIGS API can interpret the output parameters by using the data record information supplied with the FORTRAN input device initialization subroutines.

For input, Unpack Data Record accepts a data record, array addresses for integer, real and character arrays, and size specifications for those arrays.

Unpack Data Record and Pack Data Record are inverse functions.

If the information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameters. If the information is unavailable, then the output parameters are unpredictable and the graPHIGS API sets the error indicator to one of the following errors:

2
Function Requires State (PHOP,*,*,*)
2001
Output Parameter Size Insufficient
2003
Invalid Data Record
2004
Input Parameter Size Out Of Range

Note:

This utility is defined only for the FOTRAN binding.

Language Bindings

FORTRAN

PUREC (ldr, datrec, iil, irl, isl, errind, il, ia, rl, ra, sl, lstr, str)

Input Parameters

integer ldr
Number of array elements used in datrec.

character*80 datrec(ldr)
Data record.

integer iil
Dimension of integer array.

integer irl
Dimension of real array.

integer isl
Dimension of character array.

Output Parameters

integer errind
Error indicator.

integer il
Number of integer entries.

integer ia (iil)
Array containing integer entries.

integer rl
Number of real entries.

real ra (irl)
Array containing real entries.

integer sl
Number of character string entries.

integer lstr(isl)
Length of each character string entry.

character*(*) str(isl)
Character string entries.

FORTRAN Subset

PUREC (ldr, datrec, iil, irl, isl, errind, il, ia, rl, ra, sl, lstr, str)

Input Parameters

integer ldr
Number of array elements used in datrec.

character*80 datrec(ldr)
Data record.

integer iil
Dimension of integer array.

integer irl
Dimension of real array.

integer isl
Dimension of character array.

Output Parameters

integer errind
Error indicator.

integer il
Number of integer entries.

integer ia (iil)
Array containing integer entries.

integer rl
Number of real entries.

real ra (irl)
Array containing real entries.

integer sl
Number of character string entries.

integer lstr(isl)
Length of each character string entry.

character*80 str(isl)
Character string entries.

Errors

None

Related Subroutines

  • Initialize Choice

  • Initialize Choice 3

  • Initialize Locator

  • Initialize Locator 3

  • Initialize Pick

  • Initialize Pick 3

  • Initialize String

  • Initialize String 3

  • Initialize Stroke

  • Initialize Stroke 3

  • Initialize Valuator

  • Initialize Valuator 3

  • Inquire Choice Device State

  • Inquire Choice Device State 3

  • Inquire Default Choice Device Data

  • Inquire Default Choice Device Data 3

  • Inquire Default Locator Device Data

  • Inquire Default Locator Device Data 3

  • Inquire Default Pick Device Data

  • Inquire Default Pick Device Data 3

  • Inquire Default String Device Data

  • Inquire Default String Device Data 3

  • Inquire Default Stroke Device Data

  • Inquire Default Stroke Device Data 3

  • Inquire Default Valuator Device Data

  • Inquire Default Valuator Device Data 3

  • Inquire Locator Device State

  • Inquire Locator Device State 3

  • Inquire Pick Device State

  • Inquire Pick Device State 3

  • Inquire String Device State

  • Inquire String Device State 3

  • Inquire Stroke Device State

  • Inquire Stroke Device State 3

  • Inquire Valuator Device State

  • Inquire Valuator Device State 3

  • Pack Data Record

    • [ Previous | Next | Contents | Glossary | Home | Search ]