JS_SetPropertyAttributes

この記事はまだ日本語に翻訳されていません。MDN の翻訳はボランティアによって行われています。是非 MDN に登録し、私たちの力になって下さい。

Set the attributes for a specified property.

Syntax

JSBool JS_SetPropertyAttributes(JSContext *cx, JSObject *obj,
    const char *name, uintN attrs, JSBool *foundp);

JSBool JS_SetUCPropertyAttributes(JSContext *cx, JSObject *obj,
    const jschar *name, size_t namelen, uintN attrs,
    JSBool *foundp);
Name Type Description
cx JSContext * The context in which to set the property attributes. Requires request. In a JS_THREADSAFE build, the caller must be in a request on this JSContext.
obj JSObject * Object for which to set property attributes.
name const char * or const jschar * Name of the property for which to set attributes.
namelen size_t (in JS_SetUCPropertyAttributes only) The length of name, in characters.
attrs uintN Attribute values to set.
foundp JSBool * Out parameter. Flag indicating whether or not the specified property was located.

Description

JS_SetPropertyAttributes sets the attributes for a specified property, name of an object obj. JS_SetUCPropertyAttributes is the Unicode version of the function.

attrs is an unsigned integer containing the attribute value to set. It is the bitwise OR of zero or more of the following values:

Flag Purpose
JSPROP_ENUMERATE Property is visible in for and in loops.
JSPROP_READONLY Property is read only.
JSPROP_PERMANENT Property cannot be deleted.
JSPROP_EXPORTED Property can be imported by other objects.
JSPROP_INDEX Property is actually an index into an array of properties, and is cast to a const char *.

If JS_SetPropertyAttributes cannot locate an object with the specified property, it returns JS_FALSE, and the value left in *foundp is undefined.

If the specified property or the specified object does not exist, foundp is set to JS_FALSE. Then, if the property exists, but is associated with a different object, JS_SetPropertyAttributes returns JS_TRUE. Otherwise, it sets foundp to JS_TRUE, and attempts to set the attributes as specified. If the attributes can be set, JS_SetPropertyAttributes returns JS_TRUE. If not, it returns JS_FALSE.

To get the attributes of a property, use JS_GetPropertyAttributes.

MXR ID Search for JS_SetPropertyAttributes
MXR ID Search for JS_SetUCPropertyAttributes

Document Tags and Contributors

Contributors to this page: MMondor, Dria, Jorend
最終更新者: Jorend,