// 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.Build.Framework;

namespace Microsoft.DotNet.Build.Tasks.Workloads;

public static class StringExtensions
{
    /// <summary>
    /// Removes the leading occurence of a string from the current string.
    /// </summary>
    /// <param name="str">The current string.</param>
    /// <param name="trimString">The string to remove.</param>
    /// <returns>The string that remains after the leading occurence of <paramref name="trimString"/> was removed.</returns>
    public static string TrimStart(this string str, string trimString)
    {
        return str.StartsWith(trimString) ? str.Remove(0, trimString.Length) : str;
    }

    /// <summary>
    /// Removes the leading occrence of a string from the current string.
    /// </summary>
    /// <param name="str">The current string.</param>
    /// <param name="trimString">The string to remove.</param>
    /// <param name="comparisonType">Specifies the comparison rules to use when searching for the string to remove.</param>
    /// <returns>The string that remains after the leading occurence of <paramref name="trimString"/> was removed.</returns>
    public static string TrimStart(this string str, string trimString, StringComparison comparisonType)
    {
        return str.StartsWith(trimString, comparisonType) ? str.Remove(0, trimString.Length) : str;
    }

    /// <summary>
    /// Replace multiple substrings using task items.
    /// </summary>
    /// <param name="str">The current string.</param>
    /// <param name="replacementStrings">An array of task items containing substrings and replacement strings.</param>
    /// <returns>A string with all instances of the specified strings have been replaced.</returns>
    public static string Replace(this string str, ITaskItem[] replacementStrings)
    {
        if ((replacementStrings is not null) && (replacementStrings.Length > 0))
        {
            foreach (ITaskItem item in replacementStrings)
            {
                str = str.Replace(item.ItemSpec, item.GetMetadata(Metadata.Replacement));
            }
        }

        return str;
    }
}