ID3v2.cpp File Reference

#include <dcl/Config.h>
#include <ctype.h>
#include <stdlib.h>
#include <string.h>
#include <dcl/size_t.h>
#include <dcl/Charset.h>
#include <dcl/File.h>
#include "ID3v2.h"

Go to the source code of this file.

Macros
#define	__TRACE_THIS   0
#define	__DCL_TRACE1_N(fmt, arg)
#define	__DCL_TRACE2_N(fmt, arg1, arg2)
#define	__DCL_TRACE3_N(fmt, arg1, arg2, arg3)
#define	__DCL_TRACE4_N(fmt, arg1, arg2, arg3, arg4)
#define	__IF_ENCODING__
#define	__IF_LANGUAGE__
#define	__IF_DESCRIPTION__
#define	__IF_TEXT__
#define	__IF_URL__
#define	__IF_TYPE__
#define	__IF_BINARY__

Functions
__DCL_BEGIN_NAMESPACE	IMPLEMENT_CLASSINFO (ID3v2, Object) ID3v2
bool	__IS_UPPER (const char *_begin, const char *_end)
int	__find_frame_size_bits (char _version, const char *_begin, const char *_end, bool _debug)
	IMPLEMENT_CLASSINFO (ID3v2Frame, Object) ID3v2Frame
size_t	__decode_length__ (char _encoding, const char *_psz, size_t _max)
size_t	__skip_length__ (char _encoding, size_t _n)
bool	__valid_language_code (const char _lang[3])

Macro Definition Documentation

__DCL_TRACE1_N

#define __DCL_TRACE1_N	(		fmt,
			arg )

Definition at line 25 of file ID3v2.cpp.

__DCL_TRACE2_N

#define __DCL_TRACE2_N	(		fmt,
			arg1,
			arg2 )

Definition at line 26 of file ID3v2.cpp.

__DCL_TRACE3_N

#define __DCL_TRACE3_N	(		fmt,
			arg1,
			arg2,
			arg3 )

Definition at line 27 of file ID3v2.cpp.

__DCL_TRACE4_N

#define __DCL_TRACE4_N	(		fmt,
			arg1,
			arg2,
			arg3,
			arg4 )

Definition at line 28 of file ID3v2.cpp.

__IF_BINARY__

#define __IF_BINARY__

Value:

    if (_begin < _end) { \
        __binary.assign(_begin, _end - _begin); \
    }

__IF_DESCRIPTION__

#define __IF_DESCRIPTION__

Value:

    if (_begin < _end) { \
        size_t n = __decode_length__(__encoding, _begin, _end - _begin); \
        __description = decode(__encoding, _begin, n).trim(); \
        _begin += __skip_length__(__encoding, n); \
    }

__IF_ENCODING__

#define __IF_ENCODING__

Value:

    if (_begin < _end) { \
        __encoding = *_begin++; \
    }

__IF_LANGUAGE__

#define __IF_LANGUAGE__

Value:

    if (_begin + 3 < _end && __valid_language_code(_begin)) { \
        __url = AsciiDecoder::decode(_begin, 3).trim(); \
        _begin += 3; \
    }

__IF_TEXT__

#define __IF_TEXT__

Value:

    if (_begin < _end) { \
        size_t n = __decode_length__(__encoding, _begin, _end - _begin); \
        __text = decode(__encoding, _begin, n).trim(); \
        _begin += __skip_length__(__encoding, n); \
    }

__IF_TYPE__

#define __IF_TYPE__

Value:

    if (_begin < _end) { \
        __type = *_begin++; \
    }

__IF_URL__

#define __IF_URL__

Value:

    if (_begin < _end) { \
        size_t n = ByteString::length(_begin, _end - _begin); \
        __url = decode(0, _begin, n).trim(); \
        _begin += n + 1; \
    }

__TRACE_THIS

#define __TRACE_THIS   0

Definition at line 18 of file ID3v2.cpp.

Function Documentation

__decode_length__()

size_t __decode_length__	(	char	_encoding,
		const char *	_psz,
		size_t	_max )

Definition at line 349 of file ID3v2.cpp.

{
    __DCL_ASSERT_PARAM(_psz != NULL);
    size_t r = 0;
    if (_encoding == 1 || _encoding == 2) {
        // UTF-16 LE (1), UTF-16 BE (2)
        while ((*_psz++ | *_psz++) && r < _max) {
            r++; r++;
        }
        return r < _max ? r: _max;
    }
    else {
        // ISO-8859-1 (0), UTF-8 (3)
        // cf. ByteString::length(const char* _psz, size_t _max)
        while (*_psz++ && r < _max) {
            r++;
        }
    }
    return r;
}

__find_frame_size_bits()

int __find_frame_size_bits	(	char	_version,
		const char *	_begin,
		const char *	_end,
		bool	_debug )

Definition at line 91 of file ID3v2.cpp.

{
    size_t __3_or_4 = 3;
    size_t __6_or_10 = 6;
    if (_version > 2) {
        __3_or_4 = 4;
        __6_or_10 = 10;
    }
 
    // 8bits를 검사한다.
    const char* p = _begin;
    bool valid = true;
    while (p + __6_or_10 < _end && *p != '\0') {
        if (__IS_UPPER(p, p + __3_or_4)) {
            String name = AsciiDecoder::decode(p, __3_or_4);
            uint32_t size = ID3v2::word8(p + __3_or_4, __3_or_4);
            if (_debug) {
                __DCL_TRACE2(L"[%ls][%d]\n", name.data(), size);
            }
            p += size + __6_or_10;
        }
        else {
            if (_debug) {
                __DCL_TRACE0(L"false\n");
            }
            valid = false;
            break;
        }
    }
 
    if (p > _end || (p < _end && *p != '\0')) {
        // 마지막 프레임의 size로 인해 p가 _end 지나쳤거나
        // padding 위치가 아니면
        if (_debug) {
            __DCL_TRACE3(L"false [%p][%p][%x]\n", p, _end, *p);
        }
        valid = false;
    }
 
    if (valid) {
        return 8;
    }
 
    // 7bits를 검사한다.
    p = _begin;
    valid = true;
    while (p + __6_or_10 < _end && *p != '\0') {
        if (__IS_UPPER(p, p + __3_or_4)) {
            String name = AsciiDecoder::decode(p, __3_or_4);
            uint32_t size = ID3v2::word7(p + __3_or_4, __3_or_4);
            if (_debug) {
                __DCL_TRACE2(L"[%ls][%d]\n", name.data(), size);
            }
            p += size + __6_or_10;
        }
        else {
            if (_debug) {
                __DCL_TRACE0(L"false\n");
            }
            valid = false;
            break;
        }
    }
 
    if (p > _end || (p < _end && *p != '\0')) {
        // 마지막 프레임의 size로 인해 p가 _end 지나쳤거나
        // padding 위치가 아니면
        if (_debug) {
            __DCL_TRACE3(L"false [%p][%p][%x]\n", p, _end, *p);
        }
        valid = false;
    }
 
    if (valid) {
        return 7;
    }
 
    return 0;
}

__IS_UPPER()

bool __IS_UPPER	(	const char *	_begin,
		const char *	_end )

Definition at line 80 of file ID3v2.cpp.

{
    while (_begin < _end) {
        if (!(isupper(*_begin) || isdigit(*_begin))) {
            return false;
        }
        _begin++;
    }
    return true;
}

__skip_length__()

size_t __skip_length__	(	char	_encoding,
		size_t	_n )

Definition at line 370 of file ID3v2.cpp.

{
    // UTF-16은 $00 $00, ASCII ISO-8858-1 UTF-8는 $00
    return _encoding == 1 || _encoding == 2 ? _n + 2 : _n + 1;
}

__valid_language_code()

bool __valid_language_code

(

const char

_lang[3]

)

Definition at line 376 of file ID3v2.cpp.

{
    // https://www.loc.gov/standards/iso639-2/
    return (_lang[0] == 'X' && _lang[1] == 'X' && _lang[2] == 'X') ||
        (islower(_lang[0]) && islower(_lang[1]) && islower(_lang[2]));
}

IMPLEMENT_CLASSINFO() [1/2]

__DCL_BEGIN_NAMESPACE IMPLEMENT_CLASSINFO	(	ID3v2	,
		Object	)

Definition at line 38 of file ID3v2.cpp.

    : __header{'\0', }, __data(NULL), __fsbits(0)
{
}

IMPLEMENT_CLASSINFO() [2/2]

IMPLEMENT_CLASSINFO	(	ID3v2Frame	,
		Object	)

Definition at line 283 of file ID3v2.cpp.

    : __tag(_tag)
{
    __size = 0;
    __flags = 0;
    __encoding = 0;
    __type = 0;
}