BoolExtensions.cs

namespace Texnomic.Types.Extensions;

/// <summary>
/// Extension methods for <see cref="bool"/> values.
/// </summary>
public static class BoolExtensions
{
    extension(bool Value)
    {
        /// <summary>Encodes the boolean as a single-byte array (<c>0x01</c> / <c>0x00</c>).</summary>
        public byte[] ToBytes() => new[] { Convert.ToByte(Value) };

        /// <summary>Attempts to write the boolean as a single byte (<c>0x01</c> / <c>0x00</c>).</summary>
        public bool TryWriteBytes(Span<byte> Destination, out int BytesWritten)
        {
            if (Destination.Length < 1)
            {
                BytesWritten = 0;
                return false;
            }

            Destination[0] = Convert.ToByte(Value);
            BytesWritten = 1;
            return true;
        }

        /// <summary>Returns the canonical hexadecimal string <c>0x1</c> for <c>true</c> and <c>0x0</c> for <c>false</c>.</summary>
        public string AsHex() => Value ? "0x1" : "0x0";
    }
}