Daylight v4.9
Release Date: 1 February 2008

Name

dt_errorsave - store an error in the error queue

Generic Prototype

dt_errorsave(dt_String, dt_Integer, dt_String) => dt_Boolean

C Prototype

#include "dt_smiles.h"

dt_Boolean dt_errorsave(dt_String name, dt_Integer level, dt_String message)

FORTRAN Prototype

include 'dt_f_smiles.inc'

logical dt_f_errorsave(name, level, message)

character*() name
integer*4 level
character*() message

Description

Store the error message in the error queue with the severity 'level'. 'name' is printed in parenthesis after the error message by dt_errors(3). Valid values for 'level' are: 
  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

Always returns logical FALSE.

Related Topics

dt_errorclear(3) dt_errorworst(3) dt_errors(3) dt_smilinerrors(3)

Bugs

This function takes null-terminated strings.