Strings.Left メソッド

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

Strings.Left メソッド

指定された文字数を含む文字列を返します。

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Function Left
 ( _
    str As String, _
    Length As Integer _
) As String

Visual Basic (使用法)

Dim str As String
Dim Length As Integer
Dim returnValue As String

returnValue = Strings.Left(str, Length)

C#

public static string Left
 (
    string str,
    int Length
)

C++

public:
static String^ Left (
    String^ str, 
    int Length
)

J#

public static String Left (
    String str, 
    int Length
)

JScript

public static function Left
 (
    str : String, 
    Length : int
) : String

パラメータ

str

必須。左端の文字が返される String 型の式。

Length

必須。Integer 型の式。返す文字の数を示す数式。0 を指定すると、長さ 0 の文字列 ("") が返されます。str 内の文字数以上を指定すると、文字列全体が返されます。

戻り値
指定された文字数を含む文字列を返します。

解説

詳細については、Visual Basic のトピック「Left 関数 (Visual Basic)」を参照してください。

str 内の文字数を決定するには、Len 関数を使用します。Windows フォーム アプリケーションや、Left プロパティを持つ他のクラスで使用する場合は、Microsoft.VisualBasic.Left によって関数を完全修飾する必要があります。

メモ
以前のバージョンの Visual Basic の LeftB 関数は、文字列内の文字数ではなくバイト数を返します。これは主に、2 バイト文字セット (DBCS) アプリケーションで文字列を変換する目的で使用されます。現在のすべての Visual Basic 文字列は Unicode であり、 LeftB はサポートされていません。

使用例

この例では、Left 関数を使用して、指定の String の部分文字列を返しています。Left プロパティを持つクラスでは、Left 関数の完全修飾が必要になる場合があります。

Visual Basic

Dim TestString As String
 = "Hello World!"
' Returns "Hello".
Dim subString As String
 = Microsoft.VisualBasic.Left(TestString, 5)

プラットフォーム

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

参照

関連項目
Strings クラス
Strings メンバ
Microsoft.VisualBasic 名前空間
ArgumentException
その他の技術情報
Left 関数 (Visual Basic)
文字列操作の概要
Right 関数 (Visual Basic)
Len 関数 (Visual Basic)
Mid 関数 (Visual Basic)
プログラミング要素のサポートに関する変更の概要