MboStrList.h

Go to the documentation of this file.

/*****************************************************************************
* Copyright (c) 2001 - 2008 Marcus Boerger.  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., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
* ========================================================================= */

/* ------------------------------------------------------------------------ */
/* Name:      MboStrList.h
 *
 * Requires:  
 * - Mbo.h
 * - MboStrHelper.h
 * - list2.h
 * - vector2.h
 * - map2.h
 */
/* ------------------------------------------------------------------------ */

#ifndef _MBOSTRLIST_H_
#define _MBOSTRLIST_H_

#include "Mbo.h"

#include "map2.h"
#include "list2.h"
#include "vector2.h"
#include "MboStrHelper.h"

#if defined(_MSC_VER)
# pragma warning(push)
# pragma warning(disable: 4251) // disable warning C4251: '...' : class '...' needs to have dll-interface to be used by clients of class '...'
# pragma warning(disable: 4275) // non dll-interface class '...' used as base for dll-interface class '...'
#endif

namespace mbo {

#define CStrListContainer std::deque2

class MBO_API CStrList: public CStrListContainer<MboString> // vstr
{
public:

    CStrList();

    CStrList(_IN const CStrListContainer<MboString> &other);

    explicit CStrList(_IN const MboString & str);

    virtual ~CStrList();

    MboString ToCStr(_IN const MboString & strSplit = ",") const;

    static int Explode(
            _IN  const char * szInput, 
            _IN  const char * szSplit,
            _OUT CStrList &   vstrResult,
            _IN  bool         bClearInput = true,
            _IN  bool         bTrim       = false
        );

    static int Explode(
            _IN  const MboString & strInput, 
            _IN  const MboString & strSplit,
            _OUT CStrList &        vstrResult,
            _IN  bool              bClearInput = true,
            _IN  bool              bTrim       = false
        );

    static int ExplodeZZString(
            _IN  const char *      szList, 
            _OUT CStrList &        vstrResult,
            _IN  bool              bClearInput = true,
            _IN  bool              bTrim       = false
        );

    virtual bool add_if_prefix_match(
            _IN const MboString &  strValue,
            _IN const MboString &  strPrefix,
            _IN bool               bCaseSensitive = false,
            _IN bool               bOnlyNew       = false
        );

    CStrList & operator = (_IN const std::deque<MboString> & values);

    /* std::list based assignment
     * \note the list will be emptied before assignment
     * \param values container with elements to assign
     */
//  CStrList & operator = (_IN const std::list<MboString> & values);

    /* std::vector based assignment
     * \note the list will be emptied before assignment
     * \param values container with elements to assign
     */
//  CStrList & operator = (_IN const std::vector<MboString> & values);
};

#ifndef MboStrList0

#define MboStrList0()                 mbo::CStrList()
#endif
#ifndef MboStrList1

#define MboStrList1(s1)               mbo::CStrList::dyn_create(1, MboString(_CT(s1)))
#endif
#ifndef MboStrList2

#define MboStrList2(s1,s2)            mbo::CStrList::dyn_create(2, MboString(_CT(s1)), MboString(_CT(s2)))
#endif
#ifndef MboStrList3

#define MboStrList3(s1,s2,s3)         mbo::CStrList::dyn_create(3, MboString(_CT(s1)), MboString(_CT(s2)), MboString(_CT(s3)))
#endif
#ifndef MboStrList4

#define MboStrList4(s1,s2,s3,s4)      mbo::CStrList::dyn_create(4, MboString(_CT(s1)), MboString(_CT(s2)), MboString(_CT(s3)), MboString(_CT(s4)))
#endif
#ifndef MboStrList5

#define MboStrList5(s1,s2,s3,s4,s5)   mbo::CStrList::dyn_create(5, MboString(_CT(s1)), MboString(_CT(s2)), MboString(_CT(s3)), MboString(_CT(s4)), MboString(_CT(s5)))
#endif

#ifdef SUPPORT_IOSTREAM

MBO_API std::ostream& operator<< (
        _IN std::ostream&    _Ostr,
        _IN const CStrList&  _vstr
    );

#endif // SUPPORT_IOSTREAM

#ifdef _MSC_VER
# pragma warning(pop)
#endif

}; // namespace mbo

#endif //_MBOSTRLIST_H_

---