mirror of https://github.com/axmolengine/axmol.git
322 lines
11 KiB
C++
322 lines
11 KiB
C++
/****************************************************************************
|
|
Copyright (c) 2014 cocos2d-x.org
|
|
Copyright (c) 2014-2017 Chukong Technologies Inc.
|
|
|
|
http://www.cocos2d-x.org
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
THE SOFTWARE.
|
|
****************************************************************************/
|
|
|
|
#ifndef __cocos2dx__ccUTF8__
|
|
#define __cocos2dx__ccUTF8__
|
|
|
|
#include "platform/CCPlatformMacros.h"
|
|
#include <vector>
|
|
#include <string>
|
|
#include <sstream>
|
|
|
|
#if (CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID)
|
|
#include "platform/android/jni/JniHelper.h"
|
|
#endif
|
|
|
|
NS_CC_BEGIN
|
|
|
|
namespace StringUtils {
|
|
|
|
template<typename T>
|
|
std::string toString(T arg)
|
|
{
|
|
std::stringstream ss;
|
|
ss << arg;
|
|
return ss.str();
|
|
}
|
|
|
|
std::string CC_DLL format(const char* format, ...) CC_FORMAT_PRINTF(1, 2);
|
|
|
|
/**
|
|
* @brief Converts from UTF8 string to UTF16 string.
|
|
*
|
|
* This function resizes \p outUtf16 to required size and
|
|
* fill its contents with result UTF16 string if conversion success.
|
|
* If conversion fails it guarantees not to change \p outUtf16.
|
|
*
|
|
* @param inUtf8 The source UTF8 string to be converted from.
|
|
* @param outUtf16 The output string to hold the result UTF16s.
|
|
* @return True if succeed, otherwise false.
|
|
* @note Please check the return value before using \p outUtf16
|
|
* e.g.
|
|
* @code
|
|
* std::u16string utf16;
|
|
* bool ret = StringUtils::UTF8ToUTF16("你好hello", utf16);
|
|
* if (ret) {
|
|
* do_some_thing_with_utf16(utf16);
|
|
* }
|
|
* @endcode
|
|
*/
|
|
CC_DLL bool UTF8ToUTF16(const std::string& inUtf8, std::u16string& outUtf16);
|
|
|
|
/**
|
|
* @brief Same as \a UTF8ToUTF16 but converts form UTF8 to UTF32.
|
|
*
|
|
* @see UTF8ToUTF16
|
|
*/
|
|
CC_DLL bool UTF8ToUTF32(const std::string& inUtf8, std::u32string& outUtf32);
|
|
|
|
/**
|
|
* @brief Same as \a UTF8ToUTF16 but converts form UTF16 to UTF8.
|
|
*
|
|
* @see UTF8ToUTF16
|
|
*/
|
|
CC_DLL bool UTF16ToUTF8(const std::u16string& inUtf16, std::string& outUtf8);
|
|
|
|
/**
|
|
* @brief Same as \a UTF8ToUTF16 but converts form UTF16 to UTF32.
|
|
*
|
|
* @see UTF8ToUTF16
|
|
*/
|
|
CC_DLL bool UTF16ToUTF32(const std::u16string& inUtf16, std::u32string& outUtf32);
|
|
|
|
/**
|
|
* @brief Same as \a UTF8ToUTF16 but converts form UTF32 to UTF8.
|
|
*
|
|
* @see UTF8ToUTF16
|
|
*/
|
|
CC_DLL bool UTF32ToUTF8(const std::u32string& inUtf32, std::string& outUtf8);
|
|
|
|
/**
|
|
* @brief Same as \a UTF8ToUTF16 but converts form UTF32 to UTF16.
|
|
*
|
|
* @see UTF8ToUTF16
|
|
*/
|
|
CC_DLL bool UTF32ToUTF16(const std::u32string& inUtf32, std::u16string& outUtf16);
|
|
|
|
|
|
|
|
#if (CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID)
|
|
|
|
|
|
/**
|
|
* @brief convert jstring to utf8 std::string, same function with env->getStringUTFChars.
|
|
* because getStringUTFChars can not pass special emoticon
|
|
* @param env The JNI Env
|
|
* @param srcjStr The jstring which want to convert
|
|
* @param ret True if the conversion succeeds and the ret pointer isn't null
|
|
* @returns the result of utf8 string
|
|
*/
|
|
CC_DLL std::string getStringUTFCharsJNI(JNIEnv* env, jstring srcjStr, bool* ret = nullptr);
|
|
|
|
/**
|
|
* @brief create a jstring with utf8 std::string, same function with env->newStringUTF
|
|
* because newStringUTF can not convert special emoticon
|
|
* @param env The JNI Env
|
|
* @param srcjStr The std::string which want to convert
|
|
* @param ret True if the conversion succeeds and the ret pointer isn't null
|
|
* @returns the result of jstring,the jstring need to DeleteLocalRef(jstring);
|
|
*/
|
|
CC_DLL jstring newStringUTFJNI(JNIEnv* env, const std::string& utf8Str, bool* ret = nullptr);
|
|
#endif
|
|
|
|
/**
|
|
* @brief Trims the unicode spaces at the end of char16_t vector.
|
|
*/
|
|
CC_DLL void trimUTF16Vector(std::vector<char16_t>& str);
|
|
|
|
/**
|
|
* @brief Trims the unicode spaces at the end of char32_t vector.
|
|
*/
|
|
CC_DLL void trimUTF32Vector(std::vector<char32_t>& str);
|
|
|
|
/**
|
|
* @brief Whether the character is a whitespace character.
|
|
* @param ch The unicode character.
|
|
* @returns Whether the character is a white space character.
|
|
*
|
|
* @see http://en.wikipedia.org/wiki/Whitespace_character#Unicode
|
|
*
|
|
*/
|
|
CC_DLL bool isUnicodeSpace(char32_t ch);
|
|
|
|
/**
|
|
* @brief Whether the character is a Chinese/Japanese/Korean character.
|
|
* @param ch The unicode character.
|
|
* @returns Whether the character is a Chinese character.
|
|
*
|
|
* @see http://www.searchtb.com/2012/04/chinese_encode.html
|
|
* @see http://tieba.baidu.com/p/748765987
|
|
*
|
|
*/
|
|
CC_DLL bool isCJKUnicode(char32_t ch);
|
|
|
|
/**
|
|
* @brief Returns the length of the string in characters.
|
|
* @param utf8 An UTF-8 encoded string.
|
|
* @returns The length of the string in characters.
|
|
*/
|
|
CC_DLL long getCharacterCountInUTF8String(const std::string& utf8);
|
|
|
|
/**
|
|
* @brief Gets the index of the last character that is not equal to the character given.
|
|
* @param str The string to be searched.
|
|
* @param c The character to be searched for.
|
|
* @returns The index of the last character that is not \p c.
|
|
*/
|
|
CC_DLL unsigned int getIndexOfLastNotChar16(const std::vector<char16_t>& str, char16_t c);
|
|
|
|
/**
|
|
* @brief Gets char16_t vector from a given utf16 string.
|
|
*/
|
|
CC_DLL std::vector<char16_t> getChar16VectorFromUTF16String(const std::u16string& utf16);
|
|
|
|
|
|
|
|
/**
|
|
* Utf8 sequence
|
|
* Store all utf8 chars as std::string
|
|
* Build from std::string
|
|
*/
|
|
class CC_DLL StringUTF8
|
|
{
|
|
public:
|
|
struct CharUTF8
|
|
{
|
|
std::string _char;
|
|
bool isASCII() const { return _char.size() == 1; }
|
|
};
|
|
typedef std::vector<CharUTF8> CharUTF8Store;
|
|
|
|
StringUTF8();
|
|
StringUTF8(const std::string& newStr);
|
|
~StringUTF8();
|
|
|
|
std::size_t length() const;
|
|
void replace(const std::string& newStr);
|
|
|
|
std::string getAsCharSequence() const;
|
|
std::string getAsCharSequence(std::size_t pos) const;
|
|
std::string getAsCharSequence(std::size_t pos, std::size_t len) const;
|
|
|
|
bool deleteChar(std::size_t pos);
|
|
bool insert(std::size_t pos, const std::string& insertStr);
|
|
bool insert(std::size_t pos, const StringUTF8& insertStr);
|
|
|
|
CharUTF8Store& getString() { return _str; }
|
|
const CharUTF8Store& getString() const { return _str; }
|
|
|
|
private:
|
|
CharUTF8Store _str;
|
|
};
|
|
|
|
} // namespace StringUtils {
|
|
|
|
/**
|
|
* Returns the character count in UTF16 string.
|
|
* @param str Pointer to the start of a UTF-16 encoded string. It must be an NULL terminal UTF8 string.
|
|
* @deprecated Please use c++11 `std::u16string::length` instead, don't use `unsigned short*` directly.
|
|
*/
|
|
CC_DEPRECATED_ATTRIBUTE CC_DLL int cc_wcslen(const unsigned short* str);
|
|
|
|
/** Trims the space characters at the end of UTF8 string.
|
|
* @deprecated Please use `StringUtils::trimUTF16Vector` instead.
|
|
*/
|
|
|
|
CC_DEPRECATED_ATTRIBUTE CC_DLL void cc_utf8_trim_ws(std::vector<unsigned short>* str);
|
|
|
|
/**
|
|
* Whether the character is a whitespace character.
|
|
*
|
|
* @param ch The unicode character.
|
|
* @returns Whether the character is a white space character.
|
|
* @deprecated Please use `StringUtils::isUnicodeSpace` instead.
|
|
*
|
|
* @see http://en.wikipedia.org/wiki/Whitespace_character#Unicode
|
|
*/
|
|
CC_DEPRECATED_ATTRIBUTE CC_DLL bool isspace_unicode(unsigned short ch);
|
|
|
|
/**
|
|
* Whether the character is a Chinese/Japanese/Korean character.
|
|
*
|
|
* @param ch The unicode character
|
|
* @returns Whether the character is a Chinese character.
|
|
* @deprecated Please use `StringUtils::isCJKUnicode` instead.
|
|
*
|
|
* @see http://www.searchtb.com/2012/04/chinese_encode.html
|
|
* @see http://tieba.baidu.com/p/748765987
|
|
*/
|
|
CC_DEPRECATED_ATTRIBUTE CC_DLL bool iscjk_unicode(unsigned short ch);
|
|
|
|
/**
|
|
* Returns the length of the string in characters.
|
|
*
|
|
* @param p Pointer to the start of a UTF-8 encoded string. It must be an NULL terminal UTF8 string.
|
|
* @param max Not used from 3.1, just keep it for backward compatibility.
|
|
* @deprecated Please use `StringUtils::getCharacterCountInUTF8String` instead.
|
|
* @returns The length of the string in characters.
|
|
**/
|
|
CC_DEPRECATED_ATTRIBUTE CC_DLL long cc_utf8_strlen (const char * p, int max = -1);
|
|
|
|
/**
|
|
* Find the last character that is not equal to the character given.
|
|
*
|
|
* @param str The string to be searched.
|
|
* @param c The character to be searched for.
|
|
* @deprecated Please use `StringUtils::getIndexOfLastNotChar16` instead.
|
|
* @returns The index of the last character that is not \p c.
|
|
*/
|
|
CC_DEPRECATED_ATTRIBUTE CC_DLL unsigned int cc_utf8_find_last_not_char(const std::vector<unsigned short>& str, unsigned short c);
|
|
|
|
/**
|
|
* @brief Gets `unsigned short` vector from a given utf16 string.
|
|
* @param str A given utf16 string.
|
|
* @deprecated Please use `StringUtils::getChar16VectorFromUTF16String` instead.
|
|
*/
|
|
CC_DEPRECATED_ATTRIBUTE CC_DLL std::vector<unsigned short> cc_utf16_vec_from_utf16_str(const unsigned short* str);
|
|
|
|
/**
|
|
* Creates an utf8 string from a c string. The result will be null terminated.
|
|
*
|
|
* @param str_old Pointer to the start of a C string. It must be an NULL terminal UTF8 string.
|
|
* @param length Not used from 3.1, keep it just for backward compatibility.
|
|
* @param rUtf16Size The character count in the return UTF16 string.
|
|
* @deprecated Please use `StringUtils::UTF8ToUTF16` instead.
|
|
* @returns The newly created utf16 string, it must be released with `delete[]`,
|
|
* If an error occurs, %NULL will be returned.
|
|
*/
|
|
CC_DEPRECATED_ATTRIBUTE CC_DLL unsigned short* cc_utf8_to_utf16(const char* str_old, int length = -1, int* rUtf16Size = nullptr);
|
|
|
|
/**
|
|
* Converts a string from UTF-16 to UTF-8. The result will be null terminated.
|
|
*
|
|
* @param utf16 An UTF-16 encoded string, It must be an NULL terminal UTF16 string.
|
|
* @param len Not used from 3.1, keep it just for backward compatibility.
|
|
* @param items_read Not used from 3.1, keep it just for backward compatibility.
|
|
* @param items_written Not used from 3.1, keep it just for backward compatibility.
|
|
* @deprecated Please use `StringUtils::UTF16ToUTF8` instead.
|
|
* @returns A pointer to a newly allocated UTF-8 string. This value must be
|
|
* released with `delete[]`. If an error occurs, %NULL will be returned.
|
|
*/
|
|
CC_DEPRECATED_ATTRIBUTE CC_DLL char * cc_utf16_to_utf8 (const unsigned short *str,
|
|
int len = -1,
|
|
long *items_read = nullptr,
|
|
long *items_written = nullptr);
|
|
|
|
|
|
NS_CC_END
|
|
|
|
#endif /** defined(__cocos2dx__ccUTF8__) */
|