NLS: ejemplo de API basadas en nombres
La aplicación de ejemplo descrita en este tema muestra algunas de las funciones "nombre de configuración regional" de NLS. Las aplicaciones deben usar nombres de configuración regional en lugar de identificadores de configuración regional cuando sea posible.
La aplicación de ejemplo usa EnumSystemLocalesEx para enumerar todas las configuraciones regionales del sistema operativo, incluidas las configuraciones regionales complementarias.
La función de devolución de llamada de enumeración admitida por la aplicación puede tomar uno o varios nombres de configuración regional como parámetros. EnumSystemLocalesEx pasa estos nombres a la función de devolución de llamada en el valor lparam opcional. Si el usuario escribe las configuraciones regionales en la línea de comandos, la función de devolución de llamada solo muestra las configuraciones regionales especificadas en lugar de mostrar todas las configuraciones regionales.
Para cada configuración regional mostrada, la función de devolución de llamada notifica si es la configuración regional del sistema, imprime la fecha actual con los formatos predeterminados de la configuración regional y muestra todos los datos de la configuración regional en cada constante de información de configuración regional introducida en Windows Vista, por ejemplo, LOCALE_SSCRIPTS.
La aplicación de ejemplo analiza las configuraciones regionales de entrada para ver si son válidas mediante IsValidLocaleName.
En este ejemplo se muestran las siguientes funciones:
- CompareStringEx
- EnumSystemLocalesEx
- GetDateFormatEx
- GetLocaleInfoEx
- GetSystemDefaultLocaleName
- IsValidLocaleName
- LocaleNameToLCID
// THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
// ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
// THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
// PARTICULAR PURPOSE.
//
// Copyright (c) Microsoft Corporation. All rights reserved.
//
// ========================================================================
// CONSOLE APPLICATION : NamedNlsFunctions Project Overview
#include "stdafx.h"
#include "windows.h"
#include "stdio.h"
// All of the LCTYPES new to Windows Vista
LCTYPE NewTypes[] =
{
LOCALE_SNAME,
LOCALE_SDURATION,
LOCALE_SKEYBOARDSTOINSTALL,
LOCALE_SSHORTESTDAYNAME1,
LOCALE_SSHORTESTDAYNAME2,
LOCALE_SSHORTESTDAYNAME3,
LOCALE_SSHORTESTDAYNAME4,
LOCALE_SSHORTESTDAYNAME5,
LOCALE_SSHORTESTDAYNAME6,
LOCALE_SSHORTESTDAYNAME7,
LOCALE_SISO639LANGNAME2,
LOCALE_SISO3166CTRYNAME2,
LOCALE_SNAN,
LOCALE_SPOSINFINITY,
LOCALE_SNEGINFINITY,
LOCALE_SSCRIPTS
};
// Strings so we can print out the LCTYPES
LPCWSTR NewTypeNames[] =
{
L"LOCALE_SNAME",
L"LOCALE_SDURATION",
L"LOCALE_SKEYBOARDSTOINSTALL",
L"LOCALE_SSHORTESTDAYNAME1",
L"LOCALE_SSHORTESTDAYNAME2",
L"LOCALE_SSHORTESTDAYNAME3",
L"LOCALE_SSHORTESTDAYNAME4",
L"LOCALE_SSHORTESTDAYNAME5",
L"LOCALE_SSHORTESTDAYNAME6",
L"LOCALE_SSHORTESTDAYNAME7",
L"LOCALE_SISO639LANGNAME2",
L"LOCALE_SISO3166CTRYNAME2",
L"LOCALE_SNAN",
L"LOCALE_SPOSINFINITY",
L"LOCALE_SNEGINFINITY",
L"LOCALE_SSCRIPTS"
};
// Callback for EnumSystemLocalesEx()
#define BUFFER_SIZE 512
BOOL CALLBACK MyFuncLocaleEx(LPWSTR pStr, DWORD dwFlags, LPARAM lparam)
{
UNREFERENCED_PARAMETER(dwFlags);
WCHAR** argv = (WCHAR**)lparam;
WCHAR wcBuffer[BUFFER_SIZE];
int iResult;
int i;
// If specific locales were specified on the command line check for a match
if (*argv && argv[1])
{
// Check each argument to see if our locale matches
for (i = 1; argv[i] != 0; i++)
{
// Using invariant, check if the name matches the input. CompareStringEx
// is probably overkill, but we want to demonstrate that named API.
if (CompareStringEx(LOCALE_NAME_INVARIANT,
LINGUISTIC_IGNORECASE,
argv[i],
-1,
pStr,
-1,
NULL,
NULL,
0) == CSTR_EQUAL)
{
break;
}
}
// If no match then stop and don't output this one
if (argv[i] == 0)
return TRUE;
}
// Print out the locale name we found
iResult = GetLocaleInfoEx(pStr, LOCALE_SENGLANGUAGE, wcBuffer, BUFFER_SIZE);
// If it succeeds, print it out
if (iResult > 0)
wprintf(L"Locale %s (%s)\n", pStr, wcBuffer);
else
wprintf(L"Locale %s had error %d\n", pStr, GetLastError());
// If this is the system locale, let us know. CompareStringEx
// is probably overkill, but we want to demonstrate that named API.
iResult = GetSystemDefaultLocaleName(wcBuffer, BUFFER_SIZE);
if (iResult > 0)
{
if (CompareStringEx(LOCALE_NAME_INVARIANT,
LINGUISTIC_IGNORECASE,
wcBuffer,
-1,
pStr,
-1,
NULL,
NULL,
0) == CSTR_EQUAL)
{
wprintf(L"Locale %s is the system locale!\n", wcBuffer);
}
}
else
{
wprintf(L"Error %d getting system locale\n", GetLastError());
}
// Get its LCID
LCID lcid = LocaleNameToLCID(pStr, NULL);
if (lcid != 0)
wprintf(L"LCID for %s is %x\n", pStr, lcid);
else
wprintf(L"Error %d getting LCID\n", GetLastError());
// Get today's date
iResult = GetDateFormatEx(pStr, DATE_LONGDATE, NULL, NULL, wcBuffer, BUFFER_SIZE, NULL);
if (iResult > 0)
wprintf(L"Date: %s\n", wcBuffer);
else
wprintf(L"Error %d getting today's date for %s\n", GetLastError(), pStr);
// Loop through all of the new LCTYPES and do GetLocaleInfoEx on them
for (i = 0; i < sizeof(NewTypes) / sizeof(NewTypes[0]); i++)
{
// Get this LCTYPE result for this locale
iResult = GetLocaleInfoEx(pStr, NewTypes[i], wcBuffer, BUFFER_SIZE);
// If it succeeds, print it out
if (iResult > 0)
{
wprintf(L" %s has value %s\n", NewTypeNames[i], wcBuffer);
}
else
{
wprintf(L" %s had error %d\n", NewTypeNames[i], GetLastError());
}
}
return (TRUE);
}
int __cdecl wmain(int argc, wchar_t* argv[])
{
UNREFERENCED_PARAMETER(argc);
// Enumerate all the locales and report on them
EnumSystemLocalesEx( MyFuncLocaleEx, LOCALE_ALL, (LPARAM)argv, NULL);
// See which of the input locales are valid (if any)
if (*argv && argv[1])
{
// Check each argument to see if our locale matches
for (int i = 1; argv[i] != 0; i++)
{
// See if this is a valid locale name
if (!IsValidLocaleName(argv[i]))
{
wprintf(L"%s is not a valid locale name\n", argv[i]);
}
}
}
}
/*
The following is a portion of the results produced by this code example.
Locale en-US (English)
Locale en-US is the system locale!
LCID for en-US is 409
Date: Wednesday, February 03, 2010
LOCALE_SNAME has value en-US
LOCALE_SDURATION has value h:mm:ss
LOCALE_SKEYBOARDSTOINSTALL has value 0409:00000409
LOCALE_SSHORTESTDAYNAME1 has value Mo
LOCALE_SSHORTESTDAYNAME2 has value Tu
LOCALE_SSHORTESTDAYNAME3 has value We
LOCALE_SSHORTESTDAYNAME4 has value Th
LOCALE_SSHORTESTDAYNAME5 has value Fr
LOCALE_SSHORTESTDAYNAME6 has value Sa
LOCALE_SSHORTESTDAYNAME7 has value Su
LOCALE_SISO639LANGNAME2 has value eng
LOCALE_SISO3166CTRYNAME2 has value USA
LOCALE_SNAN has value NaN
LOCALE_SPOSINFINITY has value Infinity
LOCALE_SNEGINFINITY has value -Infinity
LOCALE_SSCRIPTS has value Latn;
Locale fr-FR (French)
LCID for fr-FR is 40c
Date: mercredi 3 f vrier 2010
LOCALE_SNAME has value fr-FR
LOCALE_SDURATION has value HH:mm:ss
LOCALE_SKEYBOARDSTOINSTALL has value 040c:0000040c;0409:00000409
LOCALE_SSHORTESTDAYNAME1 has value lu
LOCALE_SSHORTESTDAYNAME2 has value ma
LOCALE_SSHORTESTDAYNAME3 has value me
LOCALE_SSHORTESTDAYNAME4 has value je
LOCALE_SSHORTESTDAYNAME5 has value ve
LOCALE_SSHORTESTDAYNAME6 has value sa
LOCALE_SSHORTESTDAYNAME7 has value di
LOCALE_SISO639LANGNAME2 has value fra
LOCALE_SISO3166CTRYNAME2 has value FRA
LOCALE_SNAN has value Non Num rique
LOCALE_SPOSINFINITY has value +Infini
LOCALE_SNEGINFINITY has value -Infini
LOCALE_SSCRIPTS has value Latn;
Locale es-ES (Spanish)
LCID for es-ES is c0a
Date: mi rcoles, 03 de febrero de 2010
LOCALE_SNAME has value es-ES
LOCALE_SDURATION has value H:mm:ss
LOCALE_SKEYBOARDSTOINSTALL has value 0c0a:0000040a;0409:00000409
LOCALE_SSHORTESTDAYNAME1 has value lu
LOCALE_SSHORTESTDAYNAME2 has value ma
LOCALE_SSHORTESTDAYNAME3 has value mi
LOCALE_SSHORTESTDAYNAME4 has value ju
LOCALE_SSHORTESTDAYNAME5 has value vi
LOCALE_SSHORTESTDAYNAME6 has value s
LOCALE_SSHORTESTDAYNAME7 has value do
LOCALE_SISO639LANGNAME2 has value spa
LOCALE_SISO3166CTRYNAME2 has value ESP
LOCALE_SNAN has value NeuN
LOCALE_SPOSINFINITY has value Infinito
LOCALE_SNEGINFINITY has value -Infinito
LOCALE_SSCRIPTS has value Latn;
*/