<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libdap++: Str.h Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.3 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">libdap++ <span id="projectnumber">Updated for version 3.8.2</span></div>
</td>
</tr>
</tbody>
</table>
</div>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>File Members</span></a></li>
</ul>
</div>
</div>
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
initNavTree('Str_8h.html','');
</script>
<div id="doc-content">
<div class="header">
<div class="headertitle">
<h1>Str.h</h1> </div>
</div>
<div class="contents">
<a href="Str_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001
<a name="l00002"></a>00002 <span class="comment">// -*- mode: c++; c-basic-offset:4 -*-</span>
<a name="l00003"></a>00003
<a name="l00004"></a>00004 <span class="comment">// This file is part of libdap, A C++ implementation of the OPeNDAP Data</span>
<a name="l00005"></a>00005 <span class="comment">// Access Protocol.</span>
<a name="l00006"></a>00006
<a name="l00007"></a>00007 <span class="comment">// Copyright (c) 2002,2003 OPeNDAP, Inc.</span>
<a name="l00008"></a>00008 <span class="comment">// Author: James Gallagher <jgallagher@opendap.org></span>
<a name="l00009"></a>00009 <span class="comment">//</span>
<a name="l00010"></a>00010 <span class="comment">// This library is free software; you can redistribute it and/or</span>
<a name="l00011"></a>00011 <span class="comment">// modify it under the terms of the GNU Lesser General Public</span>
<a name="l00012"></a>00012 <span class="comment">// License as published by the Free Software Foundation; either</span>
<a name="l00013"></a>00013 <span class="comment">// version 2.1 of the License, or (at your option) any later version.</span>
<a name="l00014"></a>00014 <span class="comment">//</span>
<a name="l00015"></a>00015 <span class="comment">// This library is distributed in the hope that it will be useful,</span>
<a name="l00016"></a>00016 <span class="comment">// but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00017"></a>00017 <span class="comment">// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span>
<a name="l00018"></a>00018 <span class="comment">// Lesser General Public License for more details.</span>
<a name="l00019"></a>00019 <span class="comment">//</span>
<a name="l00020"></a>00020 <span class="comment">// You should have received a copy of the GNU Lesser General Public</span>
<a name="l00021"></a>00021 <span class="comment">// License along with this library; if not, write to the Free Software</span>
<a name="l00022"></a>00022 <span class="comment">// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA</span>
<a name="l00023"></a>00023 <span class="comment">//</span>
<a name="l00024"></a>00024 <span class="comment">// You can contact OPeNDAP, Inc. at PO Box 112, Saunderstown, RI. 02874-0112.</span>
<a name="l00025"></a>00025
<a name="l00026"></a>00026 <span class="comment">// (c) COPYRIGHT URI/MIT 1995-1999</span>
<a name="l00027"></a>00027 <span class="comment">// Please read the full copyright statement in the file COPYRIGHT_URI.</span>
<a name="l00028"></a>00028 <span class="comment">//</span>
<a name="l00029"></a>00029 <span class="comment">// Authors:</span>
<a name="l00030"></a>00030 <span class="comment">// jhrg,jimg James Gallagher <jgallagher@gso.uri.edu></span>
<a name="l00031"></a>00031
<a name="l00032"></a>00032 <span class="comment">// Interface for Str type.</span>
<a name="l00033"></a>00033 <span class="comment">//</span>
<a name="l00034"></a>00034 <span class="comment">// jhrg 9/7/94</span>
<a name="l00035"></a>00035
<a name="l00036"></a>00036 <span class="preprocessor">#ifndef _str_h</span>
<a name="l00037"></a>00037 <span class="preprocessor"></span><span class="preprocessor">#define _str_h 1</span>
<a name="l00038"></a>00038 <span class="preprocessor"></span>
<a name="l00039"></a>00039 <span class="preprocessor">#include <string></span>
<a name="l00040"></a>00040
<a name="l00041"></a>00041 <span class="preprocessor">#include "<a class="code" href="dods-limits_8h.html">dods-limits.h</a>"</span>
<a name="l00042"></a>00042 <span class="preprocessor">#include "<a class="code" href="BaseType_8h.html">BaseType.h</a>"</span>
<a name="l00043"></a>00043
<a name="l00044"></a><a class="code" href="Str_8h.html#a17b2c419b8632438a2058df948bd87c7">00044</a> <span class="preprocessor">#define FILE_METHODS 1</span>
<a name="l00045"></a>00045 <span class="preprocessor"></span>
<a name="l00046"></a>00046 <span class="keyword">namespace </span>libdap
<a name="l00047"></a>00047 {
<a name="l00048"></a>00048
<a name="l00049"></a>00049 <span class="comment">// max_str_len should be large since we always send strings with length bytes</span>
<a name="l00050"></a>00050 <span class="comment">// as a prefix (so xdr_string will always know how much memory to malloc) but</span>
<a name="l00051"></a>00051 <span class="comment">// if deserialize gets confused and thinks a ctor (in particular) is a string</span>
<a name="l00052"></a>00052 <span class="comment">// xdr_string in turn will max_str_len if it cannot get a length byte. A long</span>
<a name="l00053"></a>00053 <span class="comment">// term solution is to fix libdap, but strings should not routinely be > 32k</span>
<a name="l00054"></a>00054 <span class="comment">// for the time being... jhrg 4/30/97</span>
<a name="l00055"></a>00055
<a name="l00056"></a><a class="code" href="namespacelibdap.html#aef2455580bf5deab23e48dd319ae059f">00056</a> <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="namespacelibdap.html#aef2455580bf5deab23e48dd319ae059f">max_str_len</a> = <a class="code" href="dods-limits_8h.html#abbdf6079b091e5c281eab1f2aa96d4de">DODS_USHRT_MAX</a> - 1;
<a name="l00057"></a>00057
<a name="l00064"></a><a class="code" href="classlibdap_1_1Str.html">00064</a> <span class="keyword">class </span><a class="code" href="classlibdap_1_1Str.html" title="Holds character string data.">Str</a>: <span class="keyword">public</span> <a class="code" href="classlibdap_1_1BaseType.html" title="The basic data type for the DODS DAP types.">BaseType</a>
<a name="l00065"></a>00065 {
<a name="l00066"></a>00066
<a name="l00067"></a>00067 <span class="keyword">protected</span>:
<a name="l00068"></a><a class="code" href="classlibdap_1_1Str.html#a0d878027b018b84bb545b8d08ca2e28d">00068</a> <span class="keywordtype">string</span> <a class="code" href="classlibdap_1_1Str.html#a0d878027b018b84bb545b8d08ca2e28d">_buf</a>;
<a name="l00069"></a>00069
<a name="l00070"></a>00070 <span class="keyword">public</span>:
<a name="l00071"></a>00071 <a class="code" href="classlibdap_1_1Str.html#a23a93ec403dc5cbb5264cdf47ea01c44">Str</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &n);
<a name="l00072"></a>00072 <a class="code" href="classlibdap_1_1Str.html#a23a93ec403dc5cbb5264cdf47ea01c44">Str</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &n, <span class="keyword">const</span> <span class="keywordtype">string</span> &d);
<a name="l00073"></a>00073
<a name="l00074"></a><a class="code" href="classlibdap_1_1Str.html#a673fe723d05512ef61d9967c6524847f">00074</a> <span class="keyword">virtual</span> <a class="code" href="classlibdap_1_1Str.html#a673fe723d05512ef61d9967c6524847f">~Str</a>()
<a name="l00075"></a>00075 {}
<a name="l00076"></a>00076
<a name="l00077"></a>00077 <a class="code" href="classlibdap_1_1Str.html#a23a93ec403dc5cbb5264cdf47ea01c44">Str</a>(<span class="keyword">const</span> <a class="code" href="classlibdap_1_1Str.html" title="Holds character string data.">Str</a> &copy_from);
<a name="l00078"></a>00078
<a name="l00079"></a>00079 <a class="code" href="classlibdap_1_1Str.html" title="Holds character string data.">Str</a> &<a class="code" href="classlibdap_1_1Str.html#a00993d910a5bdb55dceee229bc0be336">operator=</a>(<span class="keyword">const</span> <a class="code" href="classlibdap_1_1Str.html" title="Holds character string data.">Str</a> &rhs);
<a name="l00080"></a>00080
<a name="l00081"></a>00081 <span class="keyword">virtual</span> <a class="code" href="classlibdap_1_1BaseType.html" title="The basic data type for the DODS DAP types.">BaseType</a> *<a class="code" href="classlibdap_1_1Str.html#a4e92b00a6a3a8056c80b2f4467646f42">ptr_duplicate</a>();
<a name="l00082"></a>00082
<a name="l00083"></a>00083 <span class="keyword">virtual</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classlibdap_1_1Str.html#a7506602cf530cb7a76fa9714cc6ba203" title="Returns the size of the class instance data.">width</a>();
<a name="l00084"></a>00084
<a name="l00085"></a>00085 <span class="comment">// Return the length of the stored string or zero if no string has been</span>
<a name="l00086"></a>00086 <span class="comment">// stored in the instance's internal buffer.</span>
<a name="l00087"></a>00087 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classlibdap_1_1Str.html#a053049cf1df6c1cb78ce16ae06a1802f">length</a>();
<a name="l00088"></a>00088
<a name="l00089"></a>00089 <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classlibdap_1_1Str.html#a1f71320548c6cf29b85d66de5998144d" title="Move data to the net.">serialize</a>(<a class="code" href="classlibdap_1_1ConstraintEvaluator.html" title="Evaluate a constraint expression.">ConstraintEvaluator</a> &eval, <a class="code" href="classlibdap_1_1DDS.html">DDS</a> &dds,
<a name="l00090"></a>00090 <a class="code" href="classlibdap_1_1Marshaller.html" title="abstract base class used to marshal/serialize dap data objects">Marshaller</a> &m, <span class="keywordtype">bool</span> ce_eval = <span class="keyword">true</span>);
<a name="l00091"></a>00091 <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classlibdap_1_1Str.html#a2bafe2f1851b3a4cac6089b0e2282010" title="Receive data from the net.">deserialize</a>(<a class="code" href="classlibdap_1_1UnMarshaller.html" title="abstract base class used to unmarshall/deserialize dap data objects">UnMarshaller</a> &um, <a class="code" href="classlibdap_1_1DDS.html">DDS</a> *dds, <span class="keywordtype">bool</span> reuse = <span class="keyword">false</span>);
<a name="l00092"></a>00092
<a name="l00093"></a>00093 <span class="keyword">virtual</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classlibdap_1_1Str.html#add396308f45a14355b60c411ed33bf7a">val2buf</a>(<span class="keywordtype">void</span> *val, <span class="keywordtype">bool</span> reuse = <span class="keyword">false</span>);
<a name="l00094"></a>00094 <span class="keyword">virtual</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classlibdap_1_1Str.html#aa63cf0376fe71ceb030b48e7fdbad863">buf2val</a>(<span class="keywordtype">void</span> **val);
<a name="l00095"></a>00095
<a name="l00096"></a>00096 <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classlibdap_1_1Str.html#ac4083a612e46a9ef2d1cddc2d40a955f">set_value</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &<a class="code" href="classlibdap_1_1Str.html#ad1c8898d979786da1699677c04264aa1">value</a>);
<a name="l00097"></a>00097 <span class="keyword">virtual</span> <span class="keywordtype">string</span> <a class="code" href="classlibdap_1_1Str.html#ad1c8898d979786da1699677c04264aa1">value</a>() <span class="keyword">const</span>;
<a name="l00098"></a>00098 <span class="preprocessor">#if FILE_METHODS</span>
<a name="l00099"></a>00099 <span class="preprocessor"></span> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classlibdap_1_1Str.html#a7984e46de9b21ef554b156dec40cc559" title="Prints the value of the variable.">print_val</a>(FILE *out, <span class="keywordtype">string</span> space = <span class="stringliteral">""</span>,
<a name="l00100"></a>00100 <span class="keywordtype">bool</span> print_decl_p = <span class="keyword">true</span>);
<a name="l00101"></a>00101 <span class="preprocessor">#endif</span>
<a name="l00102"></a>00102 <span class="preprocessor"></span> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classlibdap_1_1Str.html#a7984e46de9b21ef554b156dec40cc559" title="Prints the value of the variable.">print_val</a>(ostream &out, <span class="keywordtype">string</span> space = <span class="stringliteral">""</span>,
<a name="l00103"></a>00103 <span class="keywordtype">bool</span> print_decl_p = <span class="keyword">true</span>);
<a name="l00104"></a>00104
<a name="l00105"></a>00105 <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classlibdap_1_1Str.html#a5b74994fb52ceb3248c558015c4520a5" title="Evaluate relational operators.">ops</a>(<a class="code" href="classlibdap_1_1BaseType.html" title="The basic data type for the DODS DAP types.">BaseType</a> *b, <span class="keywordtype">int</span> op);
<a name="l00106"></a>00106
<a name="l00107"></a>00107 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classlibdap_1_1Str.html#ad706e5b2b72822d8a5a30cf9c50ce570" title="dumps information about this object">dump</a>(ostream &strm) <span class="keyword">const</span> ;
<a name="l00108"></a>00108 };
<a name="l00109"></a>00109
<a name="l00110"></a>00110 } <span class="comment">// namespace libdap</span>
<a name="l00111"></a>00111
<a name="l00112"></a>00112 <span class="preprocessor">#endif // _str_h</span>
<a name="l00113"></a>00113 <span class="preprocessor"></span>
</pre></div></div>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="Str_8h.html">Str.h</a> </li>
<li class="footer">Generated on Tue Feb 8 2011 for libdap++ by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </li>
</ul>
</div>
</body>
</html>
