using System; using System.Collections.Concurrent; using System.Diagnostics.CodeAnalysis; using System.Resources; namespace PKHeX.Core; public static partial class Util { public static EmbeddedResourceCache ResourceCache { get; } = new(typeof(Util).Assembly); /// /// Expose for plugin use/reuse so that plugins can cache their own strings without needing to manage their own cache. /// /// /// Assume the plugins won't wipe/modify, but if they do, that's on them. /// Might enable some tweaks to work like changing species names. /// public static ConcurrentDictionary CachedStrings { get; } = []; #region String Lists /// /// Gets a list of all Pokémon species names. /// /// Language of the Pokémon species names to select (e.g. "en", "fr", "jp", etc.) /// An array of strings whose indexes correspond to the IDs of each Pokémon species name. public static string[] GetSpeciesList(string language) => GetStringList("species", language); /// /// Gets a list of all move names. /// /// Language of the move names to select (e.g. "en", "fr", "jp", etc.) /// An array of strings whose indexes correspond to the IDs of each move name. public static string[] GetMovesList(string language) => GetStringList("moves", language); /// /// Gets a list of all Pokémon ability names. /// /// Language of the Pokémon ability names to select (e.g. "en", "fr", "jp", etc.) /// An array of strings whose indexes correspond to the IDs of each Pokémon ability name. public static string[] GetAbilitiesList(string language) => GetStringList("abilities", language); /// /// Gets a list of all Pokémon nature names. /// /// Language of the Pokémon nature names to select (e.g. "en", "fr", "jp", etc.) /// An array of strings whose indexes correspond to the IDs of each Pokémon nature name. public static string[] GetNaturesList(string language) => GetStringList("natures", language); /// /// Gets a list of all Pokémon form names. /// /// Language of the Pokémon form names to select (e.g. "en", "fr", "jp", etc.) /// An array of strings whose indexes correspond to the IDs of each Pokémon form name. public static string[] GetFormsList(string language) => GetStringList("forms", language); /// /// Gets a list of all Pokémon type names. /// /// Language of the Pokémon type names to select (e.g. "en", "fr", "jp", etc.) /// An array of strings whose indexes correspond to the IDs of each Pokémon type name. public static string[] GetTypesList(string language) => GetStringList("types", language); /// /// Gets a list of all Pokémon characteristic. /// /// Language of the Pokémon characteristic to select (e.g. "en", "fr", "jp", etc.) /// An array of strings whose indexes correspond to the IDs of each Pokémon characteristic. public static string[] GetCharacteristicsList(string language) => GetStringList("character", language); /// /// Gets a list of all items. /// /// Language of the items to select (e.g. "en", "fr", "jp", etc.) /// An array of strings whose indexes correspond to the IDs of each item. public static string[] GetItemsList(string language) => GetStringList("items", language); /// /// Retrieves the localization index list for all requested strings for the through Spanish. /// /// Base file name /// Ignores Korean Language. public static string[][] GetLanguageStrings7([ConstantExpected] string fileName) => [ [], // 0 - None GetStringList(fileName, "ja"), // 1 GetStringList(fileName, "en"), // 2 GetStringList(fileName, "fr"), // 3 GetStringList(fileName, "it"), // 4 GetStringList(fileName, "de"), // 5 [], // 6 - None GetStringList(fileName, "es"), // 7 ]; /// /// Retrieves the localization index list for all requested strings for the through Korean. /// /// Base file name public static string[][] GetLanguageStrings8([ConstantExpected] string fileName) => [ [], // 0 - None GetStringList(fileName, "ja"), // 1 GetStringList(fileName, "en"), // 2 GetStringList(fileName, "fr"), // 3 GetStringList(fileName, "it"), // 4 GetStringList(fileName, "de"), // 5 [], // 6 - None GetStringList(fileName, "es"), // 7 GetStringList(fileName, "ko"), // 8 ]; /// /// Retrieves the localization index list for all requested strings for the through Chinese. /// /// Base file name /// Language code to use for both Chinese localizations. public static string[][] GetLanguageStrings10([ConstantExpected] string fileName, string? zh = null) => [ [], // 0 - None GetStringList(fileName, "ja"), // 1 GetStringList(fileName, "en"), // 2 GetStringList(fileName, "fr"), // 3 GetStringList(fileName, "it"), // 4 GetStringList(fileName, "de"), // 5 [], // 6 - None GetStringList(fileName, "es"), // 7 GetStringList(fileName, "ko"), // 8 GetStringList(fileName, zh ?? "zh-Hans"), // 9 GetStringList(fileName, zh ?? "zh-Hant"), // 10 ]; #endregion /// public static string[] GetStringList(string fileName) { if (CachedStrings.TryGetValue(fileName, out var result)) return result; return LoadAndCache(fileName, ResourceCache); } /// /// Gets a string array from an assembly's resources. /// /// Caches the result array for future fetches of the same resource. public static string[] GetStringList(string fileName, EmbeddedResourceCache src) { if (CachedStrings.TryGetValue(fileName, out var result)) return result; return LoadAndCache(fileName, src); } private static string[] LoadAndCache(string fileName, EmbeddedResourceCache src) { if (!src.TryGetStringResource(fileName, out var txt)) // Fetch File, \n to list. return []; // Instead of throwing an exception, return empty. var result = FastSplit(txt); // could just string.Split but we know ours are \n or \r\n CachedStrings.TryAdd(fileName, result); return result; } public static string[] GetStringList(string fileName, string lang2char, [ConstantExpected] string type = "text") => GetStringList(GetFullResourceName(fileName, lang2char, type)); private static string GetFullResourceName(string fileName, string lang2char, [ConstantExpected] string type) => $"{type}_{fileName}_{lang2char}"; public static byte[] GetBinaryResource(string name) { if (!ResourceCache.TryGetBinaryResource(name, out var result)) throw new MissingManifestResourceException($"Resource not found: {name}"); return result; } public static string GetStringResource(string name) { if (!ResourceCache.TryGetStringResource(name, out var result)) throw new MissingManifestResourceException($"Resource not found: {name}"); return result; } private static string[] FastSplit(ReadOnlySpan s) { // Get Count if (s.Length == 0) return []; var count = 1 + s.Count('\n'); var result = new string[count]; var i = 0; while (true) { var index = s.IndexOf('\n'); var length = index == -1 ? s.Length : index; var slice = s[..length]; if (slice.Length != 0 && slice[^1] == '\r') slice = slice[..^1]; result[i++] = slice.ToString(); if (i == count) return result; s = s[(index + 1)..]; } } }