XspfToolbox.h

Go to the documentation of this file.

/*
 * libxspf - XSPF playlist handling library
 *
 * Copyright (C) 2006-2008, Sebastian Pipping / Xiph.Org Foundation
 * All rights reserved.
 *
 * Redistribution  and use in source and binary forms, with or without
 * modification,  are permitted provided that the following conditions
 * are met:
 *
 *     * Redistributions   of  source  code  must  retain  the   above
 *       copyright  notice, this list of conditions and the  following
 *       disclaimer.
 *
 *     * Redistributions  in  binary  form must  reproduce  the  above
 *       copyright  notice, this list of conditions and the  following
 *       disclaimer   in  the  documentation  and/or  other  materials
 *       provided with the distribution.
 *
 *     * Neither  the name of the Xiph.Org Foundation nor the names of
 *       its  contributors may be used to endorse or promote  products
 *       derived  from  this software without specific  prior  written
 *       permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS  IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT  NOT
 * LIMITED  TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND  FITNESS
 * FOR  A  PARTICULAR  PURPOSE ARE DISCLAIMED. IN NO EVENT  SHALL  THE
 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL,    SPECIAL,   EXEMPLARY,   OR   CONSEQUENTIAL   DAMAGES
 * (INCLUDING,  BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES;  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
 * STRICT  LIABILITY,  OR  TORT (INCLUDING  NEGLIGENCE  OR  OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 * OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * Sebastian Pipping, sping@xiph.org
 */

#ifndef XSPF_TOOLBOX_H
#define XSPF_TOOLBOX_H


#include "XspfDefines.h"
#include <string>
#include <cstring>

namespace Xspf {


class XspfDateTime;


namespace Toolbox {



struct XspfStringCompare {

        bool operator()(XML_Char const * s1, XML_Char const * s2) const;

};



XML_Char * newAndCopy(XML_Char const * source);

void deleteNewAndCopy(XML_Char ** dest, XML_Char const * src);

void deleteNewAndCopy(XML_Char const * & dest, bool & destOwnership,
        XML_Char const * source, bool sourceCopy);

template <class T>
T const * getSetNull(T const * & dest) {
        T const * backup = dest;
        dest = NULL;
        return backup;
}


void copyIfOwned(XML_Char const * & dest, bool & ownDest, XML_Char const * source, bool ownSource);


void freeIfOwned(XML_Char const * & dest, bool ownDest);


XML_Char * makeAbsoluteUri(XML_Char const * sourceUri, XML_Char const * baseUri);


XML_Char * makeRelativeUri(XML_Char const * sourceUri, XML_Char const * baseUri);


bool isUri(XML_Char const * text);


bool isAbsoluteUri(XML_Char const * text);


bool extractInteger(XML_Char const * text, int inclusiveMinimum, int * output);


bool isWhiteSpace(XML_Char const * text, int numChars);


void cutOffWhiteSpace(XML_Char const * input, int inputNumChars,
                XML_Char const * & blackSpaceStart, int & blackSpaceNumChars);


void trimString(std::basic_string<XML_Char> & target);


} // namespace Toolbox
} // namespace Xspf

#endif // XSPF_TOOLBOX_H

---