Previous: x/ zvtrans_in Up: Translation Routines Next: x/ zvtrans_inu

x/ zvtrans_inb

call xvtrans_inb(buf, stype, dtype, unit, status)
status = zvtrans_inb(buf, stype, dtype, unit);

Set up a translation buffer for input from the binary labels of a file. This routine is exactly like x/ zvtrans_in except that the SIHOST and SRHOST values are obtained for binary labels from the file specified by UNIT, which must be open. It is provided merely as a shortcut for the common case of reading binary label data from a labeled file.

Arguments:

• BUF: integer-array(12), output

  BUF is the translation buffer that this routine will set up, describing the translation to be performed.

• STYPE: string, input

  STYPE is the source data type. It corresponds to the FORMAT label item in a file, although binary label values are not restricted to FORMAT and may be of any data type. STYPE may be one of the standard VICAR data types: ``BYTE'', ``HALF'', ``FULL'', ``REAL'', ``DOUB'', or ``COMP''. The types ``WORD'', ``LONG'', and ``COMPLEX'' are also accepted, but are obsolete and should not be used.

• DTYPE: string, input

  DTYPE is the desired destination data type. It corresponds to the FORMAT label item in a file, although binary label values are not restricted to FORMAT and may be of any data type. DTYPE may be one of the standard VICAR data types: ``BYTE'', ``HALF'', ``FULL'', ``REAL'', ``DOUB'', or ``COMP''. The types ``WORD'', ``LONG'', and ``COMPLEX'' are also accepted, but are obsolete and should not be used.

• UNIT: integer, input

  UNIT is the unit number of an open file, which is used to obtain the source BINTFMT and BREALFMT. The values obtained from the file are used exactly like the x/ zvtrans_in SIHOST and SRHOST.

• STATUS: integer, output

  The returned status value. It is an argument in Fortran and the function return value in C. Any value other than SUCCESS indicates that the translation is invalid for some reason, and the translation buffer should not be used.