Table of Contents

There are a series of "C" Convenience Routines that simplifies code development. These routines hide the underlying use of Dictionaries and double buffering from the developer that DDS uses to map external files to/from internal buffer binaries. In order to do this, the actual output binaries are not opened until the first attemp to do I/O on them at which point the underlying routines do a delayed open internally, hidden from the developer. The developer interface is made through the main input or output binary tag; the internal binary buffer and Dictionaries are referenced by DDS through this binary tag.

The Convenience Open and I/O Routines cannot be mixed with the basic DDS open, read and write routines. However the bin_tag returned by the Convenience Routines can be used with the other basic Binary Data Control Routines (cdds_isreg, cdds_lseek, cdds_fflush & cdds_close) as well as the Binary Field Access Routines (e.g. cdds_cdds_member, cdds_prec, cdds_index, cdds_getxx, etc.).

Open Routines

• cddx_in - open input (no headers)
  
• cddx_in2 - open input (pass headers)
  
• cddx_inhdr - open input (select headers)
  
• cddx_out - open output
  
• cddx_outhdr - open output (select headers)
  
• cddx_mod - reopen dataset
  
• cddx_mod2 - reopen dataset with headers
  

• cddx_read - read data
  
• cddx_readfrom - seek & read
  
• cddx_readall - read entire dataset
  
• cddx_write - write data
  
• cddx_writeto - seek & write
  

• cddx_dict - set dictionary mode
  
• cddx_addaxis - add an axis
  
• cddx_rmaxis - remove an axis
  
• cddx_index - get index to fields
  
• cddx_getbin - get external bin_tag
  
• cddx_getdict - get internal dictionary
  

NOTE: The Convenience Open Routines can only accept a single alias name unlike the basic DDS routines.