Replace 関数Replace function

指定したサブ文字列が、指定した回数だけ別のサブ文字列に置き換えられている文字列式の、開始位置 (既定値は 1) から始まる文字列式の文字列を返します。Returns a string, which is a substring of a string expression beginning at the start position (defaults to 1), in which a specified substring has been replaced with another substring a specified number of times.

構文Syntax

Replace(findreplace、[ start, [ count, [ compare ]])Replace(expression, find, replace, [ start, [ count, [ compare ]]])


Replace 関数の構文には、次の名前付き引数があります。The Replace function syntax has these named arguments:

パーツPart 説明Description
expressionexpression 必ず指定します。Required. 置換処理を行うサブ文字列が格納されている 文字列式String expression containing substring to replace.
findfind 必須です。Required. 検索するサブ文字列。Substring being searched for.
replacereplace 必須。Required. 置換後の文字列。Replacement substring.
startstart 省略可能。Optional. 検索する_式_のサブ文字列の開始位置を指定します。Start position for the substring of expression to be searched and returned. 省略した場合は、1 が使用されます。If omitted, 1 is assumed.
countcount 省略可能。Optional. 実行するサブ文字列置換の回数。Number of substring substitutions to perform. 省略すると、既定値は-1 になります。これは、すべての可能な置換を行うことを意味します。If omitted, the default value is -1, which means, make all possible substitutions.
comparecompare 省略可能。Optional. サブ文字列を評価するときに使用する比較の種類を示す数値です。Numeric value indicating the kind of comparison to use when evaluating substrings. 値については、「設定」セクションを参照してください。See Settings section for values.

設定Settings

compare 引数には、次の値を指定できます。The compare argument can have the following values:

定数Constant Value 説明Description
vbUseCompareOptionvbUseCompareOption -1-1 Option Compare ステートメントの設定を使用して比較を実行します。Performs a comparison by using the setting of the Option Compare statement.
vbBinaryComparevbBinaryCompare .00 バイナリ比較を実行します。Performs a binary comparison.
vbTextComparevbTextCompare 1-d1 テキスト比較を実行します。Performs a textual comparison.
vbDatabaseComparevbDatabaseCompare pbm-22 Microsoft Access のみ。Microsoft Access only. データベース内の情報に基づいて比較を実行します。Performs a comparison based on information in your database.

戻り値Return values

Replace では次の値が返されます。Replace returns the following values:

条件If Replace の戻り値Replace returns
expression の長さがゼロであるexpression is zero-length 長さがゼロの文字列 ("")。Zero-length string ("")
expressionNull であるexpression is Null エラー。An error.
find の長さがゼロであるfind is zero-length _式_のコピー。Copy of expression.
replace の長さがゼロであるreplace is zero-length すべての_検索_が削除された_式_のコピー。Copy of expression with all occurrences of find removed.
開始 > Len()start > Len(expression) 長さがゼロの文字列。Zero-length string. 文字列の置換は、 _start_で示された位置から開始します。String replacement begins at the position indicated by start.
count が 0 であるcount is 0 _式_のコピー。Copy of expression.

注釈Remarks

Replace関数の戻り値は、置換が行われた文字列で、 _start_で指定した位置から開始し、最後に_式_文字列の末尾を指定します。The return value of the Replace function is a string, with substitutions made, that begins at the position specified by start and concludes at the end of the expression string. 元の文字列の先頭から最後までのコピーではありません。It is not a copy of the original string from start to finish.

関連項目See also

サポートとフィードバックSupport and feedback

Office VBA またはこの説明書に関するご質問やフィードバックがありますか?Have questions or feedback about Office VBA or this documentation? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.