ACE/ace/CDR_Size.h

   1 // -*- C++ -*-
   2
   3 //=============================================================================
   4 /**
   5  *  @file   CDR_Size.h
   6  *
   7  * ACE Common Data Representation (CDR) size-calculating stream.
   8  *
   9  * The current implementation assumes that the host has 1-byte,
  10  * 2-byte and 4-byte integral types, and that it has single
  11  * precision and double precision IEEE floats.
  12  * Those assumptions are pretty good these days, with Crays being
  13  * the only known exception.
  14  *
  15  *  @author Boris Kolpackov <boris@kolpackov.net>
  16  */
  17 //=============================================================================
  18
  19 #ifndef ACE_CDR_SIZE_H
  20 #define ACE_CDR_SIZE_H
  21
  22 #include /**/ "ace/pre.h"
  23
  24 #include "ace/CDR_Base.h"
  25 #include "ace/CDR_Stream.h" // for ACE_OutputCDR::from_*
  26
  27 #if !defined (ACE_LACKS_PRAGMA_ONCE)
  28 # pragma once
  29 #endif /* ACE_LACKS_PRAGMA_ONCE */
  30
  31 #include "ace/SStringfwd.h"
  32
  33 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
  34
  35 /**
  36  * @class ACE_SizeCDR
  37  *
  38  * @brief A CDR stream for calculating size of the representation.
  39  */
  40 class ACE_Export ACE_SizeCDR
  41 {
  42 public:
  43   /// Default constructor.
  44   ACE_SizeCDR (ACE_CDR::Octet major_version = ACE_CDR_GIOP_MAJOR_VERSION,
  45                ACE_CDR::Octet minor_version = ACE_CDR_GIOP_MINOR_VERSION);
  46
  47   /// Returns @c false if an error has occurred.
  48   bool good_bit (void) const;
  49
  50   /// Reset current size.
  51   void reset (void);
  52
  53   /// Return current size.
  54   size_t total_length (void) const;
  55
  56   // Return 0 on failure and 1 on success.
  57   //@{ @name Size-calculating pseudo-write operations
  58   ACE_CDR::Boolean write_boolean (ACE_CDR::Boolean x);
  59   ACE_CDR::Boolean write_char (ACE_CDR::Char x);
  60   ACE_CDR::Boolean write_wchar (ACE_CDR::WChar x);
  61   ACE_CDR::Boolean write_octet (ACE_CDR::Octet x);
  62   ACE_CDR::Boolean write_short (ACE_CDR::Short x);
  63   ACE_CDR::Boolean write_ushort (ACE_CDR::UShort x);
  64   ACE_CDR::Boolean write_long (ACE_CDR::Long x);
  65   ACE_CDR::Boolean write_ulong (ACE_CDR::ULong x);
  66   ACE_CDR::Boolean write_longlong (const ACE_CDR::LongLong &x);
  67   ACE_CDR::Boolean write_ulonglong (const ACE_CDR::ULongLong &x);
  68   ACE_CDR::Boolean write_float (ACE_CDR::Float x);
  69   ACE_CDR::Boolean write_double (const ACE_CDR::Double &x);
  70   ACE_CDR::Boolean write_longdouble (const ACE_CDR::LongDouble &x);
  71   ACE_CDR::Boolean write_fixed (const ACE_CDR::Fixed &x);
  72
  73   /// For string we offer methods that accept a precomputed length.
  74   ACE_CDR::Boolean write_string (const ACE_CDR::Char *x);
  75   ACE_CDR::Boolean write_string (ACE_CDR::ULong len,
  76                                  const ACE_CDR::Char *x);
  77   ACE_CDR::Boolean write_string (const ACE_CString &x);
  78   ACE_CDR::Boolean write_wstring (const ACE_CDR::WChar *x);
  79   ACE_CDR::Boolean write_wstring (ACE_CDR::ULong length,
  80                                   const ACE_CDR::WChar *x);
  81   ACE_CDR::Boolean write_string (const std::string &x);
  82 #if !defined(ACE_LACKS_STD_WSTRING)
  83   ACE_CDR::Boolean write_wstring (const std::wstring &x);
  84 #endif
  85   //@}
  86
  87   /// @note the portion written starts at <x> and ends
  88   ///    at <x + length>.
  89   /// The length is *NOT* stored into the CDR stream.
  90   //@{ @name Array write operations
  91   ACE_CDR::Boolean write_boolean_array (const ACE_CDR::Boolean *x,
  92                                         ACE_CDR::ULong length);
  93   ACE_CDR::Boolean write_char_array (const ACE_CDR::Char *x,
  94                                      ACE_CDR::ULong length);
  95   ACE_CDR::Boolean write_wchar_array (const ACE_CDR::WChar* x,
  96                                       ACE_CDR::ULong length);
  97   ACE_CDR::Boolean write_octet_array (const ACE_CDR::Octet* x,
  98                                       ACE_CDR::ULong length);
  99   ACE_CDR::Boolean write_short_array (const ACE_CDR::Short *x,
 100                                       ACE_CDR::ULong length);
 101   ACE_CDR::Boolean write_ushort_array (const ACE_CDR::UShort *x,
 102                                        ACE_CDR::ULong length);
 103   ACE_CDR::Boolean write_long_array (const ACE_CDR::Long *x,
 104                                      ACE_CDR::ULong length);
 105   ACE_CDR::Boolean write_ulong_array (const ACE_CDR::ULong *x,
 106                                       ACE_CDR::ULong length);
 107   ACE_CDR::Boolean write_longlong_array (const ACE_CDR::LongLong* x,
 108                                          ACE_CDR::ULong length);
 109   ACE_CDR::Boolean write_ulonglong_array (const ACE_CDR::ULongLong *x,
 110                                           ACE_CDR::ULong length);
 111   ACE_CDR::Boolean write_float_array (const ACE_CDR::Float *x,
 112                                       ACE_CDR::ULong length);
 113   ACE_CDR::Boolean write_double_array (const ACE_CDR::Double *x,
 114                                        ACE_CDR::ULong length);
 115   ACE_CDR::Boolean write_longdouble_array (const ACE_CDR::LongDouble* x,
 116                                            ACE_CDR::ULong length);
 117
 118   ///
 119   /// Adjust to @a size and count @a size octets.
 120   void adjust (size_t size);
 121
 122   /// As above, but now the size and alignment requirements may be
 123   /// different.
 124   void adjust (size_t size,
 125                size_t align);
 126
 127 private:
 128   /// disallow copying...
 129   ACE_SizeCDR (const ACE_SizeCDR& rhs);
 130   ACE_SizeCDR& operator= (const ACE_SizeCDR& rhs);
 131
 132   ACE_CDR::Boolean write_1 (const ACE_CDR::Octet *x);
 133   ACE_CDR::Boolean write_2 (const ACE_CDR::UShort *x);
 134   ACE_CDR::Boolean write_4 (const ACE_CDR::ULong *x);
 135   ACE_CDR::Boolean write_8 (const ACE_CDR::ULongLong *x);
 136   ACE_CDR::Boolean write_16 (const ACE_CDR::LongDouble *x);
 137
 138   /**
 139    * write an array of @a length elements, each of @a size bytes and the
 140    * start aligned at a multiple of <align>. The elements are assumed
 141    * to be packed with the right alignment restrictions.  It is mostly
 142    * designed for buffers of the basic types.
 143    *
 144    * This operation uses <memcpy>; as explained above it is expected
 145    * that using assignment is faster that <memcpy> for one element,
 146    * but for several elements <memcpy> should be more efficient, it
 147    * could be interesting to find the break even point and optimize
 148    * for that case, but that would be too platform dependent.
 149    */
 150   ACE_CDR::Boolean write_array (const void *x,
 151                                 size_t size,
 152                                 size_t align,
 153                                 ACE_CDR::ULong length);
 154
 155
 156   ACE_CDR::Boolean write_wchar_array_i (const ACE_CDR::WChar* x,
 157                                         ACE_CDR::ULong length);
 158
 159 private:
 160   /// Set to false when an error occurs.
 161   bool good_bit_;
 162
 163   /// Current size.
 164   size_t size_;
 165
 166 protected:
 167   /// GIOP version information
 168   ACE_CDR::Octet major_version_;
 169   ACE_CDR::Octet minor_version_;
 170 };
 171
 172 // @@ This operator should not be inlined since they force SString.h
 173 //    to be included in this header.
 174 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 175                                                const ACE_CString &x);
 176
 177 ACE_END_VERSIONED_NAMESPACE_DECL
 178
 179 #if defined (__ACE_INLINE__)
 180 # include "ace/CDR_Size.inl"
 181 #else /* __ACE_INLINE__ */
 182
 183 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 184
 185 // Not used by CORBA or TAO
 186 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 187                                                ACE_CDR::Char x);
 188
 189 // CDR size-calculating output operators for primitive types
 190
 191 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 192                                                ACE_CDR::Short x);
 193 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 194                                                ACE_CDR::UShort x);
 195 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 196                                                ACE_CDR::Long x);
 197 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 198                                                ACE_CDR::ULong x);
 199 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 200                                                ACE_CDR::LongLong x);
 201 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 202                                                ACE_CDR::ULongLong x);
 203 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR& ss,
 204                                                ACE_CDR::LongDouble x);
 205 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 206                                                ACE_CDR::Float x);
 207 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 208                                                ACE_CDR::Double x);
 209 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 210                                                const ACE_CDR::Fixed &x);
 211
 212 // CDR size-calculating output operator from helper classes
 213
 214 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 215                                                ACE_OutputCDR::from_boolean x);
 216 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 217                                                ACE_OutputCDR::from_char x);
 218 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 219                                                ACE_OutputCDR::from_wchar x);
 220 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 221                                                ACE_OutputCDR::from_octet x);
 222 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 223                                                ACE_OutputCDR::from_string x);
 224 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 225                                                ACE_OutputCDR::from_wstring x);
 226 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 227                                                const ACE_CDR::Char* x);
 228 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 229                                                const ACE_CDR::WChar* x);
 230 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 231                                                const std::string& x);
 232 #if !defined(ACE_LACKS_STD_WSTRING)
 233 extern ACE_Export ACE_CDR::Boolean operator<< (ACE_SizeCDR &ss,
 234                                                const std::wstring& x);
 235 #endif
 236
 237 ACE_END_VERSIONED_NAMESPACE_DECL
 238
 239 #endif /* __ACE_INLINE__ */
 240
 241
 242 #include /**/ "ace/post.h"
 243
 244 #endif /* ACE_CDR_SIZE_H */