contains

string형에 패턴이 있는지 확인

구문

TF = contains(str,pat)

TF = contains(str,pat,'IgnoreCase',true)

설명

str에 지정된 패턴이 포함된 경우 TF = contains(str,pat)는 1(true)을 반환하고, 그렇지 않을 경우 0(false)을 반환합니다.

pat가 여러 패턴이 포함된 배열인 경우 contains는 str에서 pat의 요소를 찾으면 1을 반환합니다.

str이 string형 배열 또는 셀형 배열인 경우 TF는 str과 동일한 크기를 가지는 논리형 배열이 됩니다.

TF = contains(str,pat,'IgnoreCase',true)는 str에 pat가 포함되어 있는지 여부를 확인할 때 대/소문자를 무시합니다.

예제

텍스트 찾기

이름으로 구성된 string형 배열을 만듭니다. 일부 이름에는 Paul이 있습니다.

큰따옴표를 사용하여 string형을 생성할 수 있습니다.

str = ["Mary Ann Jones","Paul Jay Burns","John Paul Smith"]

str = 1×3 string
    "Mary Ann Jones"    "Paul Jay Burns"    "John Paul Smith"

값이 1인 요소의 위치가 str에서 Paul이 포함된 문자열의 위치에 대응하는 논리형 배열을 반환합니다.

pat = "Paul";
TF = contains(str,pat)

TF = 1×3 logical array

   0   1   1

Paul이 포함된 문자열을 표시합니다. TF를 사용하여 str로 다시 인덱싱합니다.

str(TF)

ans = 1×2 string
    "Paul Jay Burns"    "John Paul Smith"

패턴을 사용하여 검색하기

R2020b 이후

주소가 포함된 string형 배열을 만듭니다.

str = ["221B Baker St.","Tour Eiffel Champ de Mars","4059 Mt Lee Dr."]

str = 1×3 string
    "221B Baker St."    "Tour Eiffel Champ de Mars"    "4059 Mt Lee Dr."

숫자를 포함하는 주소를 찾으려면 digitsPattern 함수를 사용하여 임의 개수의 숫자와 일치하는 패턴을 만드십시오.

pat = digitsPattern

pat = pattern
  Matching:

    digitsPattern

숫자를 포함하는 문자열을 나타내는 논리형 배열을 반환합니다. 일치하는 문자열을 표시합니다.

TF = contains(str,pat)

TF = 1×3 logical array

   1   0   1

str(TF)

ans = 1×2 string
    "221B Baker St."    "4059 Mt Lee Dr."

숫자 시퀀스 뒤에 문자 하나가 오는 문자열을 검색합니다. 단순한 패턴을 결합하여 더 복잡한 패턴을 만들 수 있습니다.

pat = digitsPattern + lettersPattern(1)

pat = pattern
  Matching:

    digitsPattern + lettersPattern(1)

TF = contains(str,pat);
str(TF)

ans = 
"221B Baker St."

pattern 객체를 만드는 함수 목록은 pattern 항목을 참조하십시오.

목록에 있는 임의 텍스트 중에 일치하는 텍스트가 있는지 확인하기

이름으로 구성된 string형 배열을 만듭니다. 일부 이름에는 Ann 또는 Paul이 있습니다.

str = ["Mary Ann Jones","Christopher Matthew Burns","John Paul Smith"]

str = 1×3 string
    "Mary Ann Jones"    "Christopher Matthew Burns"    "John Paul Smith"

Ann 또는 Paul을 포함하는 str의 요소를 찾습니다.

pat = ["Ann","Paul"];
TF = contains(str,pat)

TF = 1×3 logical array

   1   0   1

TF를 사용하여 str로 다시 인덱싱합니다.

str(TF)

ans = 1×2 string
    "Mary Ann Jones"    "John Paul Smith"

대/소문자 무시하기

이름이 포함된 string형 배열을 만듭니다. 대/소문자를 무시한 상태에서 어떤 이름에 anne이 포함되어 있는지 확인합니다.

큰따옴표를 사용하여 string형을 생성할 수 있습니다.

str = ["Anne","Elizabeth","Marianne","Tracy"]

str = 1×4 string
    "Anne"    "Elizabeth"    "Marianne"    "Tracy"

pat = "anne";
TF = contains(str,pat,'IgnoreCase',true)

TF = 1×4 logical array

   1   0   1   0

anne이 포함된 문자열을 표시합니다. TF를 사용하여 str로 다시 인덱싱합니다.

str(TF)

ans = 1×2 string
    "Anne"    "Marianne"

문자형 벡터에 부분문자열이 포함되어 있는지 확인하기

음식 목록이 포함된 문자형 벡터를 만듭니다. 다른 음식 이름이 문자형 벡터에 있는지 확인합니다.

chr = 'peppers, onions, and mushrooms';
TF = contains(chr,'onion')

TF = logical
   1

TF = contains(chr,'pineapples')

TF = logical
   0

입력 인수

str — 입력 텍스트

string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열

입력 텍스트로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다.

pat — 검색 패턴

string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | pattern형 배열

검색 패턴으로, 다음 중 하나로 지정됩니다.

• string형 배열

• 문자형 벡터

• 문자형 벡터로 구성된 셀형 배열

• pattern형 배열

팁

• 문자가 없는 string형("") 또는 문자가 없는 문자형 벡터('')는 모든 문자열의 부분문자열입니다. 따라서 contains는 어떤 입력 텍스트에서든 이러한 부분문자열을 항상 찾아냅니다. 자세한 내용은 빈 문자열과 누락값이 있는지 테스트하기 항목을 참조하십시오.

확장 기능

tall형 배열

메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.

contains 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• str과 pat는 string형 스칼라, 문자형 벡터 또는 최대 1개의 문자형 벡터를 포함하는 셀형 배열이어야 합니다.

GPU 코드 생성

GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.

C/C++ 코드 생성 섹션의 사용법 관련 참고 및 제한 사항을 참조하십시오. GPU 코드 생성에도 동일한 사용법 관련 참고 및 제한 사항이 적용됩니다.

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

contains 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

분산 배열

Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.

contains 함수는 분산 배열을 완전히 지원합니다. 자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2016b에 개발됨

참고 항목

count | endsWith | extract | matches | replace | startsWith | split | pattern | digitsPattern | lettersPattern

도움말 항목

• string형 배열 생성하기
• 텍스트 비교
• 텍스트를 검색하고 바꾸기
• 패턴 표현식 작성하기
• 빈 문자열과 누락값이 있는지 테스트하기