Chris@0: /*
Chris@0:  * libid3tag - ID3 tag manipulation library
Chris@0:  * Copyright (C) 2000-2004 Underbit Technologies, Inc.
Chris@0:  *
Chris@0:  * This program is free software; you can redistribute it and/or modify
Chris@0:  * it under the terms of the GNU General Public License as published by
Chris@0:  * the Free Software Foundation; either version 2 of the License, or
Chris@0:  * (at your option) any later version.
Chris@0:  *
Chris@0:  * This program is distributed in the hope that it will be useful,
Chris@0:  * but WITHOUT ANY WARRANTY; without even the implied warranty of
Chris@0:  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Chris@0:  * GNU General Public License for more details.
Chris@0:  *
Chris@0:  * You should have received a copy of the GNU General Public License
Chris@0:  * along with this program; if not, write to the Free Software
Chris@0:  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
Chris@0:  *
Chris@0:  * $Id: utf16.c,v 1.9 2004/01/23 09:41:32 rob Exp $
Chris@0:  */
Chris@0: 
Chris@0: # ifdef HAVE_CONFIG_H
Chris@0: #  include "config.h"
Chris@0: # endif
Chris@0: 
Chris@0: # include "global.h"
Chris@0: 
Chris@0: # include <stdlib.h>
Chris@0: 
Chris@0: # include "id3tag.h"
Chris@0: # include "utf16.h"
Chris@0: # include "ucs4.h"
Chris@0: 
Chris@0: /*
Chris@0:  * NAME:	utf16->length()
Chris@0:  * DESCRIPTION:	return the number of ucs4 chars represented by a utf16 string
Chris@0:  */
Chris@0: id3_length_t id3_utf16_length(id3_utf16_t const *utf16)
Chris@0: {
Chris@0:   id3_length_t length = 0;
Chris@0: 
Chris@0:   while (*utf16) {
Chris@0:     if (utf16[0] < 0xd800 || utf16[0] > 0xdfff)
Chris@0:       ++length;
Chris@0:     else if (utf16[0] >= 0xd800 && utf16[0] <= 0xdbff &&
Chris@0: 	     utf16[1] >= 0xdc00 && utf16[1] <= 0xdfff) {
Chris@0:       ++length;
Chris@0:       ++utf16;
Chris@0:     }
Chris@0: 
Chris@0:     ++utf16;
Chris@0:   }
Chris@0: 
Chris@0:   return length;
Chris@0: }
Chris@0: 
Chris@0: /*
Chris@0:  * NAME:	utf16->size()
Chris@0:  * DESCRIPTION:	return the encoding size of a utf16 string
Chris@0:  */
Chris@0: id3_length_t id3_utf16_size(id3_utf16_t const *utf16)
Chris@0: {
Chris@0:   id3_utf16_t const *ptr = utf16;
Chris@0: 
Chris@0:   while (*ptr)
Chris@0:     ++ptr;
Chris@0: 
Chris@0:   return ptr - utf16 + 1;
Chris@0: }
Chris@0: 
Chris@0: /*
Chris@0:  * NAME:	utf16->ucs4duplicate()
Chris@0:  * DESCRIPTION:	duplicate and decode a utf16 string into ucs4
Chris@0:  */
Chris@0: id3_ucs4_t *id3_utf16_ucs4duplicate(id3_utf16_t const *utf16)
Chris@0: {
Chris@0:   id3_ucs4_t *ucs4;
Chris@0: 
Chris@0:   ucs4 = malloc((id3_utf16_length(utf16) + 1) * sizeof(*ucs4));
Chris@0:   if (ucs4)
Chris@0:     id3_utf16_decode(utf16, ucs4);
Chris@0: 
Chris@0:   return release(ucs4);
Chris@0: }
Chris@0: 
Chris@0: /*
Chris@0:  * NAME:	utf16->decodechar()
Chris@0:  * DESCRIPTION:	decode a series of utf16 chars into a single ucs4 char
Chris@0:  */
Chris@0: id3_length_t id3_utf16_decodechar(id3_utf16_t const *utf16, id3_ucs4_t *ucs4)
Chris@0: {
Chris@0:   id3_utf16_t const *start = utf16;
Chris@0: 
Chris@0:   while (1) {
Chris@0:     if (utf16[0] < 0xd800 || utf16[0] > 0xdfff) {
Chris@0:       *ucs4 = utf16[0];
Chris@0:       return utf16 - start + 1;
Chris@0:     }
Chris@0:     else if (utf16[0] >= 0xd800 && utf16[0] <= 0xdbff &&
Chris@0: 	     utf16[1] >= 0xdc00 && utf16[1] <= 0xdfff) {
Chris@0:       *ucs4 = (((utf16[0] & 0x03ffL) << 10) |
Chris@0: 	       ((utf16[1] & 0x03ffL) <<  0)) + 0x00010000L;
Chris@0:       return utf16 - start + 2;
Chris@0:     }
Chris@0: 
Chris@0:     ++utf16;
Chris@0:   }
Chris@0: }
Chris@0: 
Chris@0: /*
Chris@0:  * NAME:	utf16->encodechar()
Chris@0:  * DESCRIPTION:	encode a single ucs4 char into a series of up to 2 utf16 chars
Chris@0:  */
Chris@0: id3_length_t id3_utf16_encodechar(id3_utf16_t *utf16, id3_ucs4_t ucs4)
Chris@0: {
Chris@0:   if (ucs4 < 0x00010000L) {
Chris@0:     utf16[0] = ucs4;
Chris@0: 
Chris@0:     return 1;
Chris@0:   }
Chris@0:   else if (ucs4 < 0x00110000L) {
Chris@0:     ucs4 -= 0x00010000L;
Chris@0: 
Chris@0:     utf16[0] = ((ucs4 >> 10) & 0x3ff) | 0xd800;
Chris@0:     utf16[1] = ((ucs4 >>  0) & 0x3ff) | 0xdc00;
Chris@0: 
Chris@0:     return 2;
Chris@0:   }
Chris@0: 
Chris@0:   /* default */
Chris@0: 
Chris@0:   return id3_utf16_encodechar(utf16, ID3_UCS4_REPLACEMENTCHAR);
Chris@0: }
Chris@0: 
Chris@0: /*
Chris@0:  * NAME:	utf16->decode()
Chris@0:  * DESCRIPTION:	decode a complete utf16 string into a ucs4 string
Chris@0:  */
Chris@0: void id3_utf16_decode(id3_utf16_t const *utf16, id3_ucs4_t *ucs4)
Chris@0: {
Chris@0:   do
Chris@0:     utf16 += id3_utf16_decodechar(utf16, ucs4);
Chris@0:   while (*ucs4++);
Chris@0: }
Chris@0: 
Chris@0: /*
Chris@0:  * NAME:	utf16->encode()
Chris@0:  * DESCRIPTION:	encode a complete ucs4 string into a utf16 string
Chris@0:  */
Chris@0: void id3_utf16_encode(id3_utf16_t *utf16, id3_ucs4_t const *ucs4)
Chris@0: {
Chris@0:   do
Chris@0:     utf16 += id3_utf16_encodechar(utf16, *ucs4);
Chris@0:   while (*ucs4++);
Chris@0: }
Chris@0: 
Chris@0: /*
Chris@0:  * NAME:	utf16->put()
Chris@0:  * DESCRIPTION:	serialize a single utf16 character
Chris@0:  */
Chris@0: id3_length_t id3_utf16_put(id3_byte_t **ptr, id3_utf16_t utf16,
Chris@0: 			   enum id3_utf16_byteorder byteorder)
Chris@0: {
Chris@0:   if (ptr) {
Chris@0:     switch (byteorder) {
Chris@0:     default:
Chris@0:     case ID3_UTF16_BYTEORDER_BE:
Chris@0:       (*ptr)[0] = (utf16 >> 8) & 0xff;
Chris@0:       (*ptr)[1] = (utf16 >> 0) & 0xff;
Chris@0:       break;
Chris@0: 
Chris@0:     case ID3_UTF16_BYTEORDER_LE:
Chris@0:       (*ptr)[0] = (utf16 >> 0) & 0xff;
Chris@0:       (*ptr)[1] = (utf16 >> 8) & 0xff;
Chris@0:       break;
Chris@0:     }
Chris@0: 
Chris@0:     *ptr += 2;
Chris@0:   }
Chris@0: 
Chris@0:   return 2;
Chris@0: }
Chris@0: 
Chris@0: /*
Chris@0:  * NAME:	utf16->get()
Chris@0:  * DESCRIPTION:	deserialize a single utf16 character
Chris@0:  */
Chris@0: id3_utf16_t id3_utf16_get(id3_byte_t const **ptr,
Chris@0: 			  enum id3_utf16_byteorder byteorder)
Chris@0: {
Chris@0:   id3_utf16_t utf16;
Chris@0: 
Chris@0:   switch (byteorder) {
Chris@0:   default:
Chris@0:   case ID3_UTF16_BYTEORDER_BE:
Chris@0:     utf16 =
Chris@0:       ((*ptr)[0] << 8) |
Chris@0:       ((*ptr)[1] << 0);
Chris@0:     break;
Chris@0: 
Chris@0:   case ID3_UTF16_BYTEORDER_LE:
Chris@0:     utf16 =
Chris@0:       ((*ptr)[0] << 0) |
Chris@0:       ((*ptr)[1] << 8);
Chris@0:     break;
Chris@0:   }
Chris@0: 
Chris@0:   *ptr += 2;
Chris@0: 
Chris@0:   return utf16;
Chris@0: }
Chris@0: 
Chris@0: /*
Chris@0:  * NAME:	utf16->serialize()
Chris@0:  * DESCRIPTION:	serialize a ucs4 string using utf16 encoding
Chris@0:  */
Chris@0: id3_length_t id3_utf16_serialize(id3_byte_t **ptr, id3_ucs4_t const *ucs4,
Chris@0: 				 enum id3_utf16_byteorder byteorder,
Chris@0: 				 int terminate)
Chris@0: {
Chris@0:   id3_length_t size = 0;
Chris@0:   id3_utf16_t utf16[2], *out;
Chris@0: 
Chris@0:   if (byteorder == ID3_UTF16_BYTEORDER_ANY)
Chris@0:     size += id3_utf16_put(ptr, 0xfeff, byteorder);
Chris@0: 
Chris@0:   while (*ucs4) {
Chris@0:     switch (id3_utf16_encodechar(out = utf16, *ucs4++)) {
Chris@0:     case 2: size += id3_utf16_put(ptr, *out++, byteorder);
Chris@0:     case 1: size += id3_utf16_put(ptr, *out++, byteorder);
Chris@0:     case 0: break;
Chris@0:     }
Chris@0:   }
Chris@0: 
Chris@0:   if (terminate)
Chris@0:     size += id3_utf16_put(ptr, 0, byteorder);
Chris@0: 
Chris@0:   return size;
Chris@0: }
Chris@0: 
Chris@0: /*
Chris@0:  * NAME:	utf16->deserialize()
Chris@0:  * DESCRIPTION:	deserialize a ucs4 string using utf16 encoding
Chris@0:  */
Chris@0: id3_ucs4_t *id3_utf16_deserialize(id3_byte_t const **ptr, id3_length_t length,
Chris@0: 				  enum id3_utf16_byteorder byteorder)
Chris@0: {
Chris@0:   id3_byte_t const *end;
Chris@0:   id3_utf16_t *utf16ptr, *utf16;
Chris@0:   id3_ucs4_t *ucs4;
Chris@0: 
Chris@0:   end = *ptr + (length & ~1);
Chris@0: 
Chris@0:   utf16 = malloc((length / 2 + 1) * sizeof(*utf16));
Chris@0:   if (utf16 == 0)
Chris@0:     return 0;
Chris@0: 
Chris@0:   if (byteorder == ID3_UTF16_BYTEORDER_ANY && end - *ptr > 0) {
Chris@0:     switch (((*ptr)[0] << 8) |
Chris@0: 	    ((*ptr)[1] << 0)) {
Chris@0:     case 0xfeff:
Chris@0:       byteorder = ID3_UTF16_BYTEORDER_BE;
Chris@0:       *ptr += 2;
Chris@0:       break;
Chris@0: 
Chris@0:     case 0xfffe:
Chris@0:       byteorder = ID3_UTF16_BYTEORDER_LE;
Chris@0:       *ptr += 2;
Chris@0:       break;
Chris@0:     }
Chris@0:   }
Chris@0: 
Chris@0:   utf16ptr = utf16;
Chris@0:   while (end - *ptr > 0 && (*utf16ptr = id3_utf16_get(ptr, byteorder)))
Chris@0:     ++utf16ptr;
Chris@0: 
Chris@0:   *utf16ptr = 0;
Chris@0: 
Chris@0:   ucs4 = malloc((id3_utf16_length(utf16) + 1) * sizeof(*ucs4));
Chris@0:   if (ucs4)
Chris@0:     id3_utf16_decode(utf16, ucs4);
Chris@0: 
Chris@0:   free(utf16);
Chris@0: 
Chris@0:   return ucs4;
Chris@0: }