escaping.h
// -*- 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 1999
// Please read the full copyright statement in the file COPYRIGHT_URI.
//
// Authors:
// jhrg,jimg James Gallagher <jgallagher@gso.uri.edu>
// Declarations for identifier escaping and un-escaping functions.
#ifndef _escaping_h
#define _escaping_h
#include <string>
using std::string;
namespace libdap
{
string hexstring(unsigned char val);
string unhexstring(string s);
string octstring(unsigned char val);
string unoctstring(string s);
// The original set of allowed characters was: [0-9a-zA-Z_%]
// The characters accepted in DAP2 ids: [-+a-zA-Z0-9_/%.\\#*]; everything
// else must be escaped. Note that for some inscrutable reason, we've been
// escaping '*'.
// The characters allowable in an id in a URI (see RFC 2396):
// [-A-Za-z0-9_.!~*'()].
string id2www(string s, const string &allowable = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-+_/.\\*");
// This is what DAP2 allows in a ce: [-+a-zA-Z0-9_/%.\\#]
string id2www_ce(string s, const string &allowable = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-+_/.\\");
string www2id(const string &in, const string &escape = "%",
const string &except = "");
// Include these for compatibility with the old names. 7/19/2001 jhrg
#define id2dods id2www
#define dods2id www2id
string octal_to_hex(const string &octal_digits);
string id2xml(string in, const string &not_allowed = "><&'\"");
string xml2id(string in);
string esc2underscore(string s);
string char2ASCII(string s, const string escape = "%[0-7][0-9a-fA-F]");
string escattr(string s);
string unescattr(string s);
string munge_error_message(string msg);
string unescape_double_quotes(string source);
string escape_double_quotes(string source);
} // namespace libdap
#endif // _escaping_h
libdap::id2www_ce
string id2www_ce(string in, const string &allowable)
Definition: escaping.cc:178
libdap::id2xml
string id2xml(string in, const string &not_allowed)
Definition: escaping.cc:272
libdap::escape_double_quotes
string escape_double_quotes(string source)
Definition: escaping.cc:470
libdap
Definition: AlarmHandler.h:35
libdap::xml2id
string xml2id(string in)
Definition: escaping.cc:322
libdap::www2id
string www2id(const string &in, const string &escape, const string &except)
Definition: escaping.cc:220
libdap::esc2underscore
string esc2underscore(string s)
Definition: escaping.cc:354
libdap::unescattr
string unescattr(string s)
Definition: escaping.cc:407
libdap::id2www
string id2www(string in, const string &allowable)
Definition: escaping.cc:153
libdap::unescape_double_quotes
string unescape_double_quotes(string source)
Definition: escaping.cc:487
libdap::escattr
string escattr(string s)
Definition: escaping.cc:368