Regex.Unescape(String) メソッド

定義

入力文字列内に含まれるエスケープされた文字を変換します。Converts any escaped characters in the input string.

public:
 static System::String ^ Unescape(System::String ^ str);
public static string Unescape (string str);
static member Unescape : string -> string
Public Shared Function Unescape (str As String) As String

パラメーター

str
String

変換対象のテキストを含んでいる入力文字列。The input string containing the text to convert.

戻り値

エスケープされた文字を含む文字列を、エスケープされていない形式に変換したもの。A string of characters with any escaped characters converted to their unescaped form.

例外

str には、認識されないエスケープ シーケンスが含まれています。str includes an unrecognized escape sequence.

strnull です。str is null.

注釈

Unescape メソッドは、次の2つの変換のいずれかを実行します。The Unescape method performs one of the following two transformations:

  • メソッドによってエスケープされた各文字からエスケープ文字 ("\") を削除することによって、Escape メソッドによって実行される変換を反転します。It reverses the transformation performed by the Escape method by removing the escape character ("\") from each character escaped by the method. これには、\、*、+、? |、、{、[、(、)、^、$、.、#、および空白文字が含まれます。These include the \, *, +, ?, |, {, [, (,), ^, $, ., #, and white space characters. さらに、Unescape メソッドは、右角かっこ (]) と右中かっこ (}) の文字を unescapes します。In addition, the Unescape method unescapes the closing bracket (]) and closing brace (}) characters.

注意

エスケープされた文字を正確に推測できないため、エスケープされた文字列を完全に反転することは Unescape ません。Unescape cannot reverse an escaped string perfectly because it cannot deduce precisely which characters were escaped,

  • 逐語的文字列リテラルの16進数値を実際の印刷可能な文字に置き換えます。It replaces the hexadecimal values in verbatim string literals with the actual printable characters. たとえば、@"\x07" を "\a" に置き換えるか、"\n" に @"\x0A" します。For example, it replaces @"\x07" with "\a", or @"\x0A" with "\n". これは、\a、\b、\e、\n、\r、\f、\t、\ v、英数字など、サポートされているエスケープ文字に変換されます。It converts to supported escape characters such as \a, \b, \e, \n, \r, \f, \t, \v, and alphanumeric characters.

Unescape メソッドで、変換できない他のエスケープシーケンス (\w や \s など) が検出されると、ArgumentExceptionがスローされます。If the Unescape method encounters other escape sequences that it cannot convert, such as \w or \s, it throws an ArgumentException.

適用対象

こちらもご覧ください