Replace 함수(Visual Basic)

업데이트: 2007년 11월

지정된 부분 문자열이 지정된 횟수만큼 다른 부분 문자열로 대체된 문자열을 반환합니다.

Public Function Replace(
   ByVal Expression As String,
   ByVal Find As String,
   ByVal Replacement As String,
   Optional ByVal Start As Integer = 1,
   Optional ByVal Count As Integer = -1,
   Optional ByVal Compare As CompareMethod = CompareMethod.Binary
) As String

매개 변수

• Expression
  필수적 요소. 대체할 부분 문자열을 포함하는 문자열 식입니다.

• Find
  필수적 요소. 검색 중인 부분 문자열입니다.

• Replacement
  필수적 요소. 대체 부분 문자열입니다.

• Start
  선택적 요소. 부분 문자열 검색이 시작될 Expression 내의 위치입니다. 생략하면 1로 간주됩니다.

• Count
  선택적 요소. 수행할 부분 문자열 대체 횟수입니다. 이 인수를 생략하면 기본값으로 –1이 사용됩니다. 이것은 가능한 모든 항목이 대체됨을 의미합니다.

• Compare
  선택적 요소. 부분 문자열을 평가할 때 사용할 비교 종류를 나타내는 숫자 값입니다. 값에 대해서는 설정을 참조하십시오.

설정

Compare 인수 값은 다음과 같습니다.

상수	설명
Binary	이진 비교 수행
Text	텍스트 비교 수행

반환 값

Replace는 다음과 같은 값을 반환합니다.

조건	반환 값
Find가 0이거나 Nothing인 경우	Expression의 복사본
Replace가 0인 경우	Find가 포함되지 않는 Expression의 복사본
Expression이 0이거나 Nothing이거나, Start가 Expression보다 긴 경우	Nothing
Count가 0인 경우	Expression의 복사본

예외

예외 형식	오류 번호	조건
ArgumentException	5	Count가 –1보다 작거나 Start가 0보다 작거나 같습니다.

비구조적 오류 처리를 사용하는 Visual Basic 6.0 응용 프로그램을 업그레이드하는 경우에는 "오류 번호" 열을 참조하십시오. 오류 번호를 Number 속성(Err 개체)과 비교할 수 있습니다. 그러나 가능하면 이러한 오류 제어 방법을 Visual Basic의 구조적 예외 처리 개요에 설명된 방식으로 바꾸는 것이 좋습니다.

설명

Replace 함수의 반환 값은 Start로 지정한 위치에서 시작되며 Find 및 Replace 값으로 지정한 대로 항목이 대체되어 Expression 문자열의 끝에서 종료되는 문자열입니다.

예제

다음 예제에서는 Replace 함수를 보여 줍니다.

Dim TestString As String = "Shopping List"
' Returns "Shipping List".
Dim aString As String = Replace(TestString, "o", "i")

요구 사항

네임스페이스:Microsoft.VisualBasic

**모듈:**Strings

**어셈블리:**Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)

참고 항목

참조

문자열 조작 요약

Filter 함수(Visual Basic)

ArgumentException