| /* |
| * Copyright (C) 2007 Apple Inc. All rights reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions |
| * are met: |
| * 1. Redistributions of source code must retain the above copyright |
| * notice, this list of conditions and the following disclaimer. |
| * 2. Redistributions in binary form must reproduce the above copyright |
| * notice, this list of conditions and the following disclaimer in the |
| * documentation and/or other materials provided with the distribution. |
| * |
| * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY |
| * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
| * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
| * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR |
| * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, |
| * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, |
| * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR |
| * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY |
| * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| */ |
| |
| #ifndef WTF_UTF8_h |
| #define WTF_UTF8_h |
| |
| #include "wtf/WTFExport.h" |
| #include "wtf/text/Unicode.h" |
| |
| namespace WTF { |
| namespace Unicode { |
| |
| typedef enum { |
| conversionOK, // conversion successful |
| sourceExhausted, // partial character in source, but hit end |
| targetExhausted, // insuff. room in target for conversion |
| sourceIllegal // source sequence is illegal/malformed |
| } ConversionResult; |
| |
| // These conversion functions take a "strict" argument. When this flag is set to |
| // strict, both irregular sequences and isolated surrogates will cause an error. |
| // When the flag is set to lenient, both irregular sequences and isolated |
| // surrogates are converted. |
| // |
| // Whether the flag is strict or lenient, all illegal sequences will cause an |
| // error return. This includes sequences such as: <F4 90 80 80>, <C0 80>, or |
| // <A0> in UTF-8, and values above 0x10FFFF in UTF-32. Conformant code must |
| // check for illegal sequences. |
| // |
| // When the flag is set to lenient, characters over 0x10FFFF are converted to |
| // the replacement character; otherwise (when the flag is set to strict) they |
| // constitute an error. |
| |
| WTF_EXPORT ConversionResult convertUTF8ToUTF16(const char** sourceStart, |
| const char* sourceEnd, |
| UChar** targetStart, |
| UChar* targetEnd, |
| bool* isSourceAllASCII = 0, |
| bool strict = true); |
| |
| WTF_EXPORT ConversionResult convertLatin1ToUTF8(const LChar** sourceStart, |
| const LChar* sourceEnd, |
| char** targetStart, |
| char* targetEnd); |
| |
| WTF_EXPORT ConversionResult convertUTF16ToUTF8(const UChar** sourceStart, |
| const UChar* sourceEnd, |
| char** targetStart, |
| char* targetEnd, |
| bool strict = true); |
| |
| WTF_EXPORT unsigned calculateStringHashAndLengthFromUTF8MaskingTop8Bits( |
| const char* data, |
| const char* dataEnd, |
| unsigned& dataLength, |
| unsigned& utf16Length); |
| |
| WTF_EXPORT bool equalUTF16WithUTF8(const UChar* a, |
| const UChar* aEnd, |
| const char* b, |
| const char* bEnd); |
| WTF_EXPORT bool equalLatin1WithUTF8(const LChar* a, |
| const LChar* aEnd, |
| const char* b, |
| const char* bEnd); |
| |
| } // namespace Unicode |
| } // namespace WTF |
| |
| #endif // WTF_UTF8_h |
