EFCore/src/Utils/StringBuilderExtensions.cs

// Copyright © 2021, 2025, Oracle and/or its affiliates.
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License, version 2.0, as
// published by the Free Software Foundation.
//
// This program is designed to work with certain software (including
// but not limited to OpenSSL) that is licensed under separate terms, as
// designated in a particular file or component or in included license
// documentation. The authors of MySQL hereby grant you an additional
// permission to link the program and your derivative works with the
// separately licensed software that they have either included with
// the program or referenced in the documentation.
//
// Without limiting anything contained in the foregoing, this file,
// which is part of MySQL Connector/NET, is also subject to the
// Universal FOSS Exception, version 1.0, a copy of which can be found at
// http://oss.oracle.com/licenses/universal-foss-exception.
//
// This program is distributed in the hope that it will be useful, but
// WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
// See the GNU General Public License, version 2.0, for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software Foundation, Inc.,
// 51 Franklin St, Fifth Floor, Boston, MA 02110-1301  USA

using System.Collections.Generic;
using System.Globalization;

namespace System.Text;

internal static class StringBuilderExtensions
{
  public static StringBuilder AppendJoin(
    this StringBuilder stringBuilder,
    IEnumerable<string> values,
    string separator = ", ")
    => stringBuilder.AppendJoin(values, (sb, value) => sb.Append(value), separator);

  public static StringBuilder AppendJoin(
    this StringBuilder stringBuilder,
    string separator,
    params string[] values)
    => stringBuilder.AppendJoin(values, (sb, value) => sb.Append(value), separator);

  public static StringBuilder AppendJoin<T>(
    this StringBuilder stringBuilder,
    IEnumerable<T> values,
    Action<StringBuilder, T> joinAction,
    string separator = ", ")
  {
    var appended = false;

    foreach (var value in values)
    {
      joinAction(stringBuilder, value);
      stringBuilder.Append(separator);
      appended = true;
    }

    if (appended)
    {
      stringBuilder.Length -= separator.Length;
    }

    return stringBuilder;
  }

  public static StringBuilder AppendJoin<T>(
    this StringBuilder stringBuilder,
    IEnumerable<T> values,
    Func<StringBuilder, T, bool> joinFunc,
    string separator = ", ")
  {
    var appended = false;

    foreach (var value in values)
    {
      if (joinFunc(stringBuilder, value))
      {
        stringBuilder.Append(separator);
        appended = true;
      }
    }

    if (appended)
    {
      stringBuilder.Length -= separator.Length;
    }

    return stringBuilder;
  }

  public static StringBuilder AppendJoin<T, TParam>(
    this StringBuilder stringBuilder,
    IEnumerable<T> values,
    TParam param,
    Action<StringBuilder, T, TParam> joinAction,
    string separator = ", ")
  {
    var appended = false;

    foreach (var value in values)
    {
      joinAction(stringBuilder, value, param);
      stringBuilder.Append(separator);
      appended = true;
    }

    if (appended)
    {
      stringBuilder.Length -= separator.Length;
    }

    return stringBuilder;
  }

  public static void AppendBytes(this StringBuilder builder, byte[] bytes)
  {
    builder.Append("'0x");

    for (var i = 0; i < bytes.Length; i++)
    {
      if (i > 31)
      {
        builder.Append("...");
        break;
      }

      builder.Append(bytes[i].ToString("X2", CultureInfo.InvariantCulture));
    }

    builder.Append('\'');
  }
}