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

x/ zvtrans_out

call xvtrans_out(buf, stype, dtype, dihost, drhost, status)
status = zvtrans_out(buf, stype, dtype, dihost, drhost);

Set up a translation buffer for output. The data will be converted from the machine's native representation and data type of STYPE into a host representation of (DIHOST,DRHOST) and data type of DTYPE. So, it converts from local to foreign format. Since all processing must be done in native format on the machine the program is running on, this this translation is most often needed for output to a file.

This routine will be much less commonly used than the input routines. The general rule for applications is to read any format, but write the native format. Translation on output is not needed in this case. However, x/ zvtrans_out is provided for special cases where the data must be written in a different host representation.