Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка JSStringRef.h

Опции
Развертывание Target:

На этой странице
Язык:

Ссылка JSStringRef.h

Включенные заголовки

  • <JavaScriptCore/JSValueRef.h>

  • <stdbool.h>

  • <stddef.h>

Функции

  • Создает строку JavaScript из буфера символов Unicode.

    Объявление

    Swift

    func JSStringCreateWithCharacters(_ chars: UnsafePointer<JSChar>, _ numChars: UInt) -> Unmanaged<JSString>!

    Objective C

    JSStringRef JSStringCreateWithCharacters ( const JSChar *chars, size_t numChars );

    Параметры

    chars

    Буфер символов Unicode для копирования в новый JSString.

    numChars

    Число символов для копирования с буфера, на который указывают символы.

    Возвращаемое значение

    JSString, содержащий символы. Владение соблюдает Создать Правило.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Создает строку JavaScript из завершенной нулем строки UTF8.

    Объявление

    Swift

    func JSStringCreateWithUTF8CString(_ string: UnsafePointer<Int8>) -> Unmanaged<JSString>!

    Objective C

    JSStringRef JSStringCreateWithUTF8CString ( const char *string );

    Параметры

    string

    Завершенные нулем UTF8 представляют в виде строки для копирования в новый JSString.

    Возвращаемое значение

    JSString, содержащий строку. Владение соблюдает Создать Правило.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает указатель на буфер символа Unicode, служащий запоминающим устройством для строки JavaScript.

    Объявление

    Swift

    func JSStringGetCharactersPtr(_ string: JSString!) -> UnsafePointer<JSChar>

    Objective C

    const JSChar * JSStringGetCharactersPtr ( JSStringRef string );

    Параметры

    string

    JSString, к запоминающему устройству которого Вы хотите получить доступ.

    Возвращаемое значение

    Указатель на буфер символа Unicode, служащий запоминающим устройством строки, которое будет освобождено, когда будет освобождена строка.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает число символов Unicode в строке JavaScript.

    Объявление

    Swift

    func JSStringGetLength(_ string: JSString!) -> UInt

    Objective C

    size_t JSStringGetLength ( JSStringRef string );

    Параметры

    string

    JSString, длину которого (в символах Unicode) Вы хотите знать.

    Возвращаемое значение

    Число символов Unicode сохранено в строке.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает максимальное количество байтов, которые строка JavaScript приведет в рабочее состояние, если преобразовано в завершенную нулем строку UTF8.

    Объявление

    Swift

    func JSStringGetMaximumUTF8CStringSize(_ string: JSString!) -> UInt

    Objective C

    size_t JSStringGetMaximumUTF8CStringSize ( JSStringRef string );

    Параметры

    string

    JSString, максимальный преобразованный размер которого (в байтах) Вы хотите знать.

    Возвращаемое значение

    Максимальное количество байтов, которые могли потребоваться, чтобы преобразовывать строку в завершенную нулем строку UTF8. Число байтов, которых преобразование фактически заканчивает тем, что требовало, могло быть меньше, чем это, но никогда.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Преобразовывает строку JavaScript в завершенную нулем строку UTF8 и копирует результат во внешний буфер байта.

    Объявление

    Swift

    func JSStringGetUTF8CString(_ string: JSString!, _ buffer: UnsafeMutablePointer<Int8>, _ bufferSize: UInt) -> UInt

    Objective C

    size_t JSStringGetUTF8CString ( JSStringRef string, char *buffer, size_t bufferSize );

    Параметры

    string

    Источник JSString.

    buffer

    Целевой байт буферизует, в который можно скопировать завершенное нулем представление UTF8 строки. По возврату буфер содержит строковое представление UTF8 строки. Если bufferSize будет слишком маленьким, то буфер будет содержать только частичные результаты. Если буфер не является, по крайней мере, bufferSize байтами в размере, поведение не определено.

    bufferSize

    Размер внешнего буфера в байтах.

    Возвращаемое значение

    Число байтов, записанных в буфер (включая байт нулевого разделителя).

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Тесты, соответствуют ли две строки JavaScript.

    Объявление

    Swift

    func JSStringIsEqual(_ a: JSString!, _ b: JSString!) -> Bool

    Objective C

    bool JSStringIsEqual ( JSStringRef a, JSStringRef b );

    Параметры

    a

    Первый JSString, который протестирует.

    b

    Второй JSString для тестирования.

    Возвращаемое значение

    истина, если две строки соответствуют, иначе ложь.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Тесты, соответствует ли строка JavaScript завершенную нулем строку UTF8.

    Объявление

    Swift

    func JSStringIsEqualToUTF8CString(_ a: JSString!, _ b: UnsafePointer<Int8>) -> Bool

    Objective C

    bool JSStringIsEqualToUTF8CString ( JSStringRef a, const char *b );

    Параметры

    a

    JSString для тестирования.

    b

    Завершенные нулем UTF8 представляют в виде строки для тестирования.

    Возвращаемое значение

    истина, если две строки соответствуют, иначе ложь.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Выпускает строку JavaScript.

    Объявление

    Objective C

    void JSStringRelease ( JSStringRef string );

    Параметры

    string

    JSString для выпуска.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Сохраняет строку JavaScript.

    Объявление

    Objective C

    JSStringRef JSStringRetain ( JSStringRef string );

    Параметры

    string

    JSString для сохранения.

    Возвращаемое значение

    JSString, совпадающий со строкой.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Доступность

    Доступный в OS X v10.5 и позже.

Типы данных

Посмотрите раздел Overview выше для документации уровня заголовка.

  • Символ Unicode.

    Объявление

    Swift

    typealias JSChar = UInt16

    Objective C

    typedef unsigned short JSChar;

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.