String::PadRight Method (Int32)

 

Returns a new string that left-aligns the characters in this string by padding them with spaces on the right, for a specified total length.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public:
String^ PadRight(
	int totalWidth
)

Parameters

totalWidth
Type: System::Int32

The number of characters in the resulting string, equal to the number of original characters plus any additional padding characters.

Return Value

Type: System::String^

A new string that is equivalent to this instance, but left-aligned and padded on the right with as many spaces as needed to create a length of totalWidth. However, if totalWidth is less than the length of this instance, the method returns a reference to the existing instance. If totalWidth is equal to the length of this instance, the method returns a new string that is identical to this instance.

Exception Condition
ArgumentOutOfRangeException

totalWidth is less than zero.

A Unicode space is defined as hexadecimal 0x0020.

The PadRight(Int32) method pads the end of the returned string. This means that, when used with right-to-left languages, it pads the left portion of the string.

System_CAPS_noteNote

If thePadRight method pads the current instance with whitespace characters, this method does not modify the value of the current instance. Instead, it returns a new string that is padded with trailing white space so that its total length is totalWidth characters.

The following example demonstrates the PadRight method.

String^ str = "BBQ and Slaw";
Console::Write( "|" );
Console::Write( str->PadRight( 15 ) );
Console::WriteLine( "|" ); // Displays "|BBQ and Slaw   |".
Console::Write( "|" );
Console::Write( str->PadRight( 5 ) );
Console::WriteLine( "|" ); // Displays "|BBQ and Slaw|".

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: