Get and set locale specific string conversion and error message callbacks.
Syntax
JSLocaleCallbacks *
JS_GetLocaleCallbacks(JSRuntime *rt);
void
JS_SetLocaleCallbacks(JSRuntime *rt, JSLocaleCallbacks *callbacks);
Name | Type | Description |
---|---|---|
cx |
|
Pointer to a JS context from which to derive runtime information. Requires request. In a JS_THREADSAFE build, the caller must be in a request on this JSContext . |
callbacks |
JSLocaleCallbacks * |
Pointer to a JSLocaleCallbacks struct. |
Callback functions
struct JSLocaleCallbacks {
JSLocaleToUpperCase localeToUpperCase;
JSLocaleToLowerCase localeToLowerCase;
JSLocaleCompare localeCompare; // not used #if EXPOSE_INTL_API
JSLocaleToUnicode localeToUnicode;
};
typedef bool
(* JSLocaleToUpperCase)(JSContext *cx, JS::HandleString src, JS::MutableHandleValue rval);
typedef bool
(* JSLocaleToLowerCase)(JSContext *cx, JS::HandleString src, JS::MutableHandleValue rval);
typedef bool
(* JSLocaleCompare)(JSContext *cx, JS::HandleString src1, JS::HandleString src2,
JS::MutableHandleValue rval);
typedef bool
(* JSLocaleToUnicode)(JSContext *cx, const char *src, JS::MutableHandleValue rval);
Type | Description |
---|---|
JSLocaleToUpperCase |
Implementation of String.prototype.toLocaleUpperCase() function. |
JSLocaleToLowerCase |
Implementation of String.prototype.toLocaleLowerCase() function. |
JSLocaleCompare |
Implementation of String.prototype.localeCompare() function. If EXPOSE_INTL_API is defined, Intl API is used instead. |
JSLocaleToUnicode |
Convert locale specific string to Unicode string. |
Description
JS_SetLocaleCallbacks
establishes locale callbacks. The pointer must persist as long as the JSRuntime
. Passing nullptr
restores the default behaviour.
JS_GetLocaleCallbacks
returns the address of the current locale callbacks struct, which may be nullptr
.