interpretor/faust-0.9.47mr3/architecture/osclib/faust/src/msg/Message.h

   1 /*
   2
   3   Copyright (C) 2011  Grame
   4
   5   This library is free software; you can redistribute it and/or
   6   modify it under the terms of the GNU Lesser General Public
   7   License as published by the Free Software Foundation; either
   8   version 2.1 of the License, or (at your option) any later version.
   9
  10   This library is distributed in the hope that it will be useful,
  11   but WITHOUT ANY WARRANTY; without even the implied warranty of
  12   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13   Lesser General Public License for more details.
  14
  15   You should have received a copy of the GNU Lesser General Public
  16   License along with this library; if not, write to the Free Software
  17   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  18
  19   Grame Research Laboratory, 9 rue du Garet, 69001 Lyon - France
  20   research@grame.fr
  21
  22 */
  23
  24
  25 #ifndef __Message__
  26 #define __Message__
  27
  28 #include <string>
  29 #include <vector>
  30 #include <iostream>
  31 #include "smartpointer.h"
  32
  33 namespace oscfaust
  34 {
  35
  36 class OSCStream;
  37 template <typename T> class MsgParam;
  38 class baseparam;
  39 typedef SMARTP<baseparam>       Sbaseparam;
  40
  41 //--------------------------------------------------------------------------
  42 /*!
  43         \brief base class of a message parameters
  44 */
  45 class baseparam : public smartable
  46 {
  47         public:
  48                 virtual ~baseparam() {}
  49
  50                 /*!
  51                  \brief utility for parameter type checking
  52                 */
  53                 template<typename X> bool isType() const { return dynamic_cast<const MsgParam<X>*> (this) != 0; }
  54                 /*!
  55                  \brief utility for parameter convertion
  56                  \param errvalue the returned value when no conversion applies
  57                  \return the parameter value when the type matches
  58                 */
  59                 template<typename X> X  value(X errvalue) const
  60                         { const MsgParam<X>* o = dynamic_cast<const MsgParam<X>*> (this); return o ? o->getValue() : errvalue; }
  61                 /*!
  62                  \brief utility for parameter comparison
  63                 */
  64                 template<typename X> bool       equal(const baseparam& p) const
  65                         {
  66                                 const MsgParam<X>* a = dynamic_cast<const MsgParam<X>*> (this);
  67                                 const MsgParam<X>* b = dynamic_cast<const MsgParam<X>*> (&p);
  68                                 return a && b && (a->getValue() == b->getValue());
  69                         }
  70                 /*!
  71                  \brief utility for parameter comparison
  72                 */
  73                 bool operator==(const baseparam& p) const
  74                         {
  75                                 return equal<float>(p) || equal<int>(p) || equal<std::string>(p);
  76                         }
  77                 bool operator!=(const baseparam& p) const
  78                         {
  79                                 return !equal<float>(p) && !equal<int>(p) && !equal<std::string>(p);
  80                         }
  81
  82                 virtual SMARTP<baseparam> copy() const = 0;
  83 };
  84
  85 //--------------------------------------------------------------------------
  86 /*!
  87         \brief template for a message parameter
  88 */
  89 template <typename T> class MsgParam : public baseparam
  90 {
  91         T fParam;
  92         public:
  93                                  MsgParam(T val) : fParam(val)  {}
  94                 virtual ~MsgParam() {}
  95
  96                 T       getValue() const { return fParam; }
  97
  98                 virtual SMARTP<baseparam> copy() const { return new MsgParam<T>(fParam); }
  99 };
 100
 101 //--------------------------------------------------------------------------
 102 /*!
 103         \brief a message description
 104
 105         A message is composed of an address (actually an OSC address),
 106         a message string that may be viewed as a method name
 107         and a list of message parameters.
 108 */
 109 class Message
 110 {
 111         public:
 112                 typedef SMARTP<baseparam>               argPtr;         ///< a message argument ptr type
 113                 typedef std::vector<argPtr>             argslist;       ///< args list type
 114
 115         private:
 116                 unsigned long   fSrcIP;                 ///< the message source IP number
 117                 std::string     fAddress;                       ///< the message osc destination address
 118                 argslist        fArguments;                     ///< the message arguments
 119
 120         public:
 121                         /*!
 122                                 \brief an empty message constructor
 123                         */
 124                          Message() {}
 125                         /*!
 126                                 \brief a message constructor
 127                                 \param address the message destination address
 128                         */
 129                          Message(const std::string& address) : fAddress(address) {}
 130                         /*!
 131                                 \brief a message constructor
 132                                 \param address the message destination address
 133                                 \param args the message parameters
 134                         */
 135                          Message(const std::string& address, const argslist& args)
 136                                 : fAddress(address), fArguments(args) {}
 137                         /*!
 138                                 \brief a message constructor
 139                                 \param msg a message
 140                         */
 141                          Message(const Message& msg);
 142         virtual ~Message() {} //{ freed++; std::cout << "running messages: " << (allocated - freed) << std::endl; }
 143
 144         /*!
 145                 \brief adds a parameter to the message
 146                 \param val the parameter
 147         */
 148         template <typename T> void add(T val)   { fArguments.push_back(new MsgParam<T>(val)); }
 149         /*!
 150                 \brief adds a float parameter to the message
 151                 \param val the parameter value
 152         */
 153         void    add(float val)                                  { add<float>(val); }
 154         /*!
 155                 \brief adds an int parameter to the message
 156                 \param val the parameter value
 157         */
 158         void    add(int val)                                    { add<int>(val); }
 159         /*!
 160                 \brief adds a string parameter to the message
 161                 \param val the parameter value
 162         */
 163         void    add(const std::string& val)             { add<std::string>(val); }
 164
 165         /*!
 166                 \brief adds a parameter to the message
 167                 \param val the parameter
 168         */
 169         void    add( argPtr val )                               { fArguments.push_back( val ); }
 170
 171         /*!
 172                 \brief sets the message address
 173                 \param addr the address
 174         */
 175         void                            setSrcIP(unsigned long addr)            { fSrcIP = addr; }
 176
 177         /*!
 178                 \brief sets the message address
 179                 \param addr the address
 180         */
 181         void                            setAddress(const std::string& addr)             { fAddress = addr; }
 182         /*!
 183                 \brief print the message
 184                 \param out the output stream
 185         */
 186         void                            print(std::ostream& out) const;
 187         /*!
 188                 \brief send the message to OSC
 189                 \param out the OSC output stream
 190         */
 191         void                            print(OSCStream& out) const;
 192         /*!
 193                 \brief print message arguments
 194                 \param out the OSC output stream
 195         */
 196         void                            printArgs(OSCStream& out) const;
 197
 198         /// \brief gives the message address
 199         const std::string&      address() const         { return fAddress; }
 200         /// \brief gives the message parameters list
 201         const argslist&         params() const          { return fArguments; }
 202         /// \brief gives the message parameters list
 203         argslist&                       params()                        { return fArguments; }
 204         /// \brief gives the message source IP
 205         unsigned long           src() const                     { return fSrcIP; }
 206         /// \brief gives the message parameters count
 207         int                                     size() const            { return fArguments.size(); }
 208
 209         bool operator == (const Message& other) const;
 210
 211
 212         /*!
 213                 \brief gives a message float parameter
 214                 \param i the parameter index (0 <= i < size())
 215                 \param val on output: the parameter value when the parameter type matches
 216                 \return false when types don't match
 217         */
 218         bool    param(int i, float& val) const          { val = params()[i]->value<float>(val); return params()[i]->isType<float>(); }
 219         /*!
 220                 \brief gives a message int parameter
 221                 \param i the parameter index (0 <= i < size())
 222                 \param val on output: the parameter value when the parameter type matches
 223                 \return false when types don't match
 224         */
 225         bool    param(int i, int& val) const            { val = params()[i]->value<int>(val); return params()[i]->isType<int>(); }
 226         /*!
 227                 \brief gives a message int parameter
 228                 \param i the parameter index (0 <= i < size())
 229                 \param val on output: the parameter value when the parameter type matches
 230                 \return false when types don't match
 231         */
 232         bool    param(int i, unsigned int& val) const           { val = params()[i]->value<int>(val); return params()[i]->isType<int>(); }
 233         /*!
 234                 \brief gives a message int parameter
 235                 \param i the parameter index (0 <= i < size())
 236                 \param val on output: the parameter value when the parameter type matches
 237                 \return false when types don't match
 238                 \note a boolean value is handled as integer
 239         */
 240         bool    param(int i, bool& val) const           { int ival = 0; ival = params()[i]->value<int>(ival); val = ival!=0; return params()[i]->isType<int>(); }
 241         /*!
 242                 \brief gives a message int parameter
 243                 \param i the parameter index (0 <= i < size())
 244                 \param val on output: the parameter value when the parameter type matches
 245                 \return false when types don't match
 246         */
 247         bool    param(int i, long int& val) const       { val = long(params()[i]->value<int>(val)); return params()[i]->isType<int>(); }
 248         /*!
 249                 \brief gives a message string parameter
 250                 \param i the parameter index (0 <= i < size())
 251                 \param val on output: the parameter value when the parameter type matches
 252                 \return false when types don't match
 253         */
 254         bool    param(int i, std::string& val) const { val = params()[i]->value<std::string>(val); return params()[i]->isType<std::string>(); }
 255 };
 256
 257
 258 } // end namespoace
 259
 260 #endif