PKHeX/PKHeX.Core/PKM/Strings/StringConverter7.cs

80 lines
3.1 KiB
C#
Raw Normal View History

using System;
using static System.Buffers.Binary.BinaryPrimitives;
namespace PKHeX.Core;
2022-01-08 17:54:32 +00:00
/// <summary>
/// Logic for converting a <see cref="string"/> for Generation 7 games.
/// </summary>
/// <remarks>Customized Unicode glyph remapping for visual display. Chinese Species names use a special range of characters -- <see cref="StringConverter7ZH"/>.</remarks>
public static class StringConverter7
{
private const ushort TerminatorNull = 0;
/// <summary>Converts Generation 7 encoded data to decoded string.</summary>
/// <param name="data">Encoded data</param>
/// <returns>Decoded string.</returns>
public static string GetString(ReadOnlySpan<byte> data)
{
Span<char> result = stackalloc char[data.Length];
int length = LoadString(data, result);
return new string(result[..length]);
}
/// <inheritdoc cref="GetString(ReadOnlySpan{byte})"/>
/// <param name="data">Encoded data</param>
/// <param name="result">Decoded character result buffer</param>
/// <returns>Character count loaded.</returns>
public static int LoadString(ReadOnlySpan<byte> data, Span<char> result)
{
int i = 0;
for (; i < data.Length; i += 2)
{
var value = ReadUInt16LittleEndian(data[i..]);
if (value == TerminatorNull)
break;
result[i/2] = StringConverter.SanitizeChar((char)value);
}
var span = result[..(i/2)];
StringConverter7ZH.RemapChineseGlyphsBin2String(span);
return i/2;
}
/// <summary>Gets the bytes for a Generation 7 string.</summary>
2022-01-08 17:54:32 +00:00
/// <param name="destBuffer">Span of bytes to write encoded string data</param>
/// <param name="value">Decoded string.</param>
/// <param name="maxLength">Maximum length of the input <see cref="value"/></param>
/// <param name="language">Language specific conversion (Chinese)</param>
2022-01-08 17:54:32 +00:00
/// <param name="option">Buffer pre-formatting option</param>
/// <param name="chinese">Chinese string remapping should be attempted</param>
/// <returns>Encoded data.</returns>
public static int SetString(Span<byte> destBuffer, ReadOnlySpan<char> value, int maxLength, int language,
StringConverterOption option = StringConverterOption.ClearZero, bool chinese = false)
{
if (value.Length > maxLength)
value = value[..maxLength]; // Hard cap
if (option is StringConverterOption.ClearZero)
destBuffer.Clear();
bool trad = StringConverter7ZH.IsTraditional(value, language);
bool isFullWidth = StringConverter.GetIsFullWidthString(value);
for (int i = 0; i < value.Length; i++)
{
char c = value[i];
if (!isFullWidth)
c = StringConverter.UnSanitizeChar(c);
if (chinese)
c = StringConverter7ZH.ConvertString2BinG7_zh(c, trad);
WriteUInt16LittleEndian(destBuffer[(i * 2)..], c);
}
int count = value.Length * 2;
if (count == destBuffer.Length)
return count;
WriteUInt16LittleEndian(destBuffer[count..], TerminatorNull);
return count + 2;
}
}