Section 5.4.12.5. Names of internal routines

The following routines are used internally by later versions of CIFtbx. If these names are needed for other routines, then changes in the library will be needed to avoid conflicts.

(a) Variable initialization:

Critical CIFtbx variables are initialized with data statements in a block data routine.

(b) Control of floating-point exceptions:

If a system requires special handling of floating-point exceptions, the necessary calls should be added to this subroutine.

(c) Message processing:

Error and warning messages are processed through these three routines.

(d) Internal service routines:

These routines are used internally by the library. The subroutine dcheck validates names against dictionaries. The subroutines eotext and eoloop are used to ensure termination of loops and text strings. The subroutines getitm, getstr and getlin extract items, strings and lines from the input CIF. The subroutine putstr writes strings to the output CIF.

(e) Numeric routines:

The routine ctonum converts a string to a number and its standard uncertainty. The subroutine putnum converts a number and standard uncertainty to an output string.

(f) String manipulation:

The subroutine detab converts tabs to blanks. The function lastnb finds the column position of the last non-blank character in a string. The function locase converts a string to lower case.

(g) Hash-table processing:

These routines are used to manipulate the internal hash tables used by the library.