QJSManagedValue Class

メンバ関数のドキュメント

[constexpr noexcept default] QJSManagedValue::QJSManagedValue()

JavaScriptのundefined 値を表すQJSManagedValueを作成します。これは、JavaScriptのヒープ上に格納されない唯一の値です。デフォルト構築されたQJSManagedValueに対してengine()を呼び出すと、nullptrが返されます。

QJSManagedValue::QJSManagedValue(QJSValue value, QJSEngine *engine)

value から、engine のヒープを使用して QJSManagedValue を作成します。value 自体が管理対象であり、かつそれが属するエンジンがengine でない場合、結果はundefined 値となり、警告が発生します。

QJSManagedValue::QJSManagedValue(const QJSPrimitiveValue &value, QJSEngine *engine)

engine のヒープを使用して、value からQJSManagedValueを作成します。

QJSManagedValue::QJSManagedValue(const QString &string, QJSEngine *engine)

engine のヒープを使用して、string からQJSManagedValueを作成します。

QJSManagedValue::QJSManagedValue(const QVariant &variant, QJSEngine *engine)

engine のヒープを使用して、variant からQJSManagedValueを作成します。

QJSManagedValue::QJSManagedValue(QJSManagedValue &&other)

other から QJSManagedValue をムーブコンストラクトで生成します。これにより、other はデフォルトコンストラクトされた状態のままとなり、この状態では undefined を表し、どのエンジンにも属しません。

[noexcept] QJSManagedValue::~QJSManagedValue()

QJSManagedValue を破棄します。

QJSValue QJSManagedValue::call(const QJSValueList &arguments = {}) const

このQJSManagedValue がJavaScriptのFunctionObjectを表している場合、指定されたarguments を引数として呼び出し、その結果を返します。そうでない場合は、JavaScriptのundefined 値を返します。

arguments は、プリミティブ値であるか、またはこのQJSManagedValue と同じQJSEngine に属している必要があります。そうでない場合、呼び出しは実行されず、JavaScriptのundefined 値が返されます。

QJSValue QJSManagedValue::callAsConstructor(const QJSValueList &arguments = {}) const

この `QJSManagedValue ` が JavaScript の `FunctionObject` を表す場合、指定された `arguments` を引数としてコンストラクタを呼び出し、その結果を返します。それ以外の場合は、JavaScript の `undefined ` 値を返します。

arguments は、プリミティブ値であるか、このQJSManagedValue と同じQJSEngine に属している必要があります。そうでない場合、呼び出しは実行されず、JavaScript のundefined 値が返されます。

QJSValue QJSManagedValue::callWithInstance(const QJSValue &instance, const QJSValueList &arguments = {}) const

この `QJSManagedValue ` が JavaScript の `FunctionObject` を表している場合、指定された `arguments` を用いて `instance ` でそれを呼び出し、その結果を返します。そうでない場合は、JavaScript の `undefined ` 値を返します。

arguments とinstance は、プリミティブ値であるか、このQJSManagedValue と同じQJSEngine に属している必要があります。そうでない場合、呼び出しは実行されず、JavaScript のundefined 値が返されます。

bool QJSManagedValue::deleteProperty(const QString &name)

この `QJSManagedValue` から `name ` プロパティを削除します。削除に成功した場合は `true ` を返し、失敗した場合は `false ` を返します。

bool QJSManagedValue::deleteProperty(quint32 arrayIndex)

このQJSManagedValue から、arrayIndex に格納されている値を削除します。削除に成功した場合はtrue を返し、失敗した場合はfalse を返します。

QJSEngine *QJSManagedValue::engine() const

この `QJSManagedValue ` が属する `QJSEngine ` を返します。QJSManagedValue がデフォルトコンストラクタで生成された場合、または移動された場合を除き、エンジンは常に有効であることに注意してください。後者の場合、`nullptr` が返されます。

bool QJSManagedValue::equals(const QJSManagedValue &other) const

このQJSManagedValue およびother に対してJavaScriptの「==」演算子を適用し、その結果を返します。

strictlyEqualsも参照してください 。

bool QJSManagedValue::hasOwnProperty(const QString &name) const

この `QJSManagedValue ` に `name` プロパティが存在する場合、true を返します。そうでない場合は、false を返します。プロトタイプチェーンのプロパティは考慮されません。

bool QJSManagedValue::hasOwnProperty(quint32 arrayIndex) const

この `QJSManagedValue ` に配列インデックス `arrayIndex` が存在する場合は `true ` を返し、そうでない場合は `false` を返します。プロトタイプチェーンのプロパティは考慮されません。

bool QJSManagedValue::hasProperty(const QString &name) const

この `QJSManagedValue ` に `name` プロパティがある場合は `true ` を返し、そうでない場合は `false` を返します。プロトタイプチェーンのプロパティも考慮されます。

bool QJSManagedValue::hasProperty(quint32 arrayIndex) const

この `QJSManagedValue ` に配列インデックス `arrayIndex` が存在する場合、true を返します。そうでない場合は、false を返します。プロトタイプチェーンのプロパティも考慮されます。

bool QJSManagedValue::isArray() const

この値が JavaScript の Array オブジェクトを表す場合は `true ` を返し、それ以外の場合は `false ` を返します。

bool QJSManagedValue::isBoolean() const

このQJSManagedValue の型がboolean である場合はtrue を返し、それ以外の場合はfalse を返します。

bool QJSManagedValue::isDate() const

この値が JavaScript の Date オブジェクトを表す場合は `true ` を返し、それ以外の場合は `false ` を返します。

bool QJSManagedValue::isError() const

この値が JavaScript の Error オブジェクトを表す場合は `true ` を返し、それ以外の場合は `false ` を返します。

bool QJSManagedValue::isFunction() const

このQJSManagedValue の型がfunction の場合、true を返し、それ以外の場合はfalse を返します。

bool QJSManagedValue::isInteger() const

このQJSManagedValue が整数値を保持している場合はtrue を返し、そうでない場合はfalse を返します。数値の格納形式は、その数値に対して行われる演算の結果には影響しませんが、整数が格納されている場合、多くの演算が高速になります。

bool QJSManagedValue::isNull() const

この `QJSManagedValue ` が JavaScript の `null ` 値を保持している場合は `true ` を返し、そうでない場合は `false ` を返します。

bool QJSManagedValue::isNumber() const

このQJSManagedValue の型がnumber である場合はtrue を返し、それ以外の場合はfalse を返します。

bool QJSManagedValue::isObject() const

このQJSManagedValue の型がobject である場合はtrue を返し、それ以外の場合はfalse を返します。

bool QJSManagedValue::isQMetaObject() const

この値が、JavaScript ヒープ上で管理されている `QMetaObject ` ポインタを表す場合は `true ` を返し、それ以外の場合は `false ` を返します。

bool QJSManagedValue::isQObject() const

この値がJavaScriptヒープ上で管理されているQObject ポインタを表す場合はtrue を返し、それ以外の場合はfalse を返します。

bool QJSManagedValue::isRegularExpression() const

この値が JavaScript の正規表現オブジェクトを表す場合は `true ` を返し、それ以外の場合は `false ` を返します。

bool QJSManagedValue::isString() const

このQJSManagedValue の型がstring である場合はtrue を返し、それ以外の場合はfalse を返します。

bool QJSManagedValue::isSymbol() const

このQJSManagedValue の型がsymbol である場合はtrue を返し、それ以外の場合はfalse を返します。

bool QJSManagedValue::isUndefined() const

このQJSManagedValue の型がundefined である場合はtrue を返し、それ以外の場合はfalse を返します。

bool QJSManagedValue::isUrl() const

この値が JavaScript の Url オブジェクトを表す場合は `true ` を返し、それ以外の場合は `false ` を返します。

bool QJSManagedValue::isVariant() const

この値がJavaScriptヒープ上で管理されているQVariant を表す場合はtrue を返し、それ以外の場合はfalse を返します。

QJSValue QJSManagedValue::property(const QString &name) const

この `QJSManagedValue` のプロパティ `name ` を返します。実際のオブジェクトにこのプロパティが見つからない場合は、プロトタイプチェーンが検索されます。

setProperty()も参照してください 。

QJSValue QJSManagedValue::property(quint32 arrayIndex) const

この `QJSManagedValue` の `arrayIndex ` に格納されているプロパティを返します。実際のオブジェクト上でそのプロパティが見つからない場合は、プロトタイプチェーンが検索されます。

QJSManagedValue QJSManagedValue::prototype() const

この `QJSManagedValue` のプロトタイプを返します。これはどのような値に対しても機能します。たとえば、boolean の値から JavaScript の `boolean ` プロトタイプを取得することができます。

setPrototype()も参照してください 。

void QJSManagedValue::setProperty(const QString &name, const QJSValue &value)

この `QJSManagedValue` に対して、プロパティ `name ` の値を `value ` に設定します。これは、型が `object` の JavaScript 値に対してのみ実行可能です。さらに、`value ` はプリミティブ型であるか、この値と同じエンジンに属している必要があります。

property()も参照してください 。

void QJSManagedValue::setProperty(quint32 arrayIndex, const QJSValue &value)

value を、arrayIndex にあるQJSManagedValue に格納します。これは、object 型のJavaScript値に対してのみ実行可能であり、値が配列でない場合は推奨されません。さらに、value はプリミティブ型であるか、この値と同じエンジンに属している必要があります。

void QJSManagedValue::setPrototype(const QJSManagedValue &prototype)

この `QJSManagedValue ` のプロトタイプを `prototype` に設定します。前提条件として、`prototype ` は、この `QJSManagedValue ` と同じ `QJSEngine ` に属し、かつオブジェクト（nullを含む）である必要があります。さらに、この `QJSManagedValue ` もオブジェクト（nullを除く）である必要があり、プロトタイプループを生成することはできません。

prototype()も参照してください 。

bool QJSManagedValue::strictlyEquals(const QJSManagedValue &other) const

このQJSManagedValue およびother に対してJavaScriptの「===」演算子を適用し、その結果を返します。

equalsも参照してください 。

bool QJSManagedValue::toBoolean() const

マネージド値をブール値に変換します。マネージド値がブール値である場合は、その値が返されます。そうでない場合は、JavaScriptの規則に基づいてブール値への型変換が行われます。

QDateTime QJSManagedValue::toDateTime() const

この `QJSManagedValue ` が JavaScript の `Date` オブジェクトを保持している場合、同等の `QDateTime` を返します。そうでない場合は、無効な ` ` を返します。

int QJSManagedValue::toInteger() const

管理された値を整数に変換します。まず、toNumber() のルールに従って値を数値に変換し、次に、JavaScript のビットシフト演算子の引数を 32 ビット整数に型変換する際のルールに従って、その値を整数の範囲内にクリップします。

内部的には、値がすでに整数として格納されている場合があり、その場合は高速処理パスが実行されます。

QJSValue QJSManagedValue::toJSValue() const

QJSManagedValue を新しいQJSValue にコピーします。これは、QJSManagedValue からQJSValue をmoveコンストラクタで生成するよりも効率は劣りますが、QJSManagedValue は維持されます。

double QJSManagedValue::toNumber() const

管理対象の値を数値に変換します。管理対象の値が数値である場合は、その値が返されます。そうでない場合は、JavaScript の規則に従って数値への型変換が行われます。

QJSPrimitiveValue QJSManagedValue::toPrimitive() const

マネージド値をQJSPrimitiveValue に変換します。マネージド値がQJSPrimitiveValue でサポートされている型である場合、その値がコピーされます。それ以外の場合は、値が文字列に変換され、その文字列がQJSPrimitiveValue に格納されます。

const QMetaObject *QJSManagedValue::toQMetaObject() const

QJSManagedValue がQMetaObject へのポインタを保持している場合、それを返します。そうでない場合は nullptr を返します。

QObject *QJSManagedValue::toQObject() const

QJSManagedValue がQObject へのポインタを保持している場合は、それを返します。そうでない場合は nullptr を返します。

QRegularExpression QJSManagedValue::toRegularExpression() const

この `QJSManagedValue ` が JavaScript の正規表現オブジェクトを保持している場合、同等の `QRegularExpression` を返します。そうでない場合は、無効な ` ` を返します。

QString QJSManagedValue::toString() const

管理対象の値を文字列に変換します。管理対象の値が文字列である場合は、その文字列が返されます。そうでない場合は、JavaScriptのルールに基づいて文字列への型変換が行われます。

QUrl QJSManagedValue::toUrl() const

この `QJSManagedValue ` が JavaScript の `URL` オブジェクトを保持している場合、同等の `QUrl` を返します。そうでない場合は、無効な ` ` を返します。

QVariant QJSManagedValue::toVariant() const

QJSManagedValue を新しいQVariant にコピーします。また、QJSManagedValue::isVariant() が false を返した場合、便利なQVariant も作成されます。QVariant は、QJSManagedValue でサポートされているすべての型を格納できます。

QJSManagedValue::Type QJSManagedValue::type() const

この `QJSManagedValue` の JavaScript 型を返します。

QJSManagedValue &QJSManagedValue::operator=(QJSManagedValue &&other)

other からQJSManagedValue を移動代入します。これにより、other はデフォルト構築された状態のままとなり、これは undefined を表し、どのエンジンにも属しません。