JavaScript-1.5 Reference

JS_DefineUCProperty

Function

Summary

Creates a single Unicode-encoded property for a specified object.

Syntax

JSBool) JS_DefineUCProperty(JSContext *cx, JSObject *obj,
    const jschar *name, size_t namelen, jsval value,
    JSPropertyOp getter, JSPropertyOp setter, uintN attrs);

Name	Type	Description
`cx`	`JSContext *`	Pointer to a JS context from which to derive runtime information.
`obj`	`JSObject *`	Object for which to create the new property.
`name`	`const jschar *`	Name for the property to create.
`namelen`	`size_t`	Length of `name`, in bytes.
`value`	`jsval`	Initial value to assign to the property.
`getter`	`JSPropertyOp`	`getProperty` method for retrieving the current property value.
`setter`	`JSPropertyOp`	`setProperty` method for specifying a new property value.
`attrs`	`uintN`	Property flags.

Description

JS_DefineUCProperty defines a single Unicode-encoded property in a specified object, obj.

name is the Unicode-encoded name to assign to the property in the object. namelen is the length, in bytes, of name. value is a jsval that defines the property's data type and initial value. getter and setter identify the getProperty and setProperty methods for the property, respectively. If you pass null values for these entries, JS_DefineUCProperties assigns the default getProperty and setProperty methods to this property. attrs contains the property flags to set for the newly created property. The following table lists possible values you can pass in attrs, either singly, or OR'd together:

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 it successfully creates the property, JS_DefineUCProperty returns JS_TRUE. If the property already exists, or cannot be created, JS_DefineUCProperty returns JS_FALSE.

Notes

While you can assign a setProperty method to a property and set attrs to JSPROP_READONLY, the setter method will not be called on this property.

JavaScript-1.5 Reference

Summary

Syntax

Description

Notes

See Also