libdap  Updated for version 3.17.0
Str.h
00001 
00002 // -*- mode: c++; c-basic-offset:4 -*-
00003 
00004 // This file is part of libdap, A C++ implementation of the OPeNDAP Data
00005 // Access Protocol.
00006 
00007 // Copyright (c) 2002,2003 OPeNDAP, Inc.
00008 // Author: James Gallagher <jgallagher@opendap.org>
00009 //
00010 // This library is free software; you can redistribute it and/or
00011 // modify it under the terms of the GNU Lesser General Public
00012 // License as published by the Free Software Foundation; either
00013 // version 2.1 of the License, or (at your option) any later version.
00014 //
00015 // This library is distributed in the hope that it will be useful,
00016 // but WITHOUT ANY WARRANTY; without even the implied warranty of
00017 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00018 // Lesser General Public License for more details.
00019 //
00020 // You should have received a copy of the GNU Lesser General Public
00021 // License along with this library; if not, write to the Free Software
00022 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
00023 //
00024 // You can contact OPeNDAP, Inc. at PO Box 112, Saunderstown, RI. 02874-0112.
00025 
00026 // (c) COPYRIGHT URI/MIT 1995-1999
00027 // Please read the full copyright statement in the file COPYRIGHT_URI.
00028 //
00029 // Authors:
00030 //      jhrg,jimg       James Gallagher <jgallagher@gso.uri.edu>
00031 
00032 // Interface for Str type.
00033 //
00034 // jhrg 9/7/94
00035 
00036 #ifndef _str_h
00037 #define _str_h 1
00038 
00039 #include <string>
00040 
00041 #include "dods-limits.h"
00042 #include "BaseType.h"
00043 
00044 namespace libdap
00045 {
00046 
00047 // max_str_len should be large since we always send strings with length bytes
00048 // as a prefix (so xdr_string will always know how much memory to malloc) but
00049 // if deserialize gets confused and thinks a ctor (in particular) is a string
00050 // xdr_string in turn will max_str_len if it cannot get a length byte. A long
00051 // term solution is to fix libdap, but strings should not routinely be > 32k
00052 // for the time being... jhrg 4/30/97
00053 
00054 const unsigned int max_str_len = DODS_USHRT_MAX - 1;
00055 
00062 class Str: public BaseType
00063 {
00064 protected:
00065     string d_buf;
00066 
00067 public:
00068     Str(const string &n);
00069     Str(const string &n, const string &d);
00070 
00071     virtual ~Str()
00072     {}
00073 
00074     Str(const Str &copy_from);
00075 
00076     Str &operator=(const Str &rhs);
00077 
00078     virtual BaseType *ptr_duplicate();
00079 
00080     virtual unsigned int width(bool constrained = false) const;
00081 
00082     // Return the length of the stored string or zero if no string has been
00083     // stored in the instance's internal buffer.
00084     virtual int length() const;
00085 
00086     // DAP2
00087     virtual bool serialize(ConstraintEvaluator &eval, DDS &dds, Marshaller &m, bool ce_eval = true);
00088     virtual bool deserialize(UnMarshaller &um, DDS *dds, bool reuse = false);
00089 
00090     // DAP4
00091     virtual void compute_checksum(Crc32 &checksum);
00092     virtual void serialize(D4StreamMarshaller &m, DMR &dmr, /*ConstraintEvaluator &eval,*/ bool filter = false);
00093     virtual void deserialize(D4StreamUnMarshaller &um, DMR &dmr);
00094 
00095     virtual unsigned int val2buf(void *val, bool reuse = false);
00096     virtual unsigned int buf2val(void **val);
00097 
00098     virtual bool set_value(const string &value);
00099     virtual string value() const;
00100 
00101     virtual void print_val(FILE *out, string space = "",
00102                            bool print_decl_p = true);
00103     virtual void print_val(ostream &out, string space = "",
00104                            bool print_decl_p = true);
00105 
00106     virtual bool ops(BaseType *b, int op);
00107 
00108     virtual void dump(ostream &strm) const ;
00109 };
00110 
00111 } // namespace libdap
00112 
00113 #endif // _str_h
00114