libdap Updated for version 3.20.10
libdap4 is an implementation of OPeNDAP's DAP protocol.
Str.h
1
2// -*- mode: c++; c-basic-offset:4 -*-
3
4// This file is part of libdap, A C++ implementation of the OPeNDAP Data
5// Access Protocol.
6
7// Copyright (c) 2002,2003 OPeNDAP, Inc.
8// Author: James Gallagher <jgallagher@opendap.org>
9//
10// This library is free software; you can redistribute it and/or
11// modify it under the terms of the GNU Lesser General Public
12// License as published by the Free Software Foundation; either
13// version 2.1 of the License, or (at your option) any later version.
14//
15// This library is distributed in the hope that it will be useful,
16// but WITHOUT ANY WARRANTY; without even the implied warranty of
17// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18// Lesser General Public License for more details.
19//
20// You should have received a copy of the GNU Lesser General Public
21// License along with this library; if not, write to the Free Software
22// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
23//
24// You can contact OPeNDAP, Inc. at PO Box 112, Saunderstown, RI. 02874-0112.
25
26// (c) COPYRIGHT URI/MIT 1995-1999
27// Please read the full copyright statement in the file COPYRIGHT_URI.
28//
29// Authors:
30// jhrg,jimg James Gallagher <jgallagher@gso.uri.edu>
31
32// Interface for Str type.
33//
34// jhrg 9/7/94
35
36#ifndef _str_h
37#define _str_h 1
38
39#include <string>
40
41#include "dods-limits.h"
42#include "BaseType.h"
43
44namespace libdap
45{
46
47// max_str_len should be large since we always send strings with length bytes
48// as a prefix (so xdr_string will always know how much memory to malloc) but
49// if deserialize gets confused and thinks a ctor (in particular) is a string
50// xdr_string in turn will max_str_len if it cannot get a length byte. A long
51// term solution is to fix libdap, but strings should not routinely be > 32k
52// for the time being... jhrg 4/30/97
53
54const unsigned int max_str_len = DODS_USHRT_MAX - 1;
55
62class Str: public BaseType
63{
64protected:
65 string d_buf;
66
67public:
68 Str(const string &n);
69 Str(const string &n, const string &d);
70
71 virtual ~Str()
72 {}
73
74 Str(const Str &copy_from);
75
76 Str &operator=(const Str &rhs);
77
78 virtual BaseType *ptr_duplicate();
79
80 virtual unsigned int width(bool constrained = false) const;
81
82 // Return the length of the stored string or zero if no string has been
83 // stored in the instance's internal buffer.
84 virtual int length() const;
85
86 // DAP2
87 virtual bool serialize(ConstraintEvaluator &eval, DDS &dds, Marshaller &m, bool ce_eval = true);
88 virtual bool deserialize(UnMarshaller &um, DDS *dds, bool reuse = false);
89
90 // DAP4
91 virtual void compute_checksum(Crc32 &checksum);
92 virtual void serialize(D4StreamMarshaller &m, DMR &dmr, /*ConstraintEvaluator &eval,*/ bool filter = false);
93 virtual void deserialize(D4StreamUnMarshaller &um, DMR &dmr);
94
95 virtual unsigned int val2buf(void *val, bool reuse = false);
96 virtual unsigned int buf2val(void **val);
97
98 virtual bool set_value(const string &value);
99 virtual string value() const;
100
101 virtual void print_val(FILE *out, string space = "",
102 bool print_decl_p = true);
103 virtual void print_val(ostream &out, string space = "",
104 bool print_decl_p = true);
105
106 virtual bool ops(BaseType *b, int op);
107 virtual bool d4_ops(BaseType *b, int op);
108
109 virtual void dump(ostream &strm) const ;
110};
111
112} // namespace libdap
113
114#endif // _str_h
115
Definition crc.h:77
The basic data type for the DODS DAP types.
Definition BaseType.h:118
Evaluate a constraint expression.
Marshaller that knows how to marshal/serialize dap data objects to a C++ iostream using DAP4's receiv...
Read data from the stream made by D4StreamMarshaller.
abstract base class used to marshal/serialize dap data objects
Definition Marshaller.h:50
Holds character string data.
Definition Str.h:63
virtual bool d4_ops(BaseType *b, int op)
Definition Str.cc:313
virtual bool serialize(ConstraintEvaluator &eval, DDS &dds, Marshaller &m, bool ce_eval=true)
Move data to the net, then remove them from the object.
Definition Str.cc:131
Str(const string &n)
Definition Str.cc:84
virtual bool deserialize(UnMarshaller &um, DDS *dds, bool reuse=false)
Receive data from the net.
Definition Str.cc:156
virtual void print_val(FILE *out, string space="", bool print_decl_p=true)
Prints the value of the variable.
Definition Str.cc:266
virtual BaseType * ptr_duplicate()
Definition Str.cc:103
virtual bool ops(BaseType *b, int op)
Evaluate relational operators.
Definition Str.cc:285
virtual int length() const
How many elements are in this variable.
Definition Str.cc:119
virtual unsigned int width(bool constrained=false) const
How many bytes does this variable use Return the number of bytes of storage this variable uses....
Definition Str.cc:125
virtual string value() const
Definition Str.cc:260
virtual void dump(ostream &strm) const
dumps information about this object
Definition Str.cc:345
virtual unsigned int buf2val(void **val)
Definition Str.cc:202
virtual bool set_value(const string &value)
Definition Str.cc:249
virtual unsigned int val2buf(void *val, bool reuse=false)
Definition Str.cc:230
virtual void compute_checksum(Crc32 &checksum)
include the data for this variable in the checksum DAP4 includes a checksum with every data response....
Definition Str.cc:164
abstract base class used to unmarshall/deserialize dap data objects
top level DAP object to house generic methods