API/JSStringRef.cpp

   1 /*
   2  * Copyright (C) 2006, 2007 Apple Inc. All rights reserved.
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions
   6  * are met:
   7  * 1. Redistributions of source code must retain the above copyright
   8  *    notice, this list of conditions and the following disclaimer.
   9  * 2. Redistributions in binary form must reproduce the above copyright
  10  *    notice, this list of conditions and the following disclaimer in the
  11  *    documentation and/or other materials provided with the distribution.
  12  *
  13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
  14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
  17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  24  */
  25
  26 #include "config.h"
  27 #include "JSStringRef.h"
  28 #include "JSStringRefPrivate.h"
  29
  30 #include "InitializeThreading.h"
  31 #include "OpaqueJSString.h"
  32 #include <wtf/unicode/UTF8.h>
  33
  34 using namespace JSC;
  35 using namespace WTF::Unicode;
  36
  37 JSStringRef JSStringCreateWithCharacters(const JSChar* chars, size_t numChars)
  38 {
  39     initializeThreading();
  40     return &OpaqueJSString::create(chars, numChars).leakRef();
  41 }
  42
  43 JSStringRef JSStringCreateWithUTF8CString(const char* string)
  44 {
  45     initializeThreading();
  46     if (string) {
  47         size_t length = strlen(string);
  48         Vector<UChar, 1024> buffer(length);
  49         UChar* p = buffer.data();
  50         bool sourceIsAllASCII;
  51         const LChar* stringStart = reinterpret_cast<const LChar*>(string);
  52         if (conversionOK == convertUTF8ToUTF16(&string, string + length, &p, p + length, &sourceIsAllASCII)) {
  53             if (sourceIsAllASCII)
  54                 return &OpaqueJSString::create(stringStart, length).leakRef();
  55             return &OpaqueJSString::create(buffer.data(), p - buffer.data()).leakRef();
  56         }
  57     }
  58
  59     return &OpaqueJSString::create().leakRef();
  60 }
  61
  62 JSStringRef JSStringCreateWithCharactersNoCopy(const JSChar* chars, size_t numChars)
  63 {
  64     initializeThreading();
  65     return OpaqueJSString::create(StringImpl::createWithoutCopying(chars, numChars)).leakRef();
  66 }
  67
  68 JSStringRef JSStringRetain(JSStringRef string)
  69 {
  70     string->ref();
  71     return string;
  72 }
  73
  74 void JSStringRelease(JSStringRef string)
  75 {
  76     string->deref();
  77 }
  78
  79 size_t JSStringGetLength(JSStringRef string)
  80 {
  81     if (!string)
  82         return 0;
  83     return string->length();
  84 }
  85
  86 const JSChar* JSStringGetCharactersPtr(JSStringRef string)
  87 {
  88     if (!string)
  89         return nullptr;
  90     return string->characters();
  91 }
  92
  93 size_t JSStringGetMaximumUTF8CStringSize(JSStringRef string)
  94 {
  95     // Any UTF8 character > 3 bytes encodes as a UTF16 surrogate pair.
  96     return string->length() * 3 + 1; // + 1 for terminating '\0'
  97 }
  98
  99 size_t JSStringGetUTF8CString(JSStringRef string, char* buffer, size_t bufferSize)
 100 {
 101     if (!string || !buffer || !bufferSize)
 102         return 0;
 103
 104     char* destination = buffer;
 105     ConversionResult result;
 106     if (string->is8Bit()) {
 107         const LChar* source = string->characters8();
 108         result = convertLatin1ToUTF8(&source, source + string->length(), &destination, destination + bufferSize - 1);
 109     } else {
 110         const UChar* source = string->characters16();
 111         result = convertUTF16ToUTF8(&source, source + string->length(), &destination, destination + bufferSize - 1, true);
 112     }
 113
 114     *destination++ = '\0';
 115     if (result != conversionOK && result != targetExhausted)
 116         return 0;
 117
 118     return destination - buffer;
 119 }
 120
 121 bool JSStringIsEqual(JSStringRef a, JSStringRef b)
 122 {
 123     return OpaqueJSString::equal(a, b);
 124 }
 125
 126 bool JSStringIsEqualToUTF8CString(JSStringRef a, const char* b)
 127 {
 128     JSStringRef bBuf = JSStringCreateWithUTF8CString(b);
 129     bool result = JSStringIsEqual(a, bBuf);
 130     JSStringRelease(bBuf);
 131
 132     return result;
 133 }