PowerShell/src/System.Management.Automation/utils/StringUtil.cs

/********************************************************************++
Copyright (c) Microsoft Corporation.  All rights reserved.
--********************************************************************/

using System.Management.Automation.Host;
using Dbg = System.Management.Automation.Diagnostics;

namespace System.Management.Automation.Internal
{
    internal static
    class StringUtil
    {
        internal static
        string
        Format(string formatSpec, object o)
        {
            return String.Format(System.Globalization.CultureInfo.CurrentCulture, formatSpec, o);
        }



        internal static
        string
        Format(string formatSpec, object o1, object o2)
        {
            return String.Format(System.Globalization.CultureInfo.CurrentCulture, formatSpec, o1, o2);
        }



        internal static
        string
        Format(string formatSpec, params object[] o)
        {
            return String.Format(System.Globalization.CultureInfo.CurrentCulture, formatSpec, o);
        }



        internal static
        string
        TruncateToBufferCellWidth(PSHostRawUserInterface rawUI, string toTruncate, int maxWidthInBufferCells)
        {
            Dbg.Assert(rawUI != null, "need a reference");
            Dbg.Assert(maxWidthInBufferCells >= 0, "maxWidthInBufferCells must be positive");

            string result;
            int i = Math.Min(toTruncate.Length, maxWidthInBufferCells);

            do
            {
                result = toTruncate.Substring(0, i);
                int cellCount = rawUI.LengthInBufferCells(result);
                if (cellCount <= maxWidthInBufferCells)
                {
                    // the segment from start..i fits

                    break;
                }
                else
                {
                    // The segment does not fit, back off a tad until it does
                    // We need to back off 1 by 1 because there could theoretically 
                    // be characters taking more 2 buffer cells
                    --i;
                }
            } while (true);

            return result;
        }
    }
}   // namespace