92 lines
3.5 KiB
C++
92 lines
3.5 KiB
C++
/***************************************************************************
|
|
copyright : (C) 2002 - 2008 by Scott Wheeler
|
|
email : wheeler@kde.org
|
|
***************************************************************************/
|
|
|
|
/***************************************************************************
|
|
* This library is free software; you can redistribute it and/or modify *
|
|
* it under the terms of the GNU Lesser General Public License version *
|
|
* 2.1 as published by the Free Software Foundation. *
|
|
* *
|
|
* 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 *
|
|
* *
|
|
* Alternatively, this file is available under the Mozilla Public *
|
|
* License Version 1.1. You may obtain a copy of the License at *
|
|
* http://www.mozilla.org/MPL/ *
|
|
***************************************************************************/
|
|
|
|
#ifndef TAGLIB_BYTEVECTORLIST_H
|
|
#define TAGLIB_BYTEVECTORLIST_H
|
|
|
|
#include "taglib_export.h"
|
|
#include "tbytevector.h"
|
|
#include "tlist.h"
|
|
|
|
namespace TagLib {
|
|
|
|
//! A list of ByteVectors
|
|
|
|
/*!
|
|
* A List specialization with some handy features useful for ByteVectors.
|
|
*/
|
|
|
|
class TAGLIB_EXPORT ByteVectorList : public List<ByteVector>
|
|
{
|
|
public:
|
|
|
|
/*!
|
|
* Construct an empty ByteVectorList.
|
|
*/
|
|
ByteVectorList();
|
|
|
|
/*!
|
|
* Destroys this ByteVectorList instance.
|
|
*/
|
|
virtual ~ByteVectorList();
|
|
|
|
/*!
|
|
* Make a shallow, implicitly shared, copy of \a l. Because this is
|
|
* implicitly shared, this method is lightweight and suitable for
|
|
* pass-by-value usage.
|
|
*/
|
|
ByteVectorList(const ByteVectorList &l);
|
|
|
|
/*!
|
|
* Convert the ByteVectorList to a ByteVector separated by \a separator. By
|
|
* default a space is used.
|
|
*/
|
|
ByteVector toByteVector(const ByteVector &separator = " ") const;
|
|
|
|
/*!
|
|
* Splits the ByteVector \a v into several strings at \a pattern. This will
|
|
* not include the pattern in the returned ByteVectors.
|
|
*/
|
|
static ByteVectorList split(const ByteVector &v, const ByteVector &pattern,
|
|
int byteAlign = 1);
|
|
/*!
|
|
* Splits the ByteVector \a v into several strings at \a pattern. This will
|
|
* not include the pattern in the returned ByteVectors. \a max is the
|
|
* maximum number of entries that will be separated. If \a max for instance
|
|
* is 2 then a maximum of 1 match will be found and the vector will be split
|
|
* on that match.
|
|
*/
|
|
// BIC: merge with the function above
|
|
static ByteVectorList split(const ByteVector &v, const ByteVector &pattern,
|
|
int byteAlign, int max);
|
|
private:
|
|
class ByteVectorListPrivate;
|
|
ByteVectorListPrivate *d;
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|