149 lines
4.8 KiB
Java
149 lines
4.8 KiB
Java
/* LocaleHelper.java -- helper routines for localization
|
|
Copyright (C) 2004, 2005 Free Software Foundation, Inc.
|
|
|
|
This file is part of GNU Classpath.
|
|
|
|
GNU Classpath is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2, or (at your option)
|
|
any later version.
|
|
|
|
GNU Classpath is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with GNU Classpath; see the file COPYING. If not, write to the
|
|
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
|
02110-1301 USA.
|
|
|
|
Linking this library statically or dynamically with other modules is
|
|
making a combined work based on this library. Thus, the terms and
|
|
conditions of the GNU General Public License cover the whole
|
|
combination.
|
|
|
|
As a special exception, the copyright holders of this library give you
|
|
permission to link this library with independent modules to produce an
|
|
executable, regardless of the license terms of these independent
|
|
modules, and to copy and distribute the resulting executable under
|
|
terms of your choice, provided that you also meet, for each linked
|
|
independent module, the terms and conditions of the license of that
|
|
module. An independent module is a module which is not derived from
|
|
or based on this library. If you modify this library, you may extend
|
|
this exception to your version of the library, but you are not
|
|
obligated to do so. If you do not wish to do so, delete this
|
|
exception statement from your version. */
|
|
|
|
|
|
package gnu.java.locale;
|
|
|
|
import java.text.Collator;
|
|
import java.util.Locale;
|
|
|
|
/**
|
|
* This class provides common helper methods
|
|
* for handling localized data.
|
|
*
|
|
* @author Andrew John Hughes (gnu_andrew@member.fsf.org)
|
|
*
|
|
* @see java.util.Locale
|
|
* @see java.util.ResourceBundle
|
|
*/
|
|
public class LocaleHelper
|
|
{
|
|
/**
|
|
* <p>
|
|
* This method is used by the localized name lookup methods to
|
|
* retrieve the next locale to try. The next locale is derived
|
|
* from the supplied locale by applying the first applicable
|
|
* rule from the following:
|
|
* </p>
|
|
* <ol>
|
|
* <li>If the variant contains a <code>'_'</code>, then
|
|
* this and everything following it is trimmed.</li>
|
|
* <li>If the variant is non-empty, it is converted to
|
|
* an empty string.</li>
|
|
* <li>If the country is non-empty, it is converted to
|
|
* an empty string.</li>
|
|
* <li>If the language is non-empty, it is converted to
|
|
* an empty string (forming {@link java.util.Locale#ROOT})</li>
|
|
* </ol>
|
|
* <p>
|
|
* The base fallback locale is {@link java.util.Locale#ROOT}.
|
|
* </p>
|
|
*
|
|
* @param locale the locale for which a localized piece of
|
|
* data could not be obtained.
|
|
* @return the next fallback locale to try.
|
|
*/
|
|
public static Locale getFallbackLocale(Locale locale)
|
|
{
|
|
String language = locale.getLanguage();
|
|
String country = locale.getCountry();
|
|
String variant = locale.getVariant();
|
|
int uscore = variant.indexOf('_');
|
|
if (uscore != -1)
|
|
return new Locale(language, country,
|
|
variant.substring(0, uscore));
|
|
if (!variant.isEmpty())
|
|
return new Locale(language, country, "");
|
|
if (!country.isEmpty())
|
|
return new Locale(language, "", "");
|
|
return Locale.ROOT;
|
|
}
|
|
|
|
/**
|
|
* Return an array of all the locales for which there is a
|
|
* {@link Collator} instance. A new array is returned each time.
|
|
*/
|
|
public static Locale[] getCollatorLocales()
|
|
{
|
|
// For now we don't bother caching. This is probably
|
|
// not called very frequently. And, we would have to
|
|
// clone the array anyway.
|
|
if (LocaleData.collatorLocaleNames.length == 0)
|
|
return new Locale[] { Locale.US };
|
|
Locale[] result = new Locale[LocaleData.collatorLocaleNames.length];
|
|
for (int i = 0; i < result.length; ++i)
|
|
{
|
|
String language;
|
|
String region = "";
|
|
String variant = "";
|
|
String name = LocaleData.collatorLocaleNames[i];
|
|
|
|
language = name.substring(0, 2);
|
|
|
|
if (name.length() > 2)
|
|
region = name.substring(3);
|
|
|
|
int index = region.indexOf("_");
|
|
if (index > 0)
|
|
{
|
|
variant = region.substring(index + 1);
|
|
region = region.substring(0, index - 1);
|
|
}
|
|
|
|
result[i] = new Locale(language, region, variant);
|
|
}
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* Return the number of locales we know of.
|
|
*/
|
|
public static int getLocaleCount()
|
|
{
|
|
return LocaleData.localeNames.length;
|
|
}
|
|
|
|
/**
|
|
* Return the Nth locale name.
|
|
*/
|
|
public static String getLocaleName(int n)
|
|
{
|
|
return LocaleData.localeNames[n];
|
|
}
|
|
}
|
|
|