arm_is_charset_supported (3) - Linux Man Pages
arm_is_charset_supported: check character encoding
NAMEarm_is_charset_supported - check character encoding
DESCRIPTIONarm_is_charset_supported() indicates whether an ARM library supports a specified character encoding.
The default encoding for all strings provided by the application on all operating systems is UTF-8. An application may specify an alternate encoding when executing arm_register_application(), and then use it for all strings it provides on all calls including arm_register_application(), but should never do so without first issuing arm_is_charset_supported() to test whether the value is supported.
An ARM library on the operating systems listed in Table 1 must support the specified encodings. Applications are encouraged to use one of these encodings to ensure that any ARM implementation will support the application's ARM instrumentation. Another alternative is to use one of these encodings along with a preferred encoding. If the ARM library supports the preferred encoding, it is used; otherwise, one of the mandatory encodings is used.
Table 1: Mandatory Encodings by Platform
charset is an IANA (Internet Assigned Numbers Authority - see www.iana.org) MIBenum value. Support for some values is mandatory by any ARM implementation on a specified platform, as shown in the table.
RETURN VALUEOn success, the function returns ARM_SUCCESS. A non-zero value indicates an error.
ERRORSIf the return code is negative, an error occurred. If the return code is not negative, an error may or may not have occurred - the determination of what is an error and whether an error code is returned is at the discretion of the ARM implementation. The application can test the return code if it wants to provide its own error logging.
The following errors are recognized by this implementation, but may not be portable to other implementations:
- The supported pointer must not be null.