blocxx

UTF8Utils.hpp

Go to the documentation of this file.
00001 /*******************************************************************************
00002 * Copyright (C) 2005, Vintela, Inc. All rights reserved.
00003 * Copyright (C) 2006, Novell, Inc. All rights reserved.
00004 * 
00005 * Redistribution and use in source and binary forms, with or without
00006 * modification, are permitted provided that the following conditions are met:
00007 * 
00008 *     * Redistributions of source code must retain the above copyright notice,
00009 *       this list of conditions and the following disclaimer.
00010 *     * Redistributions in binary form must reproduce the above copyright
00011 *       notice, this list of conditions and the following disclaimer in the
00012 *       documentation and/or other materials provided with the distribution.
00013 *     * Neither the name of 
00014 *       Vintela, Inc., 
00015 *       nor Novell, Inc., 
00016 *       nor the names of its contributors or employees may be used to 
00017 *       endorse or promote products derived from this software without 
00018 *       specific prior written permission.
00019 * 
00020 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
00021 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00022 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00023 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
00024 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
00025 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
00026 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
00027 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
00028 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
00029 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
00030 * POSSIBILITY OF SUCH DAMAGE.
00031 *******************************************************************************/
00032 
00033 
00038 #ifndef BLOCXX_UTF8_UTILS_HPP_INCLUDE_GUARD_
00039 #define BLOCXX_UTF8_UTILS_HPP_INCLUDE_GUARD_
00040 #include "blocxx/BLOCXX_config.h"
00041 #include "blocxx/Types.hpp"
00042 #include "blocxx/ArrayFwd.hpp"
00043 #include "blocxx/Exception.hpp"
00044 #include "blocxx/CommonFwd.hpp"
00045 
00046 namespace BLOCXX_NAMESPACE
00047 {
00048 
00049 BLOCXX_DECLARE_APIEXCEPTION(InvalidUTF8, BLOCXX_COMMON_API);
00050 
00051 namespace UTF8Utils
00052 {
00060 BLOCXX_COMMON_API size_t charCount(const char* utf8str);
00068 BLOCXX_COMMON_API UInt16 UTF8toUCS2(const char* utf8char);
00074 BLOCXX_COMMON_API String UCS2toUTF8(UInt16 ucs2char);
00081 BLOCXX_COMMON_API UInt32 UTF8toUCS4(const char* utf8char);
00087 BLOCXX_COMMON_API String UCS4toUTF8(UInt32 ucs4char);
00095 BLOCXX_COMMON_API void UCS4toUTF8(UInt32 ucs4char, StringBuffer& sb);
00096 
00105 BLOCXX_COMMON_API int compareToIgnoreCase(const char* str1, const char* str2);
00112 BLOCXX_COMMON_API Array<UInt16> StringToUCS2(const String& input);
00113 
00120 BLOCXX_COMMON_API Array<UInt16> StringToUCS2ReplaceInvalid(const String& input);
00121 
00127 BLOCXX_COMMON_API String UCS2ToString(const Array<UInt16>& input);
00133 BLOCXX_COMMON_API String UCS2ToString(const Array<char>& input);
00140 BLOCXX_COMMON_API String UCS2ToString(const void* input, size_t inputLength);
00141 
00152 BLOCXX_COMMON_API bool toUpperCaseInPlace(char* input);
00153 
00157 BLOCXX_COMMON_API String toUpperCase(const char* input);
00158 
00169 BLOCXX_COMMON_API bool toLowerCaseInPlace(char* input);
00170 
00174 BLOCXX_COMMON_API String toLowerCase(const char* input);
00175 
00176 } // end namespace UTF8Utils
00177 
00178 } // end namespace BLOCXX_NAMESPACE
00179 
00180 #endif