File: RedactedData.cs
Web Access
Project: src\src\Libraries\Microsoft.Extensions.Compliance.Testing\Microsoft.Extensions.Compliance.Testing.csproj (Microsoft.Extensions.Compliance.Testing)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
using System;
using Microsoft.Shared.Diagnostics;
 
namespace Microsoft.Extensions.Compliance.Testing;
 
/// <summary>
/// State representing a single redaction "event".
/// </summary>
public readonly struct RedactedData : IEquatable<RedactedData>
{
    /// <summary>
    /// Gets the original data that got redacted.
    /// </summary>
    public string Original { get; }
 
    /// <summary>
    /// Gets the redacted data.
    /// </summary>
    public string Redacted { get; }
 
    /// <summary>
    /// Gets the order in which data was redacted.
    /// </summary>
    public int SequenceNumber { get; }
 
    /// <summary>
    /// Initializes a new instance of the <see cref="RedactedData"/> struct.
    /// </summary>
    /// <param name="original">Data that was redacted.</param>
    /// <param name="redacted">Redacted data.</param>
    /// <param name="sequenceNumber">Order in which data were redacted.</param>
    public RedactedData(string original, string redacted, int sequenceNumber)
    {
        Original = Throw.IfNull(original);
        Redacted = Throw.IfNull(redacted);
        SequenceNumber = sequenceNumber;
    }
 
    /// <summary>
    /// Checks if object is equal to this instance of <see cref="object"/>.
    /// </summary>
    /// <param name="obj">Object to check for equality.</param>
    /// <returns><see langword="true" /> if object instances are equal <see langword="false" /> otherwise.</returns>
    public override bool Equals(object? obj) => obj is RedactedData other && Equals(other);
 
    /// <summary>
    /// Checks if object is equal to this instance of <see cref="RedactedData"/>.
    /// </summary>
    /// <param name="other">Instance to check for equality.</param>
    /// <returns><see langword="true" /> if object instances are equal <see langword="false" /> otherwise.</returns>
    public bool Equals(RedactedData other) => other.Original == Original && other.Redacted == Redacted && other.SequenceNumber == SequenceNumber;
 
    /// <summary>
    /// Get hashcode of given <see cref="RedactedData"/>.
    /// </summary>
    /// <returns>Hash code.</returns>
    public override int GetHashCode() => HashCode.Combine(Original, Redacted, SequenceNumber);
 
    /// <summary>
    /// Compares two instances.
    /// </summary>
    /// <param name="left">Left argument of the comparison.</param>
    /// <param name="right">Right argument of the comparison.</param>
    /// <returns><see langword="true" /> when equal, <see langword="false" /> otherwise.</returns>
    public static bool operator ==(RedactedData left, RedactedData right)
    {
        return left.Equals(right);
    }
 
    /// <summary>
    /// Compares two instances.
    /// </summary>
    /// <param name="left">Left argument of the comparison.</param>
    /// <param name="right">Right argument of the comparison.</param>
    /// <returns><see langword="true" /> when not equal, <see langword="false" /> otherwise.</returns>
    public static bool operator !=(RedactedData left, RedactedData right)
    {
        return !(left == right);
    }
}