|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
// -*- mode: c++; c-basic-offset:4 -*-
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
// This file is part of libdap, A C++ implementation of the OPeNDAP Data
|
|
Packit |
a4aae4 |
// Access Protocol.
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
// Copyright (c) 2002,2003 OPeNDAP, Inc.
|
|
Packit |
a4aae4 |
// Author: James Gallagher <jgallagher@opendap.org>
|
|
Packit |
a4aae4 |
//
|
|
Packit |
a4aae4 |
// This library is free software; you can redistribute it and/or
|
|
Packit |
a4aae4 |
// modify it under the terms of the GNU Lesser General Public
|
|
Packit |
a4aae4 |
// License as published by the Free Software Foundation; either
|
|
Packit |
a4aae4 |
// version 2.1 of the License, or (at your option) any later version.
|
|
Packit |
a4aae4 |
//
|
|
Packit |
a4aae4 |
// This library is distributed in the hope that it will be useful,
|
|
Packit |
a4aae4 |
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
Packit |
a4aae4 |
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Packit |
a4aae4 |
// Lesser General Public License for more details.
|
|
Packit |
a4aae4 |
//
|
|
Packit |
a4aae4 |
// You should have received a copy of the GNU Lesser General Public
|
|
Packit |
a4aae4 |
// License along with this library; if not, write to the Free Software
|
|
Packit |
a4aae4 |
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
Packit |
a4aae4 |
//
|
|
Packit |
a4aae4 |
// You can contact OPeNDAP, Inc. at PO Box 112, Saunderstown, RI. 02874-0112.
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
// (c) COPYRIGHT URI/MIT 1994-1999
|
|
Packit |
a4aae4 |
// Please read the full copyright statement in the file COPYRIGHT_URI.
|
|
Packit |
a4aae4 |
//
|
|
Packit |
a4aae4 |
// Authors:
|
|
Packit |
a4aae4 |
// jhrg,jimg James Gallagher <jgallagher@gso.uri.edu>
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
// Constants, types and function prototypes for use with the DAP parsers.
|
|
Packit |
a4aae4 |
//
|
|
Packit |
a4aae4 |
// jhrg 2/3/96
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
#ifndef _parser_h
|
|
Packit |
a4aae4 |
#define _parser_h
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
#ifndef _error_h
|
|
Packit |
a4aae4 |
#include "Error.h"
|
|
Packit |
a4aae4 |
#endif
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
#define YYDEBUG 1
|
|
Packit |
a4aae4 |
#undef YYERROR_VERBOSE
|
|
Packit |
a4aae4 |
#define YY_NO_UNPUT 1
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
#define ID_MAX 256
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
#ifndef TRUE
|
|
Packit |
a4aae4 |
#define TRUE 1
|
|
Packit |
a4aae4 |
#define FALSE 0
|
|
Packit |
a4aae4 |
#endif
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
namespace libdap
|
|
Packit |
a4aae4 |
{
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
/** <tt>parser_arg</tt> is used to pass parameters to the bison parsers and get
|
|
Packit |
a4aae4 |
error codes and objects in return. If <tt>status()</tt> is true, then the
|
|
Packit |
a4aae4 |
<tt>object()</tt> returns a pointer to the object built during the parse
|
|
Packit |
a4aae4 |
process. If <tt>status()</tt> is false, then the <tt>error()</tt>
|
|
Packit |
a4aae4 |
returns a pointer to an Error object.
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
Note that the <tt>object()</tt> mfunc returns a void pointer.
|
|
Packit |
a4aae4 |
@brief Pass parameters by reference to a parser.
|
|
Packit |
a4aae4 |
@brief Pass parameters by reference to a parser.
|
|
Packit |
a4aae4 |
*/
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
struct parser_arg
|
|
Packit |
a4aae4 |
{
|
|
Packit |
a4aae4 |
void *_object; // nominally a pointer to an object
|
|
Packit |
a4aae4 |
Error *_error; // a pointer to an Error object
|
|
Packit |
a4aae4 |
int _status; // parser status
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
parser_arg() : _object(0), _error(0), _status(1)
|
|
Packit |
a4aae4 |
{}
|
|
Packit |
a4aae4 |
parser_arg(void *obj) : _object(obj), _error(0), _status(1)
|
|
Packit |
a4aae4 |
{}
|
|
Packit |
a4aae4 |
virtual ~parser_arg()
|
|
Packit |
a4aae4 |
{
|
|
Packit |
a4aae4 |
if (_error) {
|
|
Packit |
a4aae4 |
delete _error; _error = 0;
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
void *object()
|
|
Packit |
a4aae4 |
{
|
|
Packit |
a4aae4 |
return _object;
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
void set_object(void *obj)
|
|
Packit |
a4aae4 |
{
|
|
Packit |
a4aae4 |
_object = obj;
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
Error *error()
|
|
Packit |
a4aae4 |
{
|
|
Packit |
a4aae4 |
return _error;
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
void set_error(Error *obj)
|
|
Packit |
a4aae4 |
{
|
|
Packit |
a4aae4 |
_error = obj;
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
int status()
|
|
Packit |
a4aae4 |
{
|
|
Packit |
a4aae4 |
return _status;
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
void set_status(int val = 0)
|
|
Packit |
a4aae4 |
{
|
|
Packit |
a4aae4 |
_status = val;
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
};
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
/** <tt>parser_error()</tt> generates error messages for the various
|
|
Packit |
a4aae4 |
parsers used by libdap. There are two versions of the
|
|
Packit |
a4aae4 |
function, one which takes a <tt>const char *message</tt> and a
|
|
Packit |
a4aae4 |
<tt>const int line_num</tt> and writes the message and line number
|
|
Packit |
a4aae4 |
too stderr and a second which takes an additional <tt>parser_arg
|
|
Packit |
a4aae4 |
*arg</tt> parameter and writes the error message into an Error
|
|
Packit |
a4aae4 |
object which is returned to the caller via the <tt>arg</tt>
|
|
Packit |
a4aae4 |
parameter.
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
\note{The second version of this function also accepts a third parameter
|
|
Packit |
a4aae4 |
(<tt>const char *context</tt>) which can be used to provide an
|
|
Packit |
a4aae4 |
additional line of information beyond what is in the string
|
|
Packit |
a4aae4 |
<tt>message</tt>.}
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
@name parse_error
|
|
Packit |
a4aae4 |
@return void
|
|
Packit |
a4aae4 |
@brief Generate error messages for the various parsers.
|
|
Packit |
a4aae4 |
*/
|
|
Packit |
a4aae4 |
//@{
|
|
Packit |
a4aae4 |
void parse_error(parser_arg *arg, const char *s, const int line_num = 0,
|
|
Packit |
a4aae4 |
const char *context = 0);
|
|
Packit |
a4aae4 |
void parse_error(const string &msg, const int line_num,
|
|
Packit |
a4aae4 |
const char *context = 0);
|
|
Packit |
a4aae4 |
//@}
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
} // namespace libdap
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
#include "parser-util.h"
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
#endif // _parser_h
|
|
Packit |
a4aae4 |
|