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.