/usr/include/libdap/Structure.h is in libdap-dev 3.11.1-10.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 | // -*- 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
//
// You can contact OPeNDAP, Inc. at PO Box 112, Saunderstown, RI. 02874-0112.
// (c) COPYRIGHT URI/MIT 1995-1999
// Please read the full copyright statement in the file COPYRIGHT_URI.
//
// Authors:
// jhrg,jimg James Gallagher <jgallagher@gso.uri.edu>
// Interface for the class Structure. A structure contains a single set of
// variables, all at the same lexical level. Of course, a structure may
// contain other structures... The variables contained in a structure are
// stored by instances of this class in a SLList of BaseType pointers.
//
// jhrg 9/14/94
#ifndef _structure_h
#define _structure_h 1
#ifndef __POWERPC__
#endif
#include <vector>
#ifndef _basetype_h
#include "BaseType.h"
#endif
#ifndef _constructor_h
#include "Constructor.h"
#endif
#ifndef _dds_h
#include "DDS.h"
#endif
#ifndef constraint_evaluator_h
#include "ConstraintEvaluator.h"
#endif
#define FILE_METHODS 1
namespace libdap
{
/** This data type is used to hold a collection of related data types,
in a manner roughly corresponding to a C structure. The member
types can be simple or compound types, and can include other
Structures.
The DAP2 structure is defined as a singly-linked list. This means
that Structure elements can be accessed either by name, with the
<tt>var()</tt> function, or by their position in the list, either with
the overloaded version of <tt>var()</tt>, or the combination of the
<tt>first_var()</tt> and <tt>next_var()</tt> functions.
The <tt>val2buf()</tt> and <tt>buf2val()</tt> functions only
return the size of
the structure. To read parts of a DAP2 Structure into an
application program, use the <tt>buf2val()</tt> function of the element
of the Structure in question.
Note that the predicate-setting functions <tt>set_send_p()</tt> and
<tt>set_read_p()</tt> set their flags for the Structure as well as for
each of the Structure's member elements.
Similar to C, you can refer to members of Structure elements
with a ``.'' notation. For example, if the Structure has a member
Structure called ``Tom'' and Tom has a member Float32 called
``shoe_size'', then you can refer to Tom's shoe size as
``Tom.shoe_size''.
@todo Refactor with Sequence moving methods up into Constructor.
@brief Holds a structure (aggregate) type.
*/
class Structure: public Constructor
{
private:
BaseType *m_leaf_match(const string &name, btp_stack *s = 0);
BaseType *m_exact_match(const string &name, btp_stack *s = 0);
protected:
void _duplicate(const Structure &s);
public:
Structure(const string &n);
Structure(const string &n, const string &d);
Structure(const Structure &rhs);
virtual ~Structure();
Structure &operator=(const Structure &rhs);
virtual BaseType *ptr_duplicate();
virtual int element_count(bool leaves = false);
virtual bool is_linear();
virtual void set_send_p(bool state);
virtual void set_read_p(bool state);
virtual void set_in_selection(bool state);
virtual void set_leaf_sequence(int level = 1);
virtual unsigned int width();
virtual void intern_data(ConstraintEvaluator &eval, DDS &dds);
virtual bool serialize(ConstraintEvaluator &eval, DDS &dds,
Marshaller &m, bool ce_eval = true);
virtual bool deserialize(UnMarshaller &um, DDS *dds, bool reuse = false);
// Do not store values in memory as for C; force users to work with the
// C++ objects as defined by the DAP.
virtual unsigned int val2buf(void *val, bool reuse = false);
virtual unsigned int buf2val(void **val);
virtual BaseType *var(const string &name, bool exact_match = true,
btp_stack *s = 0);
virtual BaseType *var(const string &n, btp_stack &s);
virtual void add_var(BaseType *bt, Part part = nil);
virtual void del_var(const string &name);
virtual bool read() ;
#if FILE_METHODS
virtual void print_val(FILE *out, string space = "",
bool print_decl_p = true);
#endif
virtual void print_val(ostream &out, string space = "",
bool print_decl_p = true);
virtual bool check_semantics(string &msg, bool all = false);
virtual void dump(ostream &strm) const ;
};
} // namespace libdap
#endif // _structure_h
|