| API Docs for SAX and DOM |

Main Page Class Hierarchy Alphabetical List Compound List File List Compound Members File Members

# XMLAbstractDoubleFloat.hpp

Go to the documentation of this file.

    00001 /*
    00002  * The Apache Software License, Version 1.1
    00003  *
    00004  * Copyright (c) 2001 The Apache Software Foundation.  All rights
    00005  * reserved.
    00006  *
    00007  * Redistribution and use in source and binary forms, with or without
    00008  * modification, are permitted provided that the following conditions
    00009  * are met:
    00010  *
    00011  * 1. Redistributions of source code must retain the above copyright
    00012  *    notice, this list of conditions and the following disclaimer.
    00013  *
    00014  * 2. Redistributions in binary form must reproduce the above copyright
    00015  *    notice, this list of conditions and the following disclaimer in
    00016  *    the documentation and/or other materials provided with the
    00017  *    distribution.
    00018  *
    00019  * 3. The end-user documentation included with the redistribution,
    00020  *    if any, must include the following acknowledgment:
    00021  *       "This product includes software developed by the
    00022  *        Apache Software Foundation (http://www.apache.org/)."
    00023  *    Alternately, this acknowledgment may appear in the software itself,
    00024  *    if and wherever such third-party acknowledgments normally appear.
    00025  *
    00026  * 4. The names "Xerces" and "Apache Software Foundation" must
    00027  *    not be used to endorse or promote products derived from this
    00028  *    software without prior written permission. For written
    00029  *    permission, please contact apache\@apache.org.
    00030  *
    00031  * 5. Products derived from this software may not be called "Apache",
    00032  *    nor may "Apache" appear in their name, without prior written
    00033  *    permission of the Apache Software Foundation.
    00034  *
    00035  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
    00036  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
    00037  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
    00038  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
    00039  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
    00040  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
    00041  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
    00042  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
    00043  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
    00044  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
    00045  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
    00046  * SUCH DAMAGE.
    00047  * ====================================================================
    00048  *
    00049  * This software consists of voluntary contributions made by many
    00050  * individuals on behalf of the Apache Software Foundation, and was
    00051  * originally based on software copyright (c) 2001, International
    00052  * Business Machines, Inc., http://www.ibm.com .  For more information
    00053  * on the Apache Software Foundation, please see
    00054  * <http://www.apache.org/>.
    00055  */
    00056
    00057 /*
    00058  * $Id: XMLAbstractDoubleFloat.hpp,v 1.20 2004/01/29 11:48:46 cargilld Exp $
    00059  * $Log: XMLAbstractDoubleFloat.hpp,v $
    00060  * Revision 1.20  2004/01/29 11:48:46  cargilld
    00061  * Code cleanup changes to get rid of various compiler diagnostic messages.
    00062  *
    00063  * Revision 1.19  2004/01/13 19:50:56  peiyongz
    00064  * remove parseContent()
    00065  *
    00066  * Revision 1.17  2003/12/17 00:18:35  cargilld
    00067  * Update to memory management so that the static memory manager (one used to call Initialize) is only for static data.
    00068  *
    00069  * Revision 1.16  2003/12/11 21:38:12  peiyongz
    00070  * support for Canonical Representation for Datatype
    00071  *
    00072  * Revision 1.15  2003/10/15 14:50:01  peiyongz
    00073  * Bugzilla#22821: locale-sensitive function used to validate 'double' type, patch
    00074  * from jsweeney@spss.com (Jeff Sweeney)
    00075  *
    00076  * Revision 1.14  2003/09/23 18:16:07  peiyongz
    00077  * Inplementation for Serialization/Deserialization
    00078  *
    00079  * Revision 1.13  2003/05/18 14:02:05  knoaman
    00080  * Memory manager implementation: pass per instance manager.
    00081  *
    00082  * Revision 1.12  2003/05/16 06:01:53  knoaman
    00083  * Partial implementation of the configurable memory manager.
    00084  *
    00085  * Revision 1.11  2003/05/15 19:07:46  knoaman
    00086  * Partial implementation of the configurable memory manager.
    00087  *
    00088  * Revision 1.10  2003/05/09 15:13:46  peiyongz
    00089  * Deprecated toString() in XMLNumber family
    00090  *
    00091  * Revision 1.9  2003/03/10 20:55:58  peiyongz
    00092  * Schema Errata E2-40 double/float
    00093  *
    00094  * Revision 1.8  2003/02/02 23:54:43  peiyongz
    00095  * getFormattedString() added to return original and converted value.
    00096  *
    00097  * Revision 1.7  2003/01/30 21:55:22  tng
    00098  * Performance: create getRawData which is similar to toString but return the internal data directly, user is not required to delete the returned memory.
    00099  *
    00100  * Revision 1.6  2002/12/11 00:20:02  peiyongz
    00101  * Doing businesss in value space. Converting out-of-bound value into special values.
    00102  *
    00103  * Revision 1.5  2002/11/04 15:22:05  tng
    00104  * C++ Namespace Support.
    00105  *
    00106  * Revision 1.4  2002/03/06 19:13:12  peiyongz
    00107  * Patch: more valid lexcial representation for positive/negative zero
    00108  *
    00109  * Revision 1.3  2002/03/01 18:47:37  peiyongz
    00110  * fix: more valid lexcial representation forms for "neural zero"
    00111  *
    00112  * Revision 1.2  2002/02/20 18:17:02  tng
    00113  * [Bug 5977] Warnings on generating apiDocs.
    00114  *
    00115  * Revision 1.1.1.1  2002/02/01 22:22:14  peiyongz
    00116  * sane_include
    00117  *
    00118  * Revision 1.4  2001/11/28 15:39:26  peiyongz
    00119  * return Type& for operator=
    00120  *
    00121  * Revision 1.3  2001/11/22 21:39:00  peiyongz
    00122  * Allow "0.0" to be a valid lexcial representation of ZERO.
    00123  *
    00124  * Revision 1.2  2001/11/22 20:23:00  peiyongz
    00125  * _declspec(dllimport) and inline warning C4273
    00126  *
    00127  * Revision 1.1  2001/11/19 21:33:42  peiyongz
    00128  * Reorganization: Double/Float
    00129  *
    00130  *
    00131  */
    00132
    00133 #ifndef XML_ABSTRACT_DOUBLE_FLOAT_HPP
    00134 #define XML_ABSTRACT_DOUBLE_FLOAT_HPP
    00135
    00136 #include <xercesc/util/XMLNumber.hpp>
    00137 #include <xercesc/util/PlatformUtils.hpp>
    00138
    00139 XERCES_CPP_NAMESPACE_BEGIN
    00140
    00141 /***
    00142  * 3.2.5.1 Lexical representation
    00143  *
    00144  *   double values have a lexical representation consisting of a mantissa followed,
    00145  *   optionally, by the character "E" or "e", followed by an exponent.
    00146  *
    00147  *   The exponent ·must· be an integer.
    00148  *   The mantissa must be a decimal number.
    00149  *   The representations for exponent and mantissa must follow the lexical rules
    00150  *   for integer and decimal.
    00151  *
    00152  *   If the "E" or "e" and the following exponent are omitted,
    00153  *   an exponent value of 0 is assumed.
    00154 ***/
    00155
    00156 /***
    00157  * 3.2.4.1 Lexical representation
    00158  *
    00159  *   float values have a lexical representation consisting of a mantissa followed,
    00160  *   optionally, by the character "E" or "e", followed by an exponent.
    00161  *
    00162  *   The exponent ·must· be an integer.
    00163  *   The mantissa must be a decimal number.
    00164  *   The representations for exponent and mantissa must follow the lexical rules
    00165  *   for integer and decimal.
    00166  *
    00167  *   If the "E" or "e" and the following exponent are omitted,
    00168  *   an exponent value of 0 is assumed.
    00169 ***/
    00170
    00171 class  XMLAbstractDoubleFloat : public XMLNumber
    00172 {
    00173 public:
    00174
    00175     enum LiteralType
    00176     {
    00177         NegINF,
    00178         PosINF,
    00179         NaN,
    00180         SpecialTypeNum,
    00181         Normal
    00182     };
    00183
    00184     virtual ~XMLAbstractDoubleFloat();
    00185
    00186     static XMLCh* getCanonicalRepresentation
    00187                         (
    00188                           const XMLCh*         const rawData
    00189                         ,       MemoryManager* const memMgr = XMLPlatformUtils::fgMemoryManager
    00190                         );
    00191
    00197     virtual XMLCh*        toString() const;
    00198
    00199     virtual XMLCh*        getRawData() const;
    00200
    00201     virtual const XMLCh*  getFormattedString() const;
    00202
    00203     virtual int           getSign() const;
    00204
    00205     MemoryManager*        getMemoryManager() const;
    00206
    00207     /***
    00208      *
    00209      * The decimal point delimiter for the schema double/float type is
    00210      * defined to be a period and is not locale-specific. So, it must
    00211      * be replaced with the local-specific delimiter before converting
    00212      * from string to double/float.
    00213      *
    00214      ***/
    00215     void                  normalizeDecimalPoint(char* const toNormal);
    00216
    00217     /***
    00218      * Support for Serialization/De-serialization
    00219      ***/
    00220     DECL_XSERIALIZABLE(XMLAbstractDoubleFloat)
    00221
    00222 protected:
    00223
    00224     //
    00225     // To be used by derived class exclusively
    00226     //
    00227     XMLAbstractDoubleFloat(MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager);
    00228
    00229     void                  init(const XMLCh* const strValue);
    00230
    00243     static int            compareValues(const XMLAbstractDoubleFloat* const lValue
    00244                                       , const XMLAbstractDoubleFloat* const rValue
    00245                                       , MemoryManager* const manager);
    00246
    00247     //
    00248     // to be overwritten by derived class
    00249     //
    00250     virtual void          checkBoundary(const XMLCh* const strValue) = 0;
    00251
    00252 private:
    00253     //
    00254     // Unimplemented
    00255     //
    00256     // copy ctor
    00257     // assignment ctor
    00258     //
    00259     XMLAbstractDoubleFloat(const XMLAbstractDoubleFloat& toCopy);
    00260     XMLAbstractDoubleFloat& operator=(const XMLAbstractDoubleFloat& toAssign);
    00261
    00262     void                  normalizeZero(XMLCh* const);
    00263
    00264     inline bool           isSpecialValue() const;
    00265
    00266     static int            compareSpecial(const XMLAbstractDoubleFloat* const specialValue
    00267                                        , MemoryManager* const manager);
    00268
    00269     void                  formatString();
    00270
    00271 protected:
    00272     double                  fValue;
    00273     LiteralType             fType;
    00274     bool                    fDataConverted;
    00275
    00276 private:
    00277     int                     fSign;
    00278     XMLCh*                  fRawData;
    00279
    00280     //
    00281     // If the original string is not lexcially the same as the five
    00282     // special value notations, and the value is converted to
    00283     // special value due underlying platform restriction on data
    00284     // representation, then this string is constructed and
    00285     // takes the form "original_string (special_value_notation)",
    00286     // otherwise it is empty.
    00287     //
    00288     XMLCh*                  fFormattedString;
    00289     MemoryManager*          fMemoryManager;
    00290 };
    00291
    00292 inline bool XMLAbstractDoubleFloat::isSpecialValue() const
    00293 {
    00294     return (fType < SpecialTypeNum);
    00295 }
    00296
    00297 inline MemoryManager* XMLAbstractDoubleFloat::getMemoryManager() const
    00298 {
    00299     return fMemoryManager;
    00300 }
    00301
    00302 XERCES_CPP_NAMESPACE_END
    00303
    00304 #endif

Copyright © 2004 The Apache Software Foundation. All Rights Reserved.