InStr 함수(Visual Basic)

업데이트: 2007년 11월

한 문자열에서 다른 문자열이 처음으로 나타나는 위치를 지정하는 정수를 반환합니다.

Public Shared Function InStr(_
   ByVal String1 As String, _
   ByVal String2 As String, _
   Optional ByVal Compare As CompareMethod _
) As Integer
' -or-
Public Shared Function InStr(_
   ByVal Start As Integer, _
   ByVal String1 As String, _
   ByVal String2 As String, _
   Optional ByVal Compare As Microsoft.VisualBasic.CompareMethod _
) As Integer

매개 변수

  • Start
    선택적 요소. 개별 검색을 시작할 위치를 설정하는 숫자 식입니다. 이 인수를 생략하면 첫째 문자 위치에서 검색을 시작합니다. 인덱스는 1부터 시작합니다.

  • String1
    필수적 요소. 검색되는 String 식입니다.

  • String2
    필수적 요소. 검색된 String 식입니다.

  • Compare
    선택적 요소. 문자열 비교의 형식을 지정합니다. Compare를 생략하면 Option Compare 설정에 따라 비교 형식이 결정됩니다.

설정

Compare 인수 설정은 다음과 같습니다.

상수

설명

Binary

0

이진 비교 수행

Text

1

텍스트 비교를 수행합니다.

반환 값

조건

InStr 함수의 반환 값

String1 길이가 0이거나 다음인 경우 Nothing

0

String2 길이가 0이거나 다음인 경우 Nothing

start

String2를 찾지 못한 경우

0

String2 가 다음 안에 있는 경우 String1

일치가 시작되는 위치

Start > String2

0

예외

예외 형식

오류 번호

조건

ArgumentException

5

Start < 1.

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

설명

일반적으로 문자열을 구문 분석할 때는 InStr 함수가 사용됩니다.

참고:

이전 Visual Basic 버전의 InStrB 함수는 문자 위치가 아니라 바이트 수를 반환합니다. 이 함수는 주로 DBCS(더블바이트 문자 집합) 응용 프로그램의 문자열을 변환하는 데 사용됩니다. Visual Basic 2005의 모든 문자열은 유니코드이며 InStrB는 더 이상 지원되지 않습니다.

예제

다음 예제에서는 InStr 함수를 사용하여 한 문자열 안에 다른 문자열이 처음으로 나타나는 위치를 반환합니다.

' 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")

요구 사항

네임스페이스:Microsoft.VisualBasic

**모듈:**Strings

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

참고 항목

개념

프로그래밍 요소 지원 변경 사항 요약

참조

InStrRev 함수(Visual Basic)

Option Compare 문

StrComp 함수(Visual Basic)

ArgumentException

기타 리소스

Visual Basic의 문자열

Visual Basic의 문자열 소개