StringPimpl.h

#ifndef REBECCA_STRINGPIMPL_H
#define REBECCA_STRINGPIMPL_H

/*
 * RebeccaAIML, Artificial Intelligence Markup Language 
 * C++ api and engine.
 *
 * Copyright (C) 2005 Frank Hassanabad
 *
 * 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., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */


//To get the REBECA_EXPORT macro
#include <rebecca/exports.h>

#include <rebecca/Exceptions.h>

/* Disable Windows VC 7.x warning about 
 * it ignoring the throw specification
 */
#ifdef _WIN32
#    pragma warning ( push )
#    pragma warning( disable : 4290 )
#endif


//See AimlFacade for the explanation of this namespace
namespace rebecca
{
//See AimlFacade for the explanation of this namespace
namespace impl
{



/*
 * The private String which I do not expose.
 * 
 * This forward decleration is so that the code will 
 * compile but the true string is kept private within
 * this class.
 */ 
class StringPrivate;

class REBECCA_EXPORT StringPimpl
{
    public:

        StringPimpl() throw(Exception &);

        StringPimpl(const char * const stringPimpl) throw(Exception &);
        
        const char *c_str() const throw(Exception &);

        bool empty() const throw(Exception &);

        StringPimpl(const StringPimpl& stringPimpl);

        StringPimpl &operator=(const StringPimpl &stringPimpl);

        virtual ~StringPimpl();
        
        void operator delete(void* p);

        void *operator new(unsigned int size);

    private:

        void init(const char * const stringPimpl);
        
        StringPrivate *m_pimpl;
};

} //end namespace impl

//expose StringPimpl to Rebecca namespace 
using rebecca::impl::StringPimpl;

} //end namespace rebecca

#ifdef _WIN32
#    pragma warning ( pop )
#endif





#endif

---