cddx_getdict - retrieve the DDS dictionary name


SYNOPSIS

#include "cdds.h"

const char * function cddx_getdict(bin_tag);

BIN_TAG bin_tag

DESCRIPTION

Routine, "cddx_getdict", returns the internal buffer Dictionary associated with the given bin_tag. If the binary is opened for output, then the output Dictionary is returned. This provides a way of modifying a dictionary after the binary has been written and closed. If an error occurs, the return value will be NULL.

NOTE: The returned address of the dictionary is pointing to a string memory location that is part of the binary structure. So after the binary get closed, that string memory if free'd up. Therefore, you will need to copy the dictionary name to another string before closing the binary.

AUTHOR

Jerry Ehlers, BP America (May 2003)