update ast 8.6.2

1 files changed, 111 insertions, 0 deletions

diff --git a/ast/err_null.c b/ast/err_null.c
new file mode 100644
index 0000000..72ca9ef
--- /dev/null
+++ b/ast/err_null.c
@@ -0,0 +1,111 @@
+/*
+*  Name:
+*     err_null.c
+
+*  Purpose:
+*     Implement the default "err" module.
+
+*  Description:
+*     This file implements the default "err" module for the AST
+*     library. It is used to deliver error messages if no alternative
+*     error delivery mechanism is provided.
+*
+*     To provide an alternative mechanism, re-implement the astPutErr
+*     function defined within this module. You can then either link
+*     your program against the resulting library, or you can register
+*     the re-implemented astPutErr function at run-time using the
+*     astSetPutErr function defined in file error.c.
+
+*  Copyright:
+*     Copyright (C) 1997-2006 Council for the Central Laboratory of the
+*     Research Councils
+
+*  Licence:
+*     This program is free software: you can redistribute it and/or
+*     modify it under the terms of the GNU Lesser General Public
+*     License as published by the Free Software Foundation, either
+*     version 3 of the License, or (at your option) any later
+*     version.
+*
+*     This program is distributed in the hope that it will be useful,
+*     but WITHOUT ANY WARRANTY; without even the implied warranty of
+*     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+*     GNU Lesser General Public License for more details.
+*
+*     You should have received a copy of the GNU Lesser General
+*     License along with this program.  If not, see
+*     <http://www.gnu.org/licenses/>.
+
+*  Authors:
+*     RFWS: R.F. Warren-Smith (STARLINK)
+*     {enter_new_authors_here}
+
+*  History:
+*     6-NOV-1996 (DSB):
+*        Original version.
+*     {enter_changes_here}
+*/
+
+/* Module Macros. */
+/* ============== */
+/* Define the astCLASS macro (even although this is not a class
+   implementation). This indicates to header files that they should
+   make "protected" symbols available. */
+#define astCLASS
+
+/* Include files. */
+/* ============== */
+/* Interface definitions. */
+/* ---------------------- */
+#include "err.h"                 /* Interface to this module */
+#include "error.h"               /* Interface to the error module */
+
+/* C header files. */
+/* --------------- */
+#include <stdio.h>
+
+/* Function implementations. */
+/* ========================= */
+void astPutErr_( int status_value, const char *message ) {
+/*
+*+
+*  Name:
+*     astPutErr
+
+*  Purpose:
+*     Deliver an error message.
+
+*  Type:
+*     Protected function.
+
+*  Synopsis:
+*     #include "err.h"
+*     void astPutErr( int status_value, const char *message )
+
+*  Description:
+*     This function delivers an error message and (optionally) an
+*     accompanying status value to the user. It may be re-implemented
+*     in order to deliver error messages in different ways, according
+*     to the environment in which the AST library is being used.
+
+*  Parameters:
+*     status_value
+*        The error status value.
+*     message
+*        A pointer to a null-terminated character string containing
+*        the error message to be delivered. This should not contain
+*        newline characters.
+
+*  Notes:
+*     - This function is documented as "protected" but, in fact, is
+*     publicly accessible so that it may be re-implemented as
+*     required.
+*-
+*/
+
+
+/* This is the default implementation. Simply write the message to
+   standard error with a newline appended. Ignore the status value. */
+   int *status = astGetStatusPtr;
+   (void) fprintf( stderr, "%s%s\n", astOK ? "!! " : "!  ", message );
+}