//Length.h generated on 'Thu Feb 04 10:20:05 CET 2010'. Edit at your own risk. /* * ALMA - Atacama Large Millimeter Array * (c) European Southern Observatory, 2002 * (c) Associated Universities Inc., 2002 * Copyright by ESO (in the framework of the ALMA collaboration), * Copyright by AUI (in the framework of the ALMA collaboration), * All rights reserved. * * 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 * * File Length.h */ #ifndef Length_CLASS #define Length_CLASS #include <vector> #include <iostream> #include <string> #ifndef WITHOUT_ACS #include <asdmIDLTypesC.h> #endif #include <alma/ASDM/StringTokenizer.h> #include <alma/ASDM/NumberFormatException.h> #include <alma/ASDM/EndianStream.h> namespace asdm { class Length; Length operator * ( double , const Length & ); std::ostream & operator << ( std::ostream &, const Length & ); std::istream & operator >> ( std::istream &, Length &); /** * The Length class implements a quantity of length in meters.. * * @version 1.00 Jan. 7, 2005 * @author Allen Farris * * @version 1.1 Aug 8, 2006 * @author Michel Caillat * added toBin/fromBin methods. */ class Length { /** * Overloading of multiplication operator. * @param d a value in double precision . * @param x a const reference to a Length . * @return a Length */ friend Length operator * ( double d, const Length & x ); /** * Overloading of << to output the value an Length on an ostream. * @param os a reference to the ostream to be written on. * @param x a const reference to a Length. */ friend std::ostream & operator << ( std::ostream & os, const Length & x); /** * Overloading of >> to read an Length from an istream. */ friend std::istream & operator >> ( std::istream & is, Length & x); public: /** * The nullary constructor (default). */ Length(); /** * The copy constructor. */ Length(const Length &); /** * A constructor from a string representation. * The string passed in argument must be parsable into a double precision * number to express the value in radian of the angle. * * @param s a string. */ Length(const std::string &s); #ifndef WITHOUT_ACS /** * * A constructor from a CORBA/IDL representation. * * @param idlLength a cons ref to an IDLLength. */ Length(const asdmIDLTypes::IDLLength & idlLength); #endif /** * A constructor from a value in double precision. * The value passed in argument defines the value of the Length in radian. */ Length(double value); /** * The destructor. */ virtual ~Length(); /** * A static method equivalent to the constructor from a string. * @param s a string?. */ static double fromString(const std::string& s); /** * Conversion into string. * The resulting string contains the representation of the value of this Length. * * @return string */ static std::string toString(double); /** * Parse the next (string) token of a StringTokenizer into an angle. * @param st a reference to a StringTokenizer. * @return an Length. */ static Length getLength(StringTokenizer &st); /** * Write the binary representation of this to an EndianOSStream . * @param eoss a reference to an EndianOSStream . */ void toBin(EndianOSStream& eoss); /** * Write the binary representation of a vector of Length to a EndianOSStream. * @param angle the vector of Length to be written * @param eoss the EndianOSStream to be written to */ static void toBin(const std::vector<Length>& angle, EndianOSStream& eoss); /** * Write the binary representation of a vector of vector of Length to a EndianOSStream. * @param angle the vector of vector of Length to be written * @param eoss the EndianOSStream to be written to */ static void toBin(const std::vector<std::vector<Length> >& angle, EndianOSStream& eoss); /** * Write the binary representation of a vector of vector of vector of Length to a EndianOSStream. * @param angle the vector of vector of vector of Length to be written * @param eoss the EndianOSStream to be written to */ static void toBin(const std::vector<std::vector<std::vector<Length> > >& angle, EndianOSStream& eoss); /** * Read the binary representation of an Length from a EndianIStream * and use the read value to set an Length. * @param eis the EndianStream to be read * @return an Length */ static Length fromBin(EndianIStream& eis); /** * Read the binary representation of a vector of Length from an EndianIStream * and use the read value to set a vector of Length. * @param eis a reference to the EndianIStream to be read * @return a vector of Length */ static std::vector<Length> from1DBin(EndianIStream & eis); /** * Read the binary representation of a vector of vector of Length from an EndianIStream * and use the read value to set a vector of vector of Length. * @param eis the EndianIStream to be read * @return a vector of vector of Length */ static std::vector<std::vector<Length> > from2DBin(EndianIStream & eis); /** * Read the binary representation of a vector of vector of vector of Length from an EndianIStream * and use the read value to set a vector of vector of vector of Length. * @param eis the EndianIStream to be read * @return a vector of vector of vector of Length */ static std::vector<std::vector<std::vector<Length> > > from3DBin(EndianIStream & eis); /** * An assignment operator Length = Length. * @param x a const reference to an Length. */ Length & operator = (const Length & x); /** * An assignment operator Length = double. * @param d a value in double precision. */ Length & operator = (const double d); /** * Operator increment and assign. * @param x a const reference to an Length. */ Length & operator += (const Length & x); /** * Operator decrement and assign. * @param x a const reference to an Length. */ Length & operator -= (const Length & x); /** * Operator multiply and assign. * @param x a value in double precision. */ Length & operator *= (const double x); /** * Operator divide and assign. * @param x a valye in double precision. */ Length & operator /= (const double x); /** * Addition operator. * @param x a const reference to a Length. */ Length operator + (const Length & x) const; /** * Substraction operator. * @param x a const reference to a Length. */ Length operator - (const Length & x) const; /** * Multiplication operator. * @param x a value in double precision. */ Length operator * (const double x) const; /** * Division operator. * @param d a value in double precision. */ Length operator / (const double x) const; /** * Comparison operator. Less-than. * @param x a const reference to a Length. */ bool operator < (const Length & x) const; /** * Comparison operator. Greater-than. * @param x a const reference to a Length. */ bool operator > (const Length & x) const; /** * Comparison operator. Less-than or equal. * @param x a const reference to a Length. */ bool operator <= (const Length & x) const; /** * Comparison operator. Greater-than or equal. * @param x a const reference to a Length. */ bool operator >= (const Length & x) const; /** * Comparision operator. Equal-to. * @param x a const reference to a Length. */ bool operator == (const Length & x) const; /** * Comparison method. Equality. * @param x a const reference to a Length. */ bool equals(const Length & x) const; /** * Comparison operator. Not-equal. * @param x a const reference to a Length. */ bool operator != (const Length & x) const; /** * Comparison method. Test nullity. * @return a bool. */ bool isZero() const; /** * Unary operator. Opposite. */ Length operator - () const; /** * Unary operator. Unary plus. */ Length operator + () const; /** * Converts into a string. * @return a string containing the representation of a the value in double precision. */ std::string toString() const; /** * Idem toString. */ std::string toStringI() const; /** * Conversion operator. * Converts into a string. */ operator std::string () const; /** * Return the double precision value of the Length. * @return double */ double get() const; #ifndef WITHOUT_ACS /** * Return the IDLLength representation of the Length. * @return IDLLength */ asdmIDLTypes::IDLLength toIDLLength() const; #endif /** * Returns the abbreviated name of the unit implicitely associated to any Length. * @return string */ static std::string unit(); private: double value; }; // Length constructors inline Length::Length() : value(0.0) { } inline Length::Length(const Length &t) : value(t.value) { } #ifndef WITHOUT_ACS inline Length::Length(const asdmIDLTypes::IDLLength &l) : value(l.value) { } #endif inline Length::Length(const std::string &s) : value(fromString(s)) { } inline Length::Length(double v) : value(v) { } // Length destructor inline Length::~Length() { } // assignment operator inline Length & Length::operator = ( const Length &t ) { value = t.value; return *this; } // assignment operator inline Length & Length::operator = ( const double v ) { value = v; return *this; } // assignment with arithmetic operators inline Length & Length::operator += ( const Length & t) { value += t.value; return *this; } inline Length & Length::operator -= ( const Length & t) { value -= t.value; return *this; } inline Length & Length::operator *= ( const double n) { value *= n; return *this; } inline Length & Length::operator /= ( const double n) { value /= n; return *this; } // arithmetic functions inline Length Length::operator + ( const Length &t2 ) const { Length tmp; tmp.value = value + t2.value; return tmp; } inline Length Length::operator - ( const Length &t2 ) const { Length tmp; tmp.value = value - t2.value; return tmp; } inline Length Length::operator * ( const double n) const { Length tmp; tmp.value = value * n; return tmp; } inline Length Length::operator / ( const double n) const { Length tmp; tmp.value = value / n; return tmp; } // comparison operators inline bool Length::operator < (const Length & x) const { return (value < x.value); } inline bool Length::operator > (const Length & x) const { return (value > x.value); } inline bool Length::operator <= (const Length & x) const { return (value <= x.value); } inline bool Length::operator >= (const Length & x) const { return (value >= x.value); } inline bool Length::equals(const Length & x) const { return (value == x.value); } inline bool Length::operator == (const Length & x) const { return (value == x.value); } inline bool Length::operator != (const Length & x) const { return (value != x.value); } // unary - and + operators inline Length Length::operator - () const { Length tmp; tmp.value = -value; return tmp; } inline Length Length::operator + () const { Length tmp; tmp.value = value; return tmp; } // Conversion functions inline Length::operator std::string () const { return toString(); } inline std::string Length::toString() const { return toString(value); } inline std::string Length::toStringI() const { return toString(value); } inline double Length::get() const { return value; } #ifndef WITHOUT_ACS inline asdmIDLTypes::IDLLength Length::toIDLLength() const { asdmIDLTypes::IDLLength tmp; tmp.value = value; return tmp; } #endif // Friend functions inline Length operator * ( double n, const Length &x) { Length tmp; tmp.value = x.value * n; return tmp; } inline std::ostream & operator << ( std::ostream &o, const Length &x ) { o << x.value; return o; } inline std::istream & operator >> ( std::istream &i, Length &x ) { i >> x.value; return i; } inline std::string Length::unit() { return std::string ("m"); } } // End namespace asdm #endif /* Length_CLASS */