In This Topic ▼

L_SetlocaleW

Summary

Sets the locale for the library.

Syntax

#include "l_bitmap.h"

L_LTKRN_API L_WCHAR * L_SetlocaleW(category, locale)

Parameters

L_INT category

Category affected by the locale.

const L_WCHAR * locale

Locale name. Pass NULL to return the current locale.

Returns

Value	Meaning
!NULL	A pointer to the string representing the specified locale and category
NULL	Indicates that the `category` or `locale` parameter value was invalid

Comments

This function is used under rare circumstances. It is necessary only when running non-UNICODE applications that must deal with text (for example, filename strings) that is not part of the ASCII character set (for example, Japanese characters). Non-ASCII text (i.e. a Japanese or Arabic character) can be stored non-ambiguously in UNICODE. However, for non-UNICODE applications, the multi-byte representation of such characters depends on the code page. In this case, you must set the code page appropriately. For example, a non-UNICODE application can display Japanese characters only if the code page is set to a Japanese code page (like Japanese_Japan.932).

Pass NULL for the parameter locale to get the current locale, leaving the current locale unchanged.

Internally, this function calls the Microsoft C runtime function, setlocale. For details, see the MSDN documentation.

Required DLLs and Libraries

LTKRN
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64, Linux.