casacore
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
RawDataConversion.h
Go to the documentation of this file.
1 //# RawDataConversion.h: A class with virtual functions to copy without conversion
2 //# Copyright (C) 1996,1999,2001
3 //# Associated Universities, Inc. Washington DC, USA.
4 //#
5 //# This library is free software; you can redistribute it and/or modify it
6 //# under the terms of the GNU Library General Public License as published by
7 //# the Free Software Foundation; either version 2 of the License, or (at your
8 //# option) any later version.
9 //#
10 //# This library is distributed in the hope that it will be useful, but WITHOUT
11 //# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 //# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public
13 //# License for more details.
14 //#
15 //# You should have received a copy of the GNU Library General Public License
16 //# along with this library; if not, write to the Free Software Foundation,
17 //# Inc., 675 Massachusetts Ave, Cambridge, MA 02139, USA.
18 //#
19 //# Correspondence concerning AIPS++ should be addressed as follows:
20 //# Internet email: aips2-request@nrao.edu.
21 //# Postal address: AIPS++ Project Office
22 //# National Radio Astronomy Observatory
23 //# 520 Edgemont Road
24 //# Charlottesville, VA 22903-2475 USA
25 //#
26 //# $Id$
27 
28 #ifndef CASA_RAWDATACONVERSION_H
29 #define CASA_RAWDATACONVERSION_H
30 
31 //# Includes
32 #include <casacore/casa/aips.h>
33 #include <casacore/casa/OS/DataConversion.h>
34 
35 
36 namespace casacore { //# NAMESPACE CASACORE - BEGIN
37 
38 // <summary>
39 // A class with virtual functions to copy without conversion
40 // </summary>
41 
42 // <use visibility=export>
43 
44 // <reviewed reviewer="Friso Olnon" date="1996/11/06" tests="tDataConversion" demos="">
45 // </reviewed>
46 
47 // <synopsis>
48 // This class is a specialization of the abstract base class
49 // <linkto class=DataConversion>DataConversion</linkto>.
50 // It contains functions to copy data without conversion.
51 // <p>
52 // This class exists to make it possible to use a <src>DataConversion</src>
53 // object when no conversion is actually needed.
54 // </synopsis>
55 
56 // <example>
57 // See example in class <linkto class=DataConversion>DataConversion</linkto>.
58 // </example>
59 
60 // <motivation>
61 // This class makes it possible to use the conversion framework
62 // for operations where a conversion is only a simple copy.
63 // </motivation>
64 
65 // <todo asof="$DATE$">
66 // <li> Support data type long double.
67 // </todo>
68 
69 
70 class RawDataConversion : public DataConversion
71 {
72 public:
73  // Construct the object.
74  RawDataConversion();
75 
76  virtual ~RawDataConversion();
77 
78  // Copy one value from external to local (is a simple memcpy).
79  // The from and to buffer should not overlap.
80  // <group>
81  virtual size_t toLocal (char& to, const void* from) const;
82  virtual size_t toLocal (unsigned char& to, const void* from) const;
83  virtual size_t toLocal (short& to, const void* from) const;
84  virtual size_t toLocal (unsigned short& to, const void* from) const;
85  virtual size_t toLocal (int& to, const void* from) const;
86  virtual size_t toLocal (unsigned int& to, const void* from) const;
87  virtual size_t toLocal (Int64& to, const void* from) const;
88  virtual size_t toLocal (uInt64& to, const void* from) const;
89  virtual size_t toLocal (float& to, const void* from) const;
90  virtual size_t toLocal (double& to, const void* from) const;
91  // </group>
92 
93  // Copy multiple values from external to local (is a simple memcpy).
94  // The from and to buffer should not overlap.
95  // <group>
96  virtual size_t toLocal (char* to, const void* from,
97  size_t nr) const;
98  virtual size_t toLocal (unsigned char* to, const void* from,
99  size_t nr) const;
100  virtual size_t toLocal (short* to, const void* from,
101  size_t nr) const;
102  virtual size_t toLocal (unsigned short* to, const void* from,
103  size_t nr) const;
104  virtual size_t toLocal (int* to, const void* from,
105  size_t nr) const;
106  virtual size_t toLocal (unsigned int* to, const void* from,
107  size_t nr) const;
108  virtual size_t toLocal (Int64* to, const void* from,
109  size_t nr) const;
110  virtual size_t toLocal (uInt64* to, const void* from,
111  size_t nr) const;
112  virtual size_t toLocal (float* to, const void* from,
113  size_t nr) const;
114  virtual size_t toLocal (double* to, const void* from,
115  size_t nr) const;
116  // </group>
117 
118  // Copy one value from local to external (is a simple memcpy).
119  // The from and to buffer should not overlap.
120  // <group>
121  virtual size_t fromLocal (void* to, char from) const;
122  virtual size_t fromLocal (void* to, unsigned char from) const;
123  virtual size_t fromLocal (void* to, short from) const;
124  virtual size_t fromLocal (void* to, unsigned short from) const;
125  virtual size_t fromLocal (void* to, int from) const;
126  virtual size_t fromLocal (void* to, unsigned int from) const;
127  virtual size_t fromLocal (void* to, Int64 from) const;
128  virtual size_t fromLocal (void* to, uInt64 from) const;
129  virtual size_t fromLocal (void* to, float from) const;
130  virtual size_t fromLocal (void* to, double from) const;
131  // </group>
132 
133  // Copy multiple values from local to external (is a simple memcpy).
134  // The from and to buffer should not overlap.
135  // <group>
136  virtual size_t fromLocal (void* to, const char* from,
137  size_t nr) const;
138  virtual size_t fromLocal (void* to, const unsigned char* from,
139  size_t nr) const;
140  virtual size_t fromLocal (void* to, const short* from,
141  size_t nr) const;
142  virtual size_t fromLocal (void* to, const unsigned short* from,
143  size_t nr) const;
144  virtual size_t fromLocal (void* to, const int* from,
145  size_t nr) const;
146  virtual size_t fromLocal (void* to, const unsigned int* from,
147  size_t nr) const;
148  virtual size_t fromLocal (void* to, const Int64* from,
149  size_t nr) const;
150  virtual size_t fromLocal (void* to, const uInt64* from,
151  size_t nr) const;
152  virtual size_t fromLocal (void* to, const float* from,
153  size_t nr) const;
154  virtual size_t fromLocal (void* to, const double* from,
155  size_t nr) const;
156  // </group>
157 
158  // Determine if the data for a data type can be simply copied, thus
159  // if no conversion is needed. This is always True.
160  // <group>
161  virtual Bool canCopy (const char*) const;
162  virtual Bool canCopy (const unsigned char*) const;
163  virtual Bool canCopy (const short*) const;
164  virtual Bool canCopy (const unsigned short*) const;
165  virtual Bool canCopy (const int*) const;
166  virtual Bool canCopy (const unsigned int*) const;
167  virtual Bool canCopy (const Int64*) const;
168  virtual Bool canCopy (const uInt64*) const;
169  virtual Bool canCopy (const float*) const;
170  virtual Bool canCopy (const double*) const;
171  // </group>
172 
173  // Get the external size of the data type.
174  // This returns the <src>sizeof</src>.
175  // <group>
176  virtual unsigned int externalSize (const char*) const;
177  virtual unsigned int externalSize (const unsigned char*) const;
178  virtual unsigned int externalSize (const short*) const;
179  virtual unsigned int externalSize (const unsigned short*) const;
180  virtual unsigned int externalSize (const int*) const;
181  virtual unsigned int externalSize (const unsigned int*) const;
182  virtual unsigned int externalSize (const Int64*) const;
183  virtual unsigned int externalSize (const uInt64*) const;
184  virtual unsigned int externalSize (const float*) const;
185  virtual unsigned int externalSize (const double*) const;
186  // </group>
187 };
188 
189 
190 inline RawDataConversion::RawDataConversion()
191 {}
192 
193 
194 
195 } //# NAMESPACE CASACORE - END
196 
197 #endif
casacore::Int64
long long Int64
Define the extra non-standard types used by Casacore (like proposed uSize, Size)
Definition: aipsxtype.h:38
casacore::RawDataConversion::canCopy
virtual Bool canCopy(const char *) const
Determine if the data for a data type can be simply copied, thus if no conversion is needed...
casacore::DataConversion
Abstract base class with functions to convert any format.
Definition: DataConversion.h:82
casacore::uInt64
unsigned long long uInt64
Definition: aipsxtype.h:39
casacore::RawDataConversion::RawDataConversion
RawDataConversion()
Construct the object.
Definition: RawDataConversion.h:190
casacore::Bool
bool Bool
Define the standard types used by Casacore.
Definition: aipstype.h:42
casacore::RawDataConversion
A class with virtual functions to copy without conversion.
Definition: RawDataConversion.h:70
casacore::RawDataConversion::externalSize
virtual unsigned int externalSize(const char *) const
Get the external size of the data type.
casacore::RawDataConversion::fromLocal
virtual size_t fromLocal(void *to, char from) const
Copy one value from local to external (is a simple memcpy).
casacore::RawDataConversion::toLocal
virtual size_t toLocal(char &to, const void *from) const
Copy one value from external to local (is a simple memcpy).
Generated by   doxygen 1.8.5