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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 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 00065 protected: 00066 string _buf; 00067 00068 public: 00069 Str(const string &n = ""); 00070 00071 virtual ~Str() 00072 {} 00073 00074 Str(const Str ©_from); 00075 00076 Str &operator=(const Str &rhs); 00077 00078 virtual BaseType *ptr_duplicate(); 00079 00080 virtual unsigned int width(); 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 unsigned int length(); 00085 00086 virtual bool serialize(const string &dataset, ConstraintEvaluator &eval, 00087 DDS &dds, Marshaller &m, bool ce_eval = true); 00088 virtual bool deserialize(UnMarshaller &um, DDS *dds, bool reuse = false); 00089 00090 virtual unsigned int val2buf(void *val, bool reuse = false); 00091 virtual unsigned int buf2val(void **val); 00092 00093 virtual bool set_value(const string &value); 00094 virtual string value() const; 00095 00096 virtual void print_val(FILE *out, string space = "", 00097 bool print_decl_p = true); 00098 virtual void print_val(ostream &out, string space = "", 00099 bool print_decl_p = true); 00100 00101 virtual bool ops(BaseType *b, int op, const string &dataset); 00102 00103 virtual void dump(ostream &strm) const ; 00104 }; 00105 00106 } // namespace libdap 00107 00108 #endif // _str_h 00109