/* * Copyright (C) 2005 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef ANDROID_STRING16_H #define ANDROID_STRING16_H #include #include #include #include // --------------------------------------------------------------------------- extern "C" { typedef uint16_t char16_t; // Standard string functions on char16 strings. int strcmp16(const char16_t *, const char16_t *); int strncmp16(const char16_t *s1, const char16_t *s2, size_t n); size_t strlen16(const char16_t *); size_t strnlen16(const char16_t *, size_t); char16_t *strcpy16(char16_t *, const char16_t *); char16_t *strncpy16(char16_t *, const char16_t *, size_t); // Version of comparison that supports embedded nulls. // This is different than strncmp() because we don't stop // at a nul character and consider the strings to be different // if the lengths are different (thus we need to supply the // lengths of both strings). This can also be used when // your string is not nul-terminated as it will have the // equivalent result as strcmp16 (unlike strncmp16). int strzcmp16(const char16_t *s1, size_t n1, const char16_t *s2, size_t n2); // Version of strzcmp16 for comparing strings in different endianness. int strzcmp16_h_n(const char16_t *s1H, size_t n1, const char16_t *s2N, size_t n2); // Convert UTF-8 to UTF-16 including surrogate pairs void utf8_to_utf16(const uint8_t *src, size_t srcLen, char16_t* dst, const size_t dstLen); } // --------------------------------------------------------------------------- namespace android { // --------------------------------------------------------------------------- class String8; class TextOutput; //! This is a string holding UTF-16 characters. class String16 { public: String16(); String16(const String16& o); String16(const String16& o, size_t len, size_t begin=0); explicit String16(const char16_t* o); explicit String16(const char16_t* o, size_t len); explicit String16(const String8& o); explicit String16(const char* o); explicit String16(const char* o, size_t len); ~String16(); inline const char16_t* string() const; inline size_t size() const; inline const SharedBuffer* sharedBuffer() const; void setTo(const String16& other); status_t setTo(const char16_t* other); status_t setTo(const char16_t* other, size_t len); status_t setTo(const String16& other, size_t len, size_t begin=0); status_t append(const String16& other); status_t append(const char16_t* other, size_t len); inline String16& operator=(const String16& other); inline String16& operator+=(const String16& other); inline String16 operator+(const String16& other) const; status_t insert(size_t pos, const char16_t* chrs); status_t insert(size_t pos, const char16_t* chrs, size_t len); ssize_t findFirst(char16_t c) const; ssize_t findLast(char16_t c) const; bool startsWith(const String16& prefix) const; bool startsWith(const char16_t* prefix) const; status_t makeLower(); status_t replaceAll(char16_t replaceThis, char16_t withThis); status_t remove(size_t len, size_t begin=0); inline int compare(const String16& other) const; inline bool operator<(const String16& other) const; inline bool operator<=(const String16& other) const; inline bool operator==(const String16& other) const; inline bool operator!=(const String16& other) const; inline bool operator>=(const String16& other) const; inline bool operator>(const String16& other) const; inline bool operator<(const char16_t* other) const; inline bool operator<=(const char16_t* other) const; inline bool operator==(const char16_t* other) const; inline bool operator!=(const char16_t* other) const; inline bool operator>=(const char16_t* other) const; inline bool operator>(const char16_t* other) const; inline operator const char16_t*() const; private: const char16_t* mString; }; TextOutput& operator<<(TextOutput& to, const String16& val); // --------------------------------------------------------------------------- // No user servicable parts below. inline int compare_type(const String16& lhs, const String16& rhs) { return lhs.compare(rhs); } inline int strictly_order_type(const String16& lhs, const String16& rhs) { return compare_type(lhs, rhs) < 0; } inline const char16_t* String16::string() const { return mString; } inline size_t String16::size() const { return SharedBuffer::sizeFromData(mString)/sizeof(char16_t)-1; } inline const SharedBuffer* String16::sharedBuffer() const { return SharedBuffer::bufferFromData(mString); } inline String16& String16::operator=(const String16& other) { setTo(other); return *this; } inline String16& String16::operator+=(const String16& other) { append(other); return *this; } inline String16 String16::operator+(const String16& other) const { String16 tmp; tmp += other; return tmp; } inline int String16::compare(const String16& other) const { return strzcmp16(mString, size(), other.mString, other.size()); } inline bool String16::operator<(const String16& other) const { return strzcmp16(mString, size(), other.mString, other.size()) < 0; } inline bool String16::operator<=(const String16& other) const { return strzcmp16(mString, size(), other.mString, other.size()) <= 0; } inline bool String16::operator==(const String16& other) const { const size_t n1 = size(); const size_t n2 = other.size(); return n1 == n2 && strzcmp16(mString, n1, other.mString, n2) == 0; } inline bool String16::operator!=(const String16& other) const { return strzcmp16(mString, size(), other.mString, other.size()) != 0; } inline bool String16::operator>=(const String16& other) const { return strzcmp16(mString, size(), other.mString, other.size()) >= 0; } inline bool String16::operator>(const String16& other) const { return strzcmp16(mString, size(), other.mString, other.size()) > 0; } inline bool String16::operator<(const char16_t* other) const { return strcmp16(mString, other) < 0; } inline bool String16::operator<=(const char16_t* other) const { return strcmp16(mString, other) <= 0; } inline bool String16::operator==(const char16_t* other) const { return strcmp16(mString, other) == 0; } inline bool String16::operator!=(const char16_t* other) const { return strcmp16(mString, other) != 0; } inline bool String16::operator>=(const char16_t* other) const { return strcmp16(mString, other) >= 0; } inline bool String16::operator>(const char16_t* other) const { return strcmp16(mString, other) > 0; } inline String16::operator const char16_t*() const { return mString; } }; // namespace android // --------------------------------------------------------------------------- #endif // ANDROID_STRING16_H