C#的String.PadRight 方法

目录

一、重载

二、PadRight(Int32)

1.定义?

2.示例

三、PadRight(Int32, Char)

1.定义

2.实例

---

????????返回一个指定长度的新字符串，其中在当前字符串的结尾填充空格或指定的 Unicode 字符。

一、重载

PadRight(Int32)	返回一个新字符串，该字符串通过在此字符串中的字符右侧填充空格来达到指定的总长度，从而使这些字符左对齐。
PadRight(Int32, Char)	返回一个新字符串，该字符串通过在此字符串中的字符右侧填充指定的?Unicode?字符来达到指定的总长度，从而使这些字符左对齐。

二、PadRight(Int32)

????????返回一个新字符串，该字符串通过在此字符串中的字符右侧填充空格来达到指定的总长度，从而使这些字符左对齐。

1.定义?

public string PadRight (int totalWidth);

参数
totalWidth
Int32
结果字符串中的字符数，等于原始字符数加上任何其他填充字符。

返回
String
与此实例等效的一个新字符串，但该字符串为左对齐，因此，在右侧填充所需任意数量的空格，使长度达到 totalWidth。 但是，如果 totalWidth 小于此实例的长度，则此方法返回对现有实例的引用。 如果 totalWidth 等于此实例的长度，则此方法返回与此实例相同的新字符串。

例外
ArgumentOutOfRangeException
totalWidth 小于零。

2.示例

// PadRight(Int32)

namespace ConsoleApp46
{
    internal class Program
    {
        private static void Main(string[] args)
        {
            ArgumentNullException.ThrowIfNull(args);

            string str;
            str = "BBQ and Slaw";

            Console.Write("|");
            Console.Write(str.PadRight(15));
            Console.WriteLine("|");       // 长度=15

            Console.Write("|");
            Console.Write(str.PadRight(5));
            Console.WriteLine("|");       // 长度=现有实例的长度
        }
    }
}
//运行结果：
/*
|BBQ and Slaw   |
|BBQ and Slaw|
 */

????????Unicode 空间定义为十六进制0x0020。

????????PadRight(Int32) 方法填充返回的字符串的末尾。 这意味着，当与从右向左的语言一起使用时，它会填充字符串的左侧部分。

三、PadRight(Int32, Char)

????????返回一个新字符串，该字符串通过在此字符串中的字符右侧填充指定的 Unicode 字符来达到指定的总长度，从而使这些字符左对齐。

1.定义

public string PadRight (int totalWidth, char paddingChar);

参数
totalWidth
Int32
结果字符串中的字符数，等于原始字符数加上任何其他填充字符。

paddingChar
Char
Unicode 填充字符。

返回
String
与此实例等效的一个新字符串，但该字符串为左对齐，因此，在右侧填充所需任意数量的 paddingChar 字符，使长度达到 totalWidth。 但是，如果 totalWidth 小于此实例的长度，则此方法返回对现有实例的引用。 如果 totalWidth 等于此实例的长度，则此方法返回与此实例相同的新字符串。

例外
ArgumentOutOfRangeException
totalWidth 小于零。

2.实例

// PadRight(Int32, Char)
namespace ConsoleApp47
{
    internal class Program
    {
        private static void Main(string[] args)
        {
            ArgumentNullException.ThrowIfNull(args);

            string str = "forty-two";
            char pad = '.';

            Console.WriteLine(str.PadRight(15, pad));   // 实例长度不足15用.补足
            Console.WriteLine(str.PadRight(2, pad));    // 实例长度大于2显示实例
        }
    }
}
//运行结果：
/*
forty-two......
forty-two
 */

????????PadRight(Int32, Char) 方法填充返回的字符串的末尾。 这意味着，当与从右向左的语言一起使用时，它会填充字符串的左侧部分。