(3G) — Aviator 1.8

###############################################################################
#                                                                             #
#  Copyright © 1989-1991 by Artificial Horizons®, Inc.  All rights reserved.  #
#                                                                             #
#      This material  constitutes  the trade  secrets  and confidential,      #
#      proprietary information of Bruce Factor and Curtis Priem,  and is      #
#      under license  to Artificial Horizons, Inc.   The material is not      #
#      to be disclosed,  reproduced,  copied,  or used in any manner not      #
#      permitted under license from Artificial Horizons, Inc.   For more      #
#      information email "ahi-interest@ahi.com".                              #
#                                                                             #
###############################################################################

FBERROR(3G)          AVIATOR GRAPHICS INTERFACE FUNCTIONS           FBERROR(3G)



NAME
        fberror, fbclearerr, fbperror - AGI error message handlers

SYNOPSIS
        #include <agi.h>

        int fberror(fbp)
        register Fbuffer fbp;

        void fbclearerr(fbp)
        register Fbuffer fbp;

        void fbperror(fbp, s)
        register Fbuffer fbp;
        char *s;

DESCRIPTION
        fberror() returns non-zero when an error has occurred reading from or
        writing to the named frame buffer, otherwise it returns zero.  Unless
        cleared by fbclearerr(), the error indication lasts until the frame
        buffer is closed.

        fbclearerr() resets the error indication to zero on the named frame
        buffer.

        fbperror() produces a short error message on the standard error
        describing the last error encountered during a access to the frame
        buffer fbp.  If s is not a NULL pointer and does not point to a null
        string, the string it points to is printed, followed by a colon,
        followed by a space, followed by the message and a NEWLINE.  If s is a
        NULL pointer or points to a null string, just the message is printed,
        followed by a NEWLINE.  To be of most use, the argument string should
        include the name of the program that incurred the error.

PERFORMANCE
        fbp should be declared a register.

        Try to use fberror() and fbclearerr() only when developing programs.



AGI Release 1.8         Last change: 25 December 1991
Museum
