// -*- mode: c++; c-basic-offset:4 -*-
// This file is part of libdap, A C++ implementation of the OPeNDAP Data
// Access Protocol.
// Copyright (c) 2002,2003 OPeNDAP, Inc.
// Author: James Gallagher <jgallagher@opendap.org>
//
// This library 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 2.1 of the License, or (at your option) any later version.
//
// This library 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 Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
//
// You can contact OPeNDAP, Inc. at PO Box 112, Saunderstown, RI. 02874-0112.
// (c) COPYRIGHT URI/MIT 1994-1999
// Please read the full copyright statement in the file COPYRIGHT.
//
// Authors:
// jhrg,jimg James Gallagher (jgallagher@gso.uri.edu)
// declarations for utility functions
//
// jhrg 9/21/94
#ifndef _util_h
#define _util_h 1
#include <cstdio>
#include <cmath>
#include <vector>
#ifndef _basetype_h
#include "BaseType.h"
#endif
using std::iostream;
namespace libdap
{
class Array;
/** Is \e lhs equal to \e rhs? Use epsilon to determine equality. */
inline bool double_eq(double lhs, double rhs, double epsilon = 1.0e-5)
{
return fabs(lhs - rhs) < epsilon;
}
string extract_string_argument(BaseType *arg) ;
double extract_double_value(BaseType *arg) ;
double *extract_double_array(Array *a) ;
void extract_double_array(Array *a, vector<double> &dest) ;
void set_array_using_double(Array *dest, double *src, int src_len) ;
bool is_host_big_endian();
string prune_spaces(const string &);
bool unique_names(vector<BaseType *> l, const string &var, const string &type, string &msg);
string systime();
const char *libdap_root();
extern "C" const char *libdap_version();
extern "C" const char *libdap_name();
#ifdef WIN32
void flush_stream(iostream ios, FILE *out);
#endif
void downcase(string &s);
bool is_quoted(const string &s);
string remove_quotes(const string &s);
Type get_type(const char *name);
string D2type_name(Type t);
string D4type_name(Type t);
string type_name(Type t);
bool is_simple_type(Type t);
bool is_vector_type(Type t);
bool is_constructor_type(Type t);
bool is_integer_type(Type t);
bool dir_exists(const string &dir);
// Jose Garcia
/** @name Integer to string conversion functions
Fast, safe conversions from long to a character representation which gets
appended to a string. This method will take a long value 'val' and it will
recursively divide it by 'base' in order to "extract" one by one the
digits which compose it; these digits will be <i>appended</i> to the
string <tt>str_val</tt> which will become the textual representation of
'val'. Please notice that the digits ``extracted'' from `val' will vary
depending on the base chosen for the conversion; for example val=15
converted to base 10 will yield the digits (1,5), converted to base 16
will yield (F) and converted to base 2 will yield (1,1,1,1).
@param val The long value we which to convert to string.
@param base A value in the range [2,36] which is the base to use while
transforming the long value 'val' to its textual representation. Typical
bases are 2 (binary), 10 (decimal) and 16 (hexadecimal).
@param str_val This is the string that will hold the textual
representation of 'val'. The string <tt>str_val</tt> should be
pre-set to an empty
string ("") otherwise the output of this function will just append the
textual representation of val to whatever data is there; these feature may
be useful if you wish to append a long value to a string s1 (just like
operator+ does) without having to create a new string object s2 and then
use string::operator+ between s1 and s2.
@return void. This method returns nothing however be aware that it will
throw and exception of type <tt>std::invalid_argument</tt> if the parameter
base is not in the valid range. */
//@{
void append_long_to_string(long val, int base, string &str_val);
string long_to_string(long val, int base = 10);
//@}
// Jose Garcia
/** @name Double to string conversion functions
Conversions from double to a character representation which gets appended
to a string. This function depends on the standard routine sprintf to
convert a double to a textual representation which gets appended to the
string 'str'.
@param num The double you wish to append to str.
@param str The string where the textual representation of num will be
appended.
@return void. */
//@{
void append_double_to_string(const double &num, string &str);
string double_to_string(const double &num);
//@}
string path_to_filename(string path);
int glob( const char *c, const char *s );
time_t parse_time(const char * str, bool expand);
bool size_ok(unsigned int sz, unsigned int nelem);
bool pathname_ok(const string &path, bool strict = true);
string dap_version();
string open_temp_fstream(ofstream &f, const string &name_template, const string &suffix = "");
} // namespace libdap
#endif