String.PadLeft

.NET Framework クラス ライブラリ リファレンス

String.PadLeft メソッド (Int32)

このインスタンス内の文字を右寄せし、指定した文字列の文字数になるまで、左側に空白を埋め込みます。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Function PadLeft ( _
    totalWidth As Integer _
) As String

Visual Basic (使用法)

Dim instance As String
Dim totalWidth As Integer
Dim returnValue As String

returnValue = instance.PadLeft(totalWidth)

C#

public string PadLeft (
    int totalWidth
)

C++

public:
String^ PadLeft (
    int totalWidth
)

J#

public String PadLeft (
    int totalWidth
)

JScript

public function PadLeft (
    totalWidth : int
) : String

パラメータ

totalWidth

結果として生成される文字列の文字数。これは、元の文字数と、埋め込み文字がある場合はその数を加えた数に等しくなります。

戻り値
このインスタンスと等価な新しい String。この新しいインスタンスでは文字が右寄せされ、totalWidth の長さになるまで左側に空白が埋め込まれています。または、totalWidth がこのインスタンスの長さより短い場合は、このインスタンスと等しい新しい String オブジェクト。

例外

例外の種類	条件
ArgumentException	totalWidth が 0 未満です。

解説

Unicode の空白文字は、16 進数で 0x20 と定義されています。

使用例

PadLeft メソッドのコード例を次に示します。

Visual Basic

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".

C++

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

JScript

var str : String;
str = "BBQ and Slaw";
Console.WriteLine(str.PadLeft(15)); // Displays "   BBQ and Slaw".
Console.WriteLine(str.PadLeft(5));  // Displays "BBQ and Slaw".

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
String クラス
String メンバ
System 名前空間
Int32 構造体
PadRight
Trim

String.PadLeft メソッド (Int32, Char)

このインスタンス内の文字を右寄せし、指定した文字列の文字数になるまで、指定した Unicode 文字を左側に埋め込みます。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Function PadLeft ( _
    totalWidth As Integer, _
    paddingChar As Char _
) As String

Visual Basic (使用法)

Dim instance As String
Dim totalWidth As Integer
Dim paddingChar As Char
Dim returnValue As String

returnValue = instance.PadLeft(totalWidth, paddingChar)

C#

public string PadLeft (
    int totalWidth,
    char paddingChar
)

C++

public:
String^ PadLeft (
    int totalWidth, 
    wchar_t paddingChar
)

J#

public String PadLeft (
    int totalWidth, 
    char paddingChar
)

JScript

public function PadLeft (
    totalWidth : int, 
    paddingChar : char
) : String

パラメータ

totalWidth

結果として生成される文字列の文字数。これは、元の文字数と、埋め込み文字がある場合はその数を加えた数に等しくなります。

paddingChar

Unicode 埋め込み文字。

戻り値
このインスタンスと等価な新しい String。この新しいインスタンスでは文字が右寄せされ、totalWidth の長さになるまで左側に paddingChar の文字が埋め込まれています。または、totalWidth がこのインスタンスの長さより短い場合は、このインスタンスと等しい新しい String。

例外

例外の種類	条件
ArgumentException	totalWidth が 0 未満です。

使用例

PadLeft メソッドのコード例を次に示します。

Visual Basic

Dim str As String
Dim pad As Char
str = "forty-two"
pad = "."c
Console.WriteLine(str.PadLeft(15, pad)) ' Displays "......forty-two".
Console.WriteLine(str.PadLeft(2,  pad)) ' Displays "forty-two".

C++

String^ str = "forty-two";
Console::WriteLine( str->PadLeft( 15, L'.' ) ); // Displays "......forty-two".
Console::WriteLine( str->PadLeft( 2, L'.' ) );  // Displays "forty-two".

JScript

var str : String;
var pad : char;
str = "forty-two";
pad = ".";
Console.WriteLine(str.PadLeft(15, pad)) // Displays "......forty-two".
Console.WriteLine(str.PadLeft(2,  pad)) // Displays "forty-two".

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
String クラス
String メンバ
System 名前空間
Char 構造体
Int32 構造体
PadRight
Trim

String.PadLeft メソッド

このインスタンス内の文字を右寄せし、指定した文字列の文字数になるまで、左側に空白または指定した Unicode 文字を埋め込みます。
オーバーロードの一覧

名前	説明
String.PadLeft (Int32)	このインスタンス内の文字を右寄せし、指定した文字列の文字数になるまで、左側に空白を埋め込みます。 .NET Compact Framework によってサポートされています。
String.PadLeft (Int32, Char)	このインスタンス内の文字を右寄せし、指定した文字列の文字数になるまで、指定した Unicode 文字を左側に埋め込みます。 .NET Compact Framework によってサポートされています。

参照

関連項目

String クラス
String メンバ
System 名前空間
Int32 構造体
PadRight
Trim