文字列関数 (Visual Basic)String Functions (Visual Basic)

Visual Basic で文字列の検索と操作のために用意されている関数の一覧を次の表に示します。The following table lists the functions that Visual Basic provides to search and manipulate strings.

.NET Framework メソッド.NET Framework method 説明Description
Asc, AscWAsc, AscW 文字に対応する文字コードを表す Integer 値を返します。Returns an Integer value representing the character code corresponding to a character.
Chr, ChrWChr, ChrW 指定された文字コードに対応する文字を返します。Returns the character associated with the specified character code.
Filter 指定されたフィルター条件に基づいた文字列 (String) 配列のサブセットを含むゼロ ベースの配列を返します。Returns a zero-based array containing a subset of a String array based on specified filter criteria.
Format 書式指定文字列 (String) 式に含まれる指示に従って書式設定された文字列を返します。Returns a string formatted according to instructions contained in a format String expression.
FormatCurrency システムの [コントロール パネル] で定義されている通貨記号を使って通貨形式の文字列に書式設定して返す文字列処理関数です。Returns an expression formatted as a currency value using the currency symbol defined in the system control panel.
FormatDateTime 日時の値を表す文字列式を返します。Returns a string expression representing a date/time value.
FormatNumber 数値形式の文字列に書式設定して返す文字列処理関数です。Returns an expression formatted as a number.
FormatPercent パーセント記号 (%) が付加されたパーセント形式 (100 で乗算した) の文字列に書式設定して返す文字列処理関数です。Returns an expression formatted as a percentage (that is, multiplied by 100) with a trailing % character.
InStr ある文字列の中から指定した文字列を検索し、最初に見つかった文字列の開始位置を示す整数型の値を返します。Returns an integer specifying the start position of the first occurrence of one string within another.
InStrRev ある文字列の中から指定された文字列を最後の文字位置から検索を開始し、最初に見つかった文字位置 (先頭からその位置までの文字数) を返します。Returns the position of the first occurrence of one string within another, starting from the right side of the string.
Join 配列に含まれる多数の部分文字列を結合して作成される文字列を返します。Returns a string created by joining a number of substrings contained in an array.
LCase 小文字に変換した文字列または文字を返します。Returns a string or character converted to lowercase.
Left 指定された文字数を含む文字列を返します。Returns a string containing a specified number of characters from the left side of a string.
Len 文字列内の文字数を含む整数を返します。Returns an integer that contains the number of characters in a string.
LSet 指定の文字列が含まれている文字列を左寄せで指定の長さに調整して返します。Returns a left-aligned string containing the specified string adjusted to the specified length.
LTrim 指定された文字列から、先頭の空白を除いたコピーを格納する文字列を返します。Returns a string containing a copy of a specified string with no leading spaces.
Mid 文字列から指定された文字数分の文字列を返します。Returns a string containing a specified number of characters from a string.
Replace 指定された文字列の一部を指定された回数分別の部分文字列で置換した文字列を返します。Returns a string in which a specified substring has been replaced with another substring a specified number of times.
Right 文字列の右端から指定された文字数分の文字列を返します。Returns a string containing a specified number of characters from the right side of a string.
RSet 文字列と長さが指定され、その長さに調整された文字列右揃えにして文字列を返します。Returns a right-aligned string containing the specified string adjusted to the specified length.
RTrim 指定された文字列から、末尾の空白を除いたコピーを格納する文字列を返します。Returns a string containing a copy of a specified string with no trailing spaces.
Space 指定された数のスペースから成る文字列を返します。Returns a string consisting of the specified number of spaces.
Split 部分文字列ごとに区切られた文字列からゼロ ベースの 1 次元配列を作成し、返します。Returns a zero-based, one-dimensional array containing a specified number of substrings.
StrComp 文字列比較の結果により、-1、0、または 1 のいずれかを返します。Returns -1, 0, or 1, based on the result of a string comparison.
StrConv 指定に従って変換された文字列型の値を返します。Returns a string converted as specified.
StrDup 指定された文字が指定された回数繰り返されている文字列型またはオブジェクト型の値を返します。Returns a string or object consisting of the specified character repeated the specified number of times.
StrReverse 指定された文字列の文字の並び順を逆にした文字列を返します。Returns a string in which the character order of a specified string is reversed.
Trim 指定された文字列から、先頭または末尾の空白を除いたコピーを格納する文字列を返します。Returns a string containing a copy of a specified string with no leading or trailing spaces.
UCase 指定された文字列を大文字に変換して文字列型または char 型の値を返します。Returns a string or character containing the specified string converted to uppercase.

使用することができます、 Option Compare文字列の大文字のテキストを使用して比較するかどうかを設定するステートメントの並べ替え順序は、システムのロケールによって決まります (Text) または文字 (の内部バイナリ表現Binary).You can use the Option Compare statement to set whether strings are compared using a case-insensitive text sort order determined by your system's locale (Text) or by the internal binary representations of the characters (Binary). 既定のテキスト比較方法は Binary です。The default text comparison method is Binary.

Example

UCase 関数を使って文字列を大文字に変換して返す例を次に示します。This example uses the UCase function to return an uppercase version of a string.

' String to convert.
Dim lowerCase As String = "Hello World 1234"
' Returns "HELLO WORLD 1234".
Dim upperCase As String = UCase(lowerCase)

Example

この例では、文字列変数から、LTrim 関数を使って先頭の空白を除去し、RTrim 関数を使って後続の空白を除去しています。This example uses the LTrim function to strip leading spaces and the RTrim function to strip trailing spaces from a string variable. また、Trim 関数を使って両方のタイプの空白を除去しています。It uses the Trim function to strip both types of spaces.

' Initializes string.
Dim testString As String = "  <-Trim->  "
Dim trimString As String
' Returns "<-Trim->  ".
trimString = LTrim(testString)
' Returns "  <-Trim->".
trimString = RTrim(testString)
' Returns "<-Trim->".
trimString = LTrim(RTrim(testString))
' Using the Trim function alone achieves the same result.
' Returns "<-Trim->".
trimString = Trim(testString)

Example

Mid 関数を使って、文字列から指定された字数を返す例を次に示します。This example uses the Mid function to return a specified number of characters from a string.

' Creates text string.
Dim testString As String = "Mid Function Demo"
' Returns "Mid".
Dim firstWord As String = Mid(testString, 1, 3)
' Returns "Demo".
Dim lastWord As String = Mid(testString, 14, 4)
' Returns "Function Demo".
Dim midWords As String = Mid(testString, 5)

Example

Len 関数を使って文字列の文字数を返す例を次に示します。This example uses Len to return the number of characters in a string.

' Initializes variable.
Dim testString As String = "Hello World"
' Returns 11.
Dim testLen As Integer = Len(testString)

Example

InStr 関数を使って、ある文字列の中から指定された文字列を検索し、最初に見つかった文字位置を返す例を次に示します。This example uses the InStr function to return the position of the first occurrence of one string within another.

' String to search in.
Dim searchString As String = "XXpXXpXXPXXP"
' Search for "P".
Dim searchChar As String = "P"

Dim testPos As Integer
' A textual comparison starting at position 4. Returns 6.
testPos = InStr(4, searchString, searchChar, CompareMethod.Text)

' A binary comparison starting at position 1. Returns 9.
testPos = InStr(1, SearchString, SearchChar, CompareMethod.Binary)

' If Option Compare is not set, or set to Binary, return 9.
' If Option Compare is set to Text, returns 3.
testPos = InStr(searchString, searchChar)

' Returns 0.
testPos = InStr(1, searchString, "W")

Example

Format の書式指定とユーザー定義の書式指定の両方を使って値の書式を指定する、String 関数のさまざまな使用例を次に示します。This example shows various uses of the Format function to format values using both String formats and user-defined formats. 日付の区切り記号 (/)、時刻の区切り記号 (:)、および午前/午後を示す文字 (t および tt) について、システムで実際に表示される書式は、コードが使用するロケール設定によって決まります。For the date separator (/), time separator (:), and the AM/PM indicators (t and tt), the actual formatted output displayed by your system depends on the locale settings the code is using. 時刻と日付を開発環境で表示する場合は、コード ロケールの短い時刻書式と短い日付書式が使用されます。When times and dates are displayed in the development environment, the short time format and short date format of the code locale are used.

注意

24 時間制を使用するロケールでは、午前/午後を示す記号 (t および tt) では何も表示されません。For locales that use a 24-hour clock, the AM/PM indicators (t and tt) display nothing.

Dim testDateTime As Date = #1/27/2001 5:04:23 PM#
Dim testStr As String
' Returns current system time in the system-defined long time format.
testStr = Format(Now(), "Long Time")
' Returns current system date in the system-defined long date format.
testStr = Format(Now(), "Long Date")
' Also returns current system date in the system-defined long date 
' format, using the single letter code for the format.
testStr = Format(Now(), "D")

' Returns the value of testDateTime in user-defined date/time formats.
' Returns "5:4:23".
testStr = Format(testDateTime, "h:m:s")
' Returns "05:04:23 PM".
testStr = Format(testDateTime, "hh:mm:ss tt")
' Returns "Saturday, Jan 27 2001".
testStr = Format(testDateTime, "dddd, MMM d yyyy")
' Returns "17:04:23".
testStr = Format(testDateTime, "HH:mm:ss")
' Returns "23".
testStr = Format(23)

' User-defined numeric formats.
' Returns "5,459.40".
testStr = Format(5459.4, "##,##0.00")
' Returns "334.90".
testStr = Format(334.9, "###0.00")
' Returns "500.00%".
testStr = Format(5, "0.00%")

関連項目See also