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;
}
}