StringBuilder.Replace 메서드

정의

네임스페이스:

System.Text

어셈블리:

System.Runtime.dll

이 인스턴스에서 발견되는 지정된 문자 또는 문자열을 지정된 다른 문자 또는 문자열로 모두 바꿉니다.

오버로드

Replace(Char, Char)	이 인스턴스에서 발견되는 지정된 문자를 지정된 다른 문자로 모두 바꿉니다.
Replace(String, String)	이 인스턴스에서 발견되는 지정된 문자열을 지정된 다른 문자열로 모두 바꿉니다.
Replace(Char, Char, Int32, Int32)	이 인스턴스의 부분 문자열에서 발견되는 지정된 문자를 지정된 다른 문자로 모두 바꿉니다.
Replace(String, String, Int32, Int32)	이 인스턴스의 부분 문자열에서 발견되는 지정된 문자열을 지정된 다른 문자열로 모두 바꿉니다.

예제

다음 예제는 Replace 메서드.

using namespace System;
using namespace System::Text;
void Show( StringBuilder^ sbs )
{
   String^ rule1 = "0----+----1----+----2----+----3----+----4---";
   String^ rule2 = "01234567890123456789012345678901234567890123";
   Console::WriteLine( rule1 );
   Console::WriteLine( rule2 );
   Console::WriteLine( "{0}", sbs );
   Console::WriteLine();
}

int main()
{
   
   //                  0----+----1----+----2----+----3----+----4---
   //                  01234567890123456789012345678901234567890123
   String^ str = "The quick br!wn d#g jumps #ver the lazy cat.";
   StringBuilder^ sb = gcnew StringBuilder( str );
   Console::WriteLine();
   Console::WriteLine( "StringBuilder.Replace method" );
   Console::WriteLine();
   Console::WriteLine( "Original value:" );
   Show( sb );
   sb->Replace( '#', '!', 15, 29 ); // Some '#' -> '!'
   Show( sb );
   sb->Replace( '!', 'o' ); // All '!' -> 'o'
   Show( sb );
   sb->Replace( "cat", "dog" ); // All "cat" -> "dog"
   Show( sb );
   sb->Replace( "dog", "fox", 15, 20 ); // Some "dog" -> "fox"
   Console::WriteLine( "Final value:" );
   Show( sb );
}

/*
This example produces the following results:

StringBuilder.Replace method

Original value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick br!wn d#g jumps #ver the lazy cat.

0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick br!wn d!g jumps !ver the lazy cat.

0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown dog jumps over the lazy cat.

0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown dog jumps over the lazy dog.

Final value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown fox jumps over the lazy dog.

*/

using System;
using System.Text;

class Sample
{
    public static void Main()
    {
//                0----+----1----+----2----+----3----+----4---
//                01234567890123456789012345678901234567890123
    string str = "The quick br!wn d#g jumps #ver the lazy cat.";
    StringBuilder sb = new StringBuilder(str);

    Console.WriteLine();
    Console.WriteLine("StringBuilder.Replace method");
    Console.WriteLine();

    Console.WriteLine("Original value:");
    Show(sb);

    sb.Replace('#', '!', 15, 29);        // Some '#' -> '!'
    Show(sb);
    sb.Replace('!', 'o');                // All '!' -> 'o'
    Show(sb);
    sb.Replace("cat", "dog");            // All "cat" -> "dog"
    Show(sb);
    sb.Replace("dog", "fox", 15, 20);    // Some "dog" -> "fox"

    Console.WriteLine("Final value:");
    Show(sb);
    }

    public static void Show(StringBuilder sbs)
    {
    string rule1 = "0----+----1----+----2----+----3----+----4---";
    string rule2 = "01234567890123456789012345678901234567890123";

    Console.WriteLine(rule1);
    Console.WriteLine(rule2);
    Console.WriteLine("{0}", sbs.ToString());
    Console.WriteLine();
    }
}
/*
This example produces the following results:

StringBuilder.Replace method

Original value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick br!wn d#g jumps #ver the lazy cat.

0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick br!wn d!g jumps !ver the lazy cat.

0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown dog jumps over the lazy cat.

0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown dog jumps over the lazy dog.

Final value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown fox jumps over the lazy dog.

*/

open System.Text

let show (sbs: StringBuilder) =
    let rule1 = "0----+----1----+----2----+----3----+----4---"
    let rule2 = "01234567890123456789012345678901234567890123"
    printfn $"{rule1}\n{rule2}\n{sbs}\n"

//         0----+----1----+----2----+----3----+----4---
//         01234567890123456789012345678901234567890123
let str = "The quick br!wn d#g jumps #ver the lazy cat."
let sb = StringBuilder str

printfn "StringBuilder.Replace method\n"

printfn "Original value:"
show sb

sb.Replace('#', '!', 15, 29) |> ignore // Some '#' -> '!'
show sb
sb.Replace('!', 'o') |> ignore // All '!' -> 'o'
show sb
sb.Replace("cat", "dog") |> ignore // All "cat" -> "dog"
show sb
sb.Replace("dog", "fox", 15, 20) |> ignore // Some "dog" -> "fox"

printfn "Final value:"
show sb

// This example produces the following results:
//       StringBuilder.Replace method
//
//       Original value:
//       0----+----1----+----2----+----3----+----4---
//       01234567890123456789012345678901234567890123
//       The quick br!wn d#g jumps #ver the lazy cat.
//
//       0----+----1----+----2----+----3----+----4---
//       01234567890123456789012345678901234567890123
//       The quick br!wn d!g jumps !ver the lazy cat.
//
//       0----+----1----+----2----+----3----+----4---
//       01234567890123456789012345678901234567890123
//       The quick brown dog jumps over the lazy cat.
//
//       0----+----1----+----2----+----3----+----4---
//       01234567890123456789012345678901234567890123
//       The quick brown dog jumps over the lazy dog.
//
//       Final value:
//       0----+----1----+----2----+----3----+----4---
//       01234567890123456789012345678901234567890123
//       The quick brown fox jumps over the lazy dog.

Imports System.Text

Class Sample
   Public Shared Sub Main()
      '                    0----+----1----+----2----+----3----+----4---
      '                    01234567890123456789012345678901234567890123
      Dim str As String = "The quick br!wn d#g jumps #ver the lazy cat."
      Dim sb As New StringBuilder(str)
      
      Console.WriteLine()
      Console.WriteLine("StringBuilder.Replace method")
      Console.WriteLine()
      
      Console.WriteLine("Original value:")
      Show(sb)
      
      sb.Replace("#"c, "!"c, 15, 29)   ' Some '#' -> '!'
      Show(sb)
      sb.Replace("!"c, "o"c)           ' All '!' -> 'o'
      Show(sb)
      sb.Replace("cat", "dog")         ' All "cat" -> "dog"
      Show(sb)
      sb.Replace("dog", "fox", 15, 20) ' Some "dog" -> "fox"
      Console.WriteLine("Final value:")
      Show(sb)
   End Sub
   
   Public Shared Sub Show(sbs As StringBuilder)
      Dim rule1 As String = "0----+----1----+----2----+----3----+----4---"
      Dim rule2 As String = "01234567890123456789012345678901234567890123"
      
      Console.WriteLine(rule1)
      Console.WriteLine(rule2)
      Console.WriteLine("{0}", sbs.ToString())
      Console.WriteLine()
   End Sub
End Class
'
'This example produces the following results:
'
'StringBuilder.Replace method
'
'Original value:
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick br!wn d#g jumps #ver the lazy cat.
'
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick br!wn d!g jumps !ver the lazy cat.
'
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick brown dog jumps over the lazy cat.
'
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick brown dog jumps over the lazy dog.
'
'Final value:
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick brown fox jumps over the lazy dog.
'

Replace(Char, Char)

Source:

StringBuilder.cs

이 인스턴스에서 발견되는 지정된 문자를 지정된 다른 문자로 모두 바꿉니다.

public:
 System::Text::StringBuilder ^ Replace(char oldChar, char newChar);

public System.Text.StringBuilder Replace (char oldChar, char newChar);

member this.Replace : char * char -> System.Text.StringBuilder

Public Function Replace (oldChar As Char, newChar As Char) As StringBuilder

매개 변수

oldChar

Char

바꿀 문자입니다.

newChar

Char

oldChar를 바꾸는 문자입니다.

반환

StringBuilder

oldChar가 newChar로 바뀐 이 인스턴스에 대한 참조입니다.

설명

이 메서드는 현재 instance 발생을 식별하기 위해 대/소문자를 구분하는 서수 비교를 수행합니다oldChar. 현재 StringBuilder instance 크기는 교체 후 변경되지 않습니다.

Replace(String, String)

Source:

StringBuilder.cs

이 인스턴스에서 발견되는 지정된 문자열을 지정된 다른 문자열로 모두 바꿉니다.

public:
 System::Text::StringBuilder ^ Replace(System::String ^ oldValue, System::String ^ newValue);

public System.Text.StringBuilder Replace (string oldValue, string? newValue);

member this.Replace : string * string -> System.Text.StringBuilder

Public Function Replace (oldValue As String, newValue As String) As StringBuilder

매개 변수

oldValue

String

바꿀 문자열입니다.

newValue

String

oldValue를 바꾸는 문자열이거나 null입니다.

반환

StringBuilder

oldValue의 모든 인스턴스가 newValue로 바뀐 이 인스턴스에 대한 참조입니다.

예외

ArgumentNullException

oldValue이(가) null인 경우

ArgumentException

oldValue의 길이가 0입니다.

ArgumentOutOfRangeException

이 인스턴스의 값이 커지면 MaxCapacity가 초과됩니다.

설명

이 메서드는 현재 instance 발생을 식별하기 위해 대/소문자를 구분하는 서수 비교를 수행합니다oldValue. 가 null 또는 String.Empty이면 newValue 의 oldValue 모든 항목이 제거됩니다.

추가 정보

• Remove(Int32, Int32)

Replace(Char, Char, Int32, Int32)

Source:

StringBuilder.cs

이 인스턴스의 부분 문자열에서 발견되는 지정된 문자를 지정된 다른 문자로 모두 바꿉니다.

public:
 System::Text::StringBuilder ^ Replace(char oldChar, char newChar, int startIndex, int count);

public System.Text.StringBuilder Replace (char oldChar, char newChar, int startIndex, int count);

member this.Replace : char * char * int * int -> System.Text.StringBuilder

Public Function Replace (oldChar As Char, newChar As Char, startIndex As Integer, count As Integer) As StringBuilder

매개 변수

oldChar

Char

바꿀 문자입니다.

newChar

Char

oldChar를 바꾸는 문자입니다.

startIndex

Int32

부분 문자열이 시작되는 인스턴스 내의 위치입니다.

count

Int32

부분 문자열의 길이입니다.

반환

StringBuilder

oldChar가 startIndex에서부터 startIndex + count -1의 범위에 있는 newChar로 바뀐 이 인스턴스에 대한 참조입니다.

예외

ArgumentOutOfRangeException

startIndex + count가 이 인스턴스의 길이보다 큽니다.

또는

startIndex 또는 count가 0보다 작습니다.

설명

이 메서드는 현재 instance 발생을 식별하기 위해 대/소문자를 구분하는 서수 비교를 수행합니다oldChar. 현재 StringBuilder 개체의 크기는 교체 후 변경되지 않습니다.

Replace(String, String, Int32, Int32)

Source:

StringBuilder.cs

이 인스턴스의 부분 문자열에서 발견되는 지정된 문자열을 지정된 다른 문자열로 모두 바꿉니다.

public:
 System::Text::StringBuilder ^ Replace(System::String ^ oldValue, System::String ^ newValue, int startIndex, int count);

public System.Text.StringBuilder Replace (string oldValue, string? newValue, int startIndex, int count);

member this.Replace : string * string * int * int -> System.Text.StringBuilder

Public Function Replace (oldValue As String, newValue As String, startIndex As Integer, count As Integer) As StringBuilder

매개 변수

oldValue

String

바꿀 문자열입니다.

newValue

String

oldValue를 바꾸는 문자열이거나 null입니다.

startIndex

Int32

부분 문자열이 시작되는 인스턴스 내의 위치입니다.

count

Int32

부분 문자열의 길이입니다.

반환

StringBuilder

oldValue의 모든 인스턴스가 startIndex에서 startIndex + count - 1 범위에 있는 newValue로 바뀐 이 인스턴스에 대한 참조입니다.

예외

ArgumentNullException

oldValue이(가) null인 경우

ArgumentException

oldValue의 길이가 0입니다.

ArgumentOutOfRangeException

startIndex 또는 count가 0보다 작습니다.

또는

startIndex + count는 문자 위치가 이 인스턴스 안에 없음을 나타냅니다.

또는

이 인스턴스의 값이 커지면 MaxCapacity가 초과됩니다.

설명

이 메서드는 지정된 부분 문자열에서 의 oldValue 발생을 식별하기 위해 대/소문자를 구분하는 서수 비교를 수행합니다. 가 null 또는 String.Empty이면 newValue 의 oldValue 모든 항목이 제거됩니다.

추가 정보

• Remove(Int32, Int32)