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

using System;
using static System.Buffers.Binary.BinaryPrimitives;

namespace PKHeX.Core;

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