String.PadLeft String.PadLeft String.PadLeft String.PadLeft Method

Definition

현재 문자열의 시작 부분이 공백이나 지정된 유니코드 문자로 채워지는 지정된 길이의 새 문자열을 반환합니다. Returns a new string of a specified length in which the beginning of the current string is padded with spaces or with a specified Unicode character.

Overloads

PadLeft(Int32) PadLeft(Int32) PadLeft(Int32) PadLeft(Int32)

지정한 길이만큼 왼쪽의 안쪽 여백을 공백으로 채워서 이 인스턴스의 문자를 오른쪽에 맞추는 새 문자열을 반환합니다. Returns a new string that right-aligns the characters in this instance by padding them with spaces on the left, for a specified total length.

PadLeft(Int32, Char) PadLeft(Int32, Char) PadLeft(Int32, Char) PadLeft(Int32, Char)

지정한 길이만큼 왼쪽의 안쪽 여백을 지정된 유니코드 문자로 채워서 이 인스턴스의 문자를 오른쪽에 맞추는 새 문자열을 반환합니다. Returns a new string that right-aligns the characters in this instance by padding them on the left with a specified Unicode character, for a specified total length.

PadLeft(Int32) PadLeft(Int32) PadLeft(Int32) PadLeft(Int32)

지정한 길이만큼 왼쪽의 안쪽 여백을 공백으로 채워서 이 인스턴스의 문자를 오른쪽에 맞추는 새 문자열을 반환합니다. Returns a new string that right-aligns the characters in this instance by padding them with spaces on the left, for a specified total length.

public:
 System::String ^ PadLeft(int totalWidth);
public string PadLeft (int totalWidth);
member this.PadLeft : int -> string
Public Function PadLeft (totalWidth As Integer) As String

매개 변수

totalWidth
Int32 Int32 Int32 Int32

결과 문자열에 있는 문자 수는 원래 문자 수와 추가 안쪽 여백 문자 수를 합한 값과 같습니다. The number of characters in the resulting string, equal to the number of original characters plus any additional padding characters.

Returns

이 인스턴스와 동일하지만 오른쪽으로 맞춰지고 왼쪽의 안쪽 여백이 totalWidth의 길이만큼 공백 문자로 채워진 새 문자열입니다. A new string that is equivalent to this instance, but right-aligned and padded on the left with as many spaces as needed to create a length of totalWidth. 그러나 totalWidth가 이 인스턴스의 길이보다 작을 경우 메서드는 기존 인스턴스에 대한 참조를 반환합니다. However, if totalWidth is less than the length of this instance, the method returns a reference to the existing instance. totalWidth가 이 인스턴스의 길이와 같을 경우 메서드는 이 인스턴스와 동일한 새 문자열을 반환합니다. If totalWidth is equal to the length of this instance, the method returns a new string that is identical to this instance.

Exceptions

Examples

다음 예제는 PadLeft 메서드.The following example demonstrates the PadLeft method.

String^ str = "BBQ and Slaw";
Console::WriteLine( str->PadLeft( 15 ) ); // Displays "   BBQ and Slaw".
Console::WriteLine( str->PadLeft( 5 ) );  // Displays "BBQ and Slaw".
string str = "BBQ and Slaw";
Console.WriteLine(str.PadLeft(15));  // Displays "   BBQ and Slaw".
Console.WriteLine(str.PadLeft(5));   // Displays "BBQ and Slaw".
Dim str As String
str = "BBQ and Slaw"
Console.WriteLine(str.PadLeft(15)) ' Displays "   BBQ and Slaw".
Console.WriteLine(str.PadLeft(5))  ' Displays "BBQ and Slaw".

Remarks

유니코드 공백 문자는 16 진수 0x0020으로 정의 됩니다.A Unicode space is defined as hexadecimal 0x0020.

PadLeft(Int32) 메서드는 반환된 된 문자열의 시작 부분을 채웁니다.The PadLeft(Int32) method pads the beginning of the returned string. 즉, 오른쪽에서 왼쪽 언어를 사용할 때 문자열의 오른쪽 부분을 채웁니다.This means that, when used with right-to-left languages, it pads the right portion of the string.

참고

경우는 PadLeft 메서드 채웁니다 공백 문자를 사용 하 여 현재 인스턴스,이 메서드는 현재 인스턴스의 값을 수정 하지 않습니다.If the PadLeft method pads the current instance with white-space characters, this method does not modify the value of the current instance. 대신, 전체 길이가 되도록 선행 공백을 채운 하는 새 문자열을 반환 합니다 totalWidth 문자입니다.Instead, it returns a new string that is padded with leading white space so that its total length is totalWidth characters.

See Also

PadLeft(Int32, Char) PadLeft(Int32, Char) PadLeft(Int32, Char) PadLeft(Int32, Char)

지정한 길이만큼 왼쪽의 안쪽 여백을 지정된 유니코드 문자로 채워서 이 인스턴스의 문자를 오른쪽에 맞추는 새 문자열을 반환합니다. Returns a new string that right-aligns the characters in this instance by padding them on the left with a specified Unicode character, for a specified total length.

public:
 System::String ^ PadLeft(int totalWidth, char paddingChar);
public string PadLeft (int totalWidth, char paddingChar);
member this.PadLeft : int * char -> string
Public Function PadLeft (totalWidth As Integer, paddingChar As Char) As String

매개 변수

totalWidth
Int32 Int32 Int32 Int32

결과 문자열에 있는 문자 수는 원래 문자 수와 추가 안쪽 여백 문자 수를 합한 값과 같습니다. The number of characters in the resulting string, equal to the number of original characters plus any additional padding characters.

paddingChar
Char Char Char Char

유니코드 안쪽 여백 문자입니다. A Unicode padding character.

Returns

이 인스턴스와 동일하지만 오른쪽으로 맞춰지고 왼쪽의 안쪽 여백이 paddingChar의 길이만큼 totalWidth 문자로 채워진 새 문자열입니다. A new string that is equivalent to this instance, but right-aligned and padded on the left with as many paddingChar characters as needed to create a length of totalWidth. 그러나 totalWidth가 이 인스턴스의 길이보다 작을 경우 메서드는 기존 인스턴스에 대한 참조를 반환합니다. However, if totalWidth is less than the length of this instance, the method returns a reference to the existing instance. totalWidth가 이 인스턴스의 길이와 같을 경우 메서드는 이 인스턴스와 동일한 새 문자열을 반환합니다. If totalWidth is equal to the length of this instance, the method returns a new string that is identical to this instance.

Exceptions

Examples

다음 예제는 PadLeft 메서드.The following example demonstrates the PadLeft method.

using namespace System;

void main()
{
   String^ str = "forty-two";
   Console::WriteLine( str->PadLeft( 15, L'.' ) ); 
   Console::WriteLine( str->PadLeft( 2, L'.' ) ); 
}
// The example displays the following output:
//       ......forty-two
//       forty-two
using System;

class Sample
{
   public static void Main()
   { 
   string str = "forty-two";
   char pad = '.';

   Console.WriteLine(str.PadLeft(15, pad));  
   Console.WriteLine(str.PadLeft(2, pad));  
   }
}
// The example displays the following output:
//       ......forty-two
//       forty-two
Public Class Example
   Public Shared Sub Main()
      Dim str As String
      Dim pad As Char
      str = "forty-two"
      pad = "."c
      Console.WriteLine(str.PadLeft(15, pad)) 
      Console.WriteLine(str.PadLeft(2,  pad))
    End Sub
End Class
' The example displays the following output:
'       ......forty-two
'       forty-two

Remarks

PadLeft(Int32, Char) 메서드는 반환된 된 문자열의 시작 부분을 채웁니다.The PadLeft(Int32, Char) method pads the beginning of the returned string. 즉, 오른쪽에서 왼쪽 언어를 사용할 때 문자열의 오른쪽 부분을 채웁니다.This means that, when used with right-to-left languages, it pads the right portion of the string.

참고

경우는 PadLeft 메서드 채웁니다 공백 문자를 사용 하 여 현재 인스턴스,이 메서드는 현재 인스턴스의 값을 수정 하지 않습니다.If the PadLeft method pads the current instance with white-space characters, this method does not modify the value of the current instance. 대신 최고의 채워집니다 하는 새 문자열을 반환 합니다 paddingChar 자로 전체 길이가 totalWidth 문자입니다.Instead, it returns a new string that is padded with leading paddingChar characters so that its total length is totalWidth characters.

See Also

Applies to