tutils.h

Go to the documentation of this file.

/***************************************************************************
    copyright            : (C) 2013 by Tsuda Kageyu
    email                : tsuda.kageyu@gmail.com
 ***************************************************************************/

/***************************************************************************
 *   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_TUTILS_H
#define TAGLIB_TUTILS_H

// THIS FILE IS NOT A PART OF THE TAGLIB API

#ifndef DO_NOT_DOCUMENT  // tell Doxygen not to document this header

#include <cstdio>
#include <cstdarg>
#include <cstring>

#ifdef HAVE_CONFIG_H
# include "config.h"
#endif

#if defined(HAVE_MSC_BYTESWAP)
# include <stdlib.h>
#elif defined(HAVE_GLIBC_BYTESWAP)
# include <byteswap.h>
#elif defined(HAVE_MAC_BYTESWAP)
# include <libkern/OSByteOrder.h>
#elif defined(HAVE_OPENBSD_BYTESWAP)
# include <sys/endian.h>
#endif

#include "tstring.h"

namespace TagLib
{
  namespace Utils
  {
    namespace
    {

      inline unsigned short byteSwap(unsigned short x)
      {
#if defined(HAVE_GCC_BYTESWAP)

        return __builtin_bswap16(x);

#elif defined(HAVE_MSC_BYTESWAP)

        return _byteswap_ushort(x);

#elif defined(HAVE_GLIBC_BYTESWAP)

        return __bswap_16(x);

#elif defined(HAVE_MAC_BYTESWAP)

        return OSSwapInt16(x);

#elif defined(HAVE_OPENBSD_BYTESWAP)

        return swap16(x);

#else

        return ((x >> 8) & 0xff) | ((x & 0xff) << 8);

#endif
      }

      inline unsigned int byteSwap(unsigned int x)
      {
#if defined(HAVE_GCC_BYTESWAP)

        return __builtin_bswap32(x);

#elif defined(HAVE_MSC_BYTESWAP)

        return _byteswap_ulong(x);

#elif defined(HAVE_GLIBC_BYTESWAP)

        return __bswap_32(x);

#elif defined(HAVE_MAC_BYTESWAP)

        return OSSwapInt32(x);

#elif defined(HAVE_OPENBSD_BYTESWAP)

        return swap32(x);

#else

        return ((x & 0xff000000u) >> 24)
          | ((x & 0x00ff0000u) >>  8)
          | ((x & 0x0000ff00u) <<  8)
          | ((x & 0x000000ffu) << 24);

#endif
      }

      inline unsigned long long byteSwap(unsigned long long x)
      {
#if defined(HAVE_GCC_BYTESWAP)

        return __builtin_bswap64(x);

#elif defined(HAVE_MSC_BYTESWAP)

        return _byteswap_uint64(x);

#elif defined(HAVE_GLIBC_BYTESWAP)

        return __bswap_64(x);

#elif defined(HAVE_MAC_BYTESWAP)

        return OSSwapInt64(x);

#elif defined(HAVE_OPENBSD_BYTESWAP)

        return swap64(x);

#else

        return ((x & 0xff00000000000000ull) >> 56)
          | ((x & 0x00ff000000000000ull) >> 40)
          | ((x & 0x0000ff0000000000ull) >> 24)
          | ((x & 0x000000ff00000000ull) >> 8)
          | ((x & 0x00000000ff000000ull) << 8)
          | ((x & 0x0000000000ff0000ull) << 24)
          | ((x & 0x000000000000ff00ull) << 40)
          | ((x & 0x00000000000000ffull) << 56);

#endif
      }

      inline String formatString(const char *format, ...)
      {
        // Sufficient buffer size for the current internal uses.
        // Consider changing this value when you use this function.

        static const size_t BufferSize = 128;

        va_list args;
        va_start(args, format);

        char buf[BufferSize];
        int length;

        length = std::vsnprintf(buf, BufferSize, format, args);

        va_end(args);

        if(length > 0)
          return String(buf);
        return String();
      }

      enum ByteOrder
      {
        LittleEndian,
        BigEndian
      };

      constexpr ByteOrder systemByteOrder()
      {
        constexpr union IntCharUnion {
          int  i;
          char c;
          constexpr IntCharUnion(int j) : i(j) {}
        } u{1};

        if(u.c == 1)
          return LittleEndian;
        return BigEndian;
      }
    }  // namespace
  }  // namespace Utils
}  // namespace TagLib

#endif

#endif