under dramatic changes...

include/h2/cmn/str-priv.h

@@ -0,0 +1,15 @@
+/* This is a private header. */
+
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+int H2_XFUN(strcmp) (const h2_xchar_t* str1, const h2_xchar_t* str2);
+h2_size_t H2_XFUN(strcpy) (h2_xchar_t* dst, const h2_xchar_t* src);
+h2_size_t H2_XFUN(strfmc) (h2_xchar_t* buf, const h2_xchar_t* fmt, const h2_xchar_t* str[]);
+h2_size_t H2_XFUN(strlen) (const h2_xchar_t* str);
+
+#ifdef __cplusplus
+}
+#endif

include/h2/cmn/str.h

@@ -0,0 +1,36 @@
+#ifndef _H2_STR_H_
+#define _H2_STR_H_
+
+#include <h2/types.h>
+#include <h2/macros.h>
+
+#if defined(H2_ENABLE_MCHAR)
+#	define h2_xchar_t h2_mchar_t
+#	define H2_XFUN(x) H2_FUN_M(x)
+#	include "str-priv.h"
+#	undef h2_xchar_t
+#	undef H2_XFUN
+#endif
+
+#if defined(H2_ENABLE_WCHAR)
+#	define h2_xchar_t h2_wchar_t
+#	define H2_XFUN(x) H2_FUN_W(x)
+#	include "str-priv.h"
+#	undef h2_xchar_t
+#	undef H2_XFUN
+#endif
+
+#if defined(H2_ENABLE_WWCHAR)
+#	define h2_xchar_t h2_wwchar_t
+#	define H2_XFUN(x) H2_FUN_WW(x)
+#	include "str-priv.h"
+#	undef h2_xchar_t
+#	undef H2_XFUN
+#endif
+
+#define h2_strcmp  H2_FUN(strcmp)
+#define h2_strcpy  H2_FUN(strcpy)
+#define h2_strfmc  H2_FUN(strfmc)
+#define h2_strlen  H2_FUN(strlen)
+
+#endif

include/h2/cmn/utf8.h

@@ -0,0 +1,109 @@
+/*
+ * $Id$
+ *
+    Copyright 2006-2014 Chung, Hyung-Hwan.
+    This file is part of H2.
+
+    H2 is free software: you can redistribute it and/or modify
+    it under the terms of the GNU Lesser General Public License as 
+    published by the Free Software Foundation, either version 3 of 
+    the License, or (at your option) any later version.
+
+    H2 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 H2. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef _H2_CMN_UTF8_H_
+#define _H2_CMN_UTF8_H_
+
+#include <h2/types.h>
+#include <h2/macros.h>
+
+/** \file
+ * This file provides functions, types, macros for utf8 conversion.
+ */
+
+/**
+ * The H2_UTF8LEN_MAX macro defines the maximum number of bytes
+ * needed to form a single unicode character.
+ */
+#if H2_SIZEOF_WXCHAR_T == 2
+#	define H2_UTF8LEN_MAX 3
+#elif H2_SIZEOF_WXCHAR_T == 4
+#	define H2_UTF8LEN_MAX 6
+#else
+#	error Unsupported wide character size
+#endif
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/** 
+ * The h2_uctoutf8() function converts a unicode character to a utf8 sequence.
+ * \return 
+ * - 0 is returned if \a uc is invalid. 
+ * - An integer greater than \a size is returned if the \a utf8 sequence buffer 
+ *   is not #H2_NULL and not large enough. This integer is actually the number 
+ *   of bytes needed.
+ * - If \a utf8 is #H2_NULL, the number of bytes that would have been stored 
+ *   into \a utf8 if it had not been #H2_NULL is returned.
+ * - An integer between 1 and size inclusive is returned in all other cases.
+ * \note
+ * This function doesn't check invalid unicode code points and performs
+ * conversion compuationally.
+ */
+h2_size_t h2_uctoutf8 (
+	h2_wxchar_t  uc,
+	h2_mchar_t* utf8,
+	h2_size_t   size
+);
+
+/**
+ * The h2_utf8touc() function converts a utf8 sequence to a unicode character.
+ * \return
+ * - 0 is returned if the \a utf8 sequence is invalid.
+ * - An integer greater than \a size is returned if the \a utf8 sequence is 
+ *   not complete.
+ * - An integer between 1 and size inclusive is returned in all other cases.
+ */
+h2_size_t h2_utf8touc (
+	const h2_mchar_t* utf8,
+	h2_size_t         size, 
+	h2_wxchar_t*      uc
+);
+
+/**
+ * The h2_utf8len() function scans at most \a size bytes from the \a utf8 
+ * sequence and returns the number of bytes needed to form a single unicode
+ * character.
+ * \return
+ * - 0 is returned if the \a utf8 sequence is invalid.
+ * - An integer greater than \a size is returned if the \a utf8 sequence is 
+ *   not complete.
+ * - An integer between 1 and size inclusive is returned in all other cases.
+ */ 
+h2_size_t h2_utf8len (
+	const h2_mchar_t* utf8,
+	h2_size_t         size
+);
+
+/**
+ * The h2_utf8lenmax() function returns the maximum number of bytes needed 
+ * to form a single unicode character. Use #H2_UTF8LEN_MAX if you need a 
+ * compile-time constant.
+ */
+h2_size_t h2_utf8lenmax (
+	void
+);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif