mirror of https://github.com/ppy/osu
59 lines
2.8 KiB
C#
59 lines
2.8 KiB
C#
// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
|
|
// See the LICENCE file in the repository root for full licence text.
|
|
|
|
using System;
|
|
using System.Globalization;
|
|
using osu.Framework.Configuration;
|
|
using osu.Framework.Localisation;
|
|
using osu.Game.Localisation;
|
|
|
|
namespace osu.Game.Extensions
|
|
{
|
|
/// <summary>
|
|
/// Conversion utilities for the <see cref="Language"/> enum.
|
|
/// </summary>
|
|
public static class LanguageExtensions
|
|
{
|
|
/// <summary>
|
|
/// Returns the culture code of the <see cref="CultureInfo"/> that corresponds to the supplied <paramref name="language"/>.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// This is required as enum member names are not allowed to contain hyphens.
|
|
/// </remarks>
|
|
public static string ToCultureCode(this Language language)
|
|
=> language.ToString().Replace("_", "-");
|
|
|
|
/// <summary>
|
|
/// Attempts to parse the supplied <paramref name="cultureCode"/> to a <see cref="Language"/> value.
|
|
/// </summary>
|
|
/// <param name="cultureCode">The code of the culture to parse.</param>
|
|
/// <param name="language">The parsed <see cref="Language"/>. Valid only if the return value of the method is <see langword="true" />.</param>
|
|
/// <returns>Whether the parsing succeeded.</returns>
|
|
public static bool TryParseCultureCode(string cultureCode, out Language language)
|
|
=> Enum.TryParse(cultureCode.Replace("-", "_"), out language);
|
|
|
|
/// <summary>
|
|
/// Parses the <see cref="Language"/> that is specified in <paramref name="frameworkLocale"/>,
|
|
/// or if that is not valid, the language of the current <see cref="ResourceManagerLocalisationStore"/> as exposed by <paramref name="localisationParameters"/>.
|
|
/// </summary>
|
|
/// <param name="frameworkLocale">The current <see cref="FrameworkSetting.Locale"/>.</param>
|
|
/// <param name="localisationParameters">The current <see cref="LocalisationParameters"/> of the <see cref="LocalisationManager"/>.</param>
|
|
/// <returns>The parsed language.</returns>
|
|
public static Language GetLanguageFor(string frameworkLocale, LocalisationParameters localisationParameters)
|
|
{
|
|
// the usual case when the user has changed the language
|
|
if (TryParseCultureCode(frameworkLocale, out var language))
|
|
return language;
|
|
|
|
if (localisationParameters.Store != null)
|
|
{
|
|
// startup case, locale not explicitly set, or the set language was removed in an update
|
|
if (TryParseCultureCode(localisationParameters.Store.EffectiveCulture.Name, out language))
|
|
return language;
|
|
}
|
|
|
|
return Language.en;
|
|
}
|
|
}
|
|
}
|