safestrings.h

Go to the documentation of this file.

/*
 *
 *
 * Inter Asterisk Exchange 2
 * 
 * Provide string list handling in a thread safe fashion.
 * 
 * Open Phone Abstraction Library (OPAL)
 *
 * Copyright (c) 2005 Indranet Technologies Ltd.
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * The Original Code is Open Phone Abstraction Library.
 *
 * The Initial Developer of the Original Code is Indranet Technologies Ltd.
 *
 * The author of this code is Derek J Smithies
 *
 *  $Log: safestrings.h,v $
 *  Revision 1.4  2007/04/19 06:17:21  csoutheren
 *  Fixes for precompiled headers with gcc
 *
 *  Revision 1.3  2007/01/17 22:27:52  dereksmithies
 *  Correctly sends DTMF to remote node. Tidy up string handling.
 *
 *  Revision 1.2  2005/08/24 04:56:25  dereksmithies
 *  Add code from Adrian Sietsma to send FullFrameTexts and FullFrameDtmfs to
 *  the remote end.  Many Thanks.
 *
 *  Revision 1.1  2005/07/30 07:01:32  csoutheren
 *  Added implementation of IAX2 (Inter Asterisk Exchange 2) protocol
 *  Thanks to Derek Smithies of Indranet Technologies Ltd. for
 *  writing and contributing this code
 *
 *
 *
 *
 */

#ifndef SAFESTRINGS_H
#define SAFESTRINGS_H

#ifndef _PTLIB_H
#include <ptlib.h>
#endif

#ifdef P_USE_PRAGMA
#pragma interface
#endif


class SafeStrings :  public PObject
{
  PCLASSINFO(SafeStrings, PObject);
 public:
  SafeStrings();
  
  ~SafeStrings();
  
  
  void AppendString(const PString & newString,        
                    PBoolean splitString = PFalse   
                    );
  
  void AppendString(const char *newString,     
                    PBoolean splitString = PFalse   
                    ) { PString s(newString); AppendString(s, splitString); }
  
  PBoolean GetNextString(PString & nextString 
                     );
  
  PBoolean IsEmpty();

  PBoolean StringsAvailable() { return !IsEmpty(); }
  
  PString GetFirstDeleteAll();
  
  void GetAllDeleteAll(PStringArray & res);
  
 protected:
  PMutex accessMutex;
  
  PStringArray data;
};


class SafeString : public PObject
{
  PCLASSINFO(SafeString, PObject);
 public:
  SafeString() { internal = PString::Empty(); }
  
  SafeString(PString newValue) { internal = newValue; }
  
  void operator = (PString newValue);
  
  PString Get() { PWaitAndSignal m(mutex); return internal; }
  
  virtual void PrintOn(ostream & str) const;
  
  operator PString();
  
  void operator += (PString toBeAdded);

  PString GetAndDelete();

  PBoolean IsEmpty() const;


 protected:
  PString internal;
  
  PMutex mutex;
};


#endif // SAFESTRINGS_H
/* The comment below is magic for those who use emacs to edit this file. */
/* With the comment below, the tab key does auto indent to 4 spaces.     */

/*
 * Local Variables:
 * mode:c
 * c-file-style:linux
 * c-basic-offset:2
 * End:
 */

---