using System; using static PKHeX.Core.StringConverter4Util; using static System.Buffers.Binary.BinaryPrimitives; namespace PKHeX.Core; /// /// Logic for converting a for Generation 4 GameCube games. /// public static class StringConverter4GC { private const ushort Terminator = 0xFFFF; private const char TerminatorChar = (char)Terminator; /// /// Converts Generation 4 Big Endian encoded character data to string. /// /// Byte array containing encoded character data. /// Converted string. public static string GetString(ReadOnlySpan data) { Span result = stackalloc char[data.Length]; var length = LoadString(data, result); return new string(result[..length]); } /// /// Encoded data /// Decoded character result buffer /// Character count loaded. public static int LoadString(ReadOnlySpan data, Span result) { int i = 0; for (; i < data.Length; i += 2) { var value = ReadUInt16BigEndian(data[i..]); if (value == Terminator) break; char chr = (char)ConvertValue2CharG4(value); if (chr == TerminatorChar) break; chr = StringConverter.SanitizeChar(chr); result[i/2] = chr; } return i/2; } /// /// Converts a string to Generation 4 Big Endian encoded character data. /// /// Span of bytes to write encoded string data /// String to be converted. /// Maximum length of string /// Buffer pre-formatting option /// Byte array containing encoded character data public static int SetString(Span destBuffer, ReadOnlySpan value, int maxLength, StringConverterOption option = StringConverterOption.ClearZero) { if (value.Length > maxLength) value = value[..maxLength]; // Hard cap if (option is StringConverterOption.ClearZero) destBuffer.Clear(); for (int i = 0; i < value.Length; i++) { var chr = value[i]; chr = StringConverter.UnSanitizeChar5(chr); ushort val = ConvertChar2ValueG4(chr); WriteUInt16BigEndian(destBuffer[(i * 2)..], val); } var count = value.Length * 2; if (count == destBuffer.Length) return count; WriteUInt16BigEndian(destBuffer[count..], Terminator); return count + 2; } /// /// Converts Generation 4 Big Endian encoded character data to string, with direct Unicode characters. /// /// Used by the Save File's internal strings. /// Byte array containing encoded character data. /// Converted string. public static string GetStringUnicode(ReadOnlySpan data) { Span result = stackalloc char[data.Length]; var length = LoadStringUnicode(data, result); return new string(result[..length]); } /// /// Encoded data /// Decoded character result buffer /// Character count loaded. public static int LoadStringUnicode(ReadOnlySpan data, Span result) { int i = 0; for (; i < data.Length; i += 2) { char chr = (char)ReadUInt16BigEndian(data[i..]); if (chr == TerminatorChar) break; chr = StringConverter.SanitizeChar(chr); result[i/2] = chr; } return i/2; } /// /// Converts a string to Generation 4 Big Endian encoded character data, with direct Unicode characters. /// /// Used by the Save File's internal strings. /// String to be converted. /// Span of bytes to write encoded string data /// Maximum length of string /// Buffer pre-formatting option /// Byte array containing encoded character data public static int SetStringUnicode(ReadOnlySpan value, Span destBuffer, int maxLength, StringConverterOption option = StringConverterOption.ClearZero) { if (value.Length > maxLength) value = value[..maxLength]; // Hard cap if (option is StringConverterOption.ClearZero) destBuffer.Clear(); for (int i = 0; i < value.Length; i++) { var c = value[i]; c = StringConverter.UnSanitizeChar5(c); WriteUInt16BigEndian(destBuffer[(i * 2)..], c); } var count = value.Length * 2; if (count == destBuffer.Length) return count; WriteUInt16BigEndian(destBuffer[count..], 0); return count + 2; } }