Daylight v4.9
Release Date: 1 February 2008

Name

dt_errors - retrieve errors of severity or greater

Generic Prototype

dt_errors(dt_Integer) => dt_Handle

C Prototype

#include "dt_smiles.h"

dt_Handle dt_errors(dt_Integer level)

FORTRAN Prototype

include 'dt_f_smiles.inc'

integer*4 dt_f_errors(level)

integer*4 level

Description

Selects all errors of severity 'level' or worse and returns them as a sequence of string objects. Valid values for 'level' are: 
  DX_ERR_NONE   No error
  DX_ERR_NOTE   Note, informative message
  DX_ERR_WARN   Warning, unusual condition encountered
  DX_ERR_ERROR  An error was detected
  DX_ERR_FATAL  Very serious, toolkit probably can't continue

Return Value

Returns a handle to a sequence of string objects. The sequence and string objects are newly-allocated copies of the internal error queue and are not affected by operations on the internal queue.

It is the responsibility of the calling function to deallocate the sequence object and all of the string objects it contains.

Related Topics

dt_errorclear(3) dt_errorworst(3) dt_errorsave(3) dt_smilinerrors(3)