extract

문자열에서 부분문자열 추출하기

구문

newStr = extract(str,pat)

newStr = extract(str,pos)

설명

newStr = extract(str,pat)는 str에서 pat로 지정된 패턴과 일치하는 부분문자열을 반환합니다.

str이 string형 배열이나 문자형 벡터로 구성된 셀형 배열이면 이 함수는 str의 각 요소에서 부분문자열을 추출합니다. pat가 배열인 경우 이 함수는 여러 패턴을 대상으로 일치 결과를 얻습니다.

newStr = extract(str,pos)는 str에서 pos로 지정된 위치에 있는 문자를 반환합니다.

예제

주소에서 우편번호 추출하기

주소가 포함된 string형 배열을 만듭니다. 각각의 주소는 미국 우편번호로 끝납니다.

str = ["73 Beacon St., Boston, MA, 02116";
       "1640 Riverside Dr., Hill Valley, CA, 92530";
       "138 Main St., Cambridge, MA, 02138"]

str = 3×1 string
    "73 Beacon St., Boston, MA, 02116"
    "1640 Riverside Dr., Hill Valley, CA, 92530"
    "138 Main St., Cambridge, MA, 02138"

숫자 시퀀스와 일치하는 패턴을 만듭니다.

pat = digitsPattern

pat = pattern
  Matching:

    digitsPattern

패턴을 사용하여 주소에서 모든 숫자 시퀀스를 추출합니다.

newStr = extract(str,pat)

newStr = 3×2 string
    "73"      "02116"
    "1640"    "92530"
    "138"     "02138"

digitsPattern 패턴은 도로 번호, 건물 번호 및 우편번호와 일치합니다. 우편번호만 일치시키기 위해 주소의 끝에 있는 숫자 시퀀스와 일치하는 패턴을 만듭니다.

pat = digitsPattern + textBoundary

pat = pattern
  Matching:

    digitsPattern + textBoundary

우편번호를 추출합니다.

newStr = extract(str,pat)

newStr = 3×1 string
    "02116"
    "92530"
    "02138"

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

숫자로 된 위치에서 문자 추출하기

문자열을 생성합니다.

str = "All's well that ends well"

str = 
"All's well that ends well"

문자열에서 처음 문자를 추출합니다.

extract(str,1)

ans = 
"A"

마지막 문자를 추출합니다.

extract(str,strlength(str))

ans = 
"l"

입력 인수

str — 입력 텍스트

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

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

pat — 검색 패턴

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

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

• string형 배열

• 문자형 벡터

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

• pattern형 배열

pos — 위치

숫자형 배열

위치로, 숫자형 배열로 지정됩니다.

str이 string형 배열이거나 문자형 벡터로 구성된 셀형 배열이면 pos는 str과 크기가 같은 숫자형 스칼라 또는 숫자형 배열일 수 있습니다.

출력 인수

newStr — 출력 텍스트

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

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

str이 string형 배열이면 newStr도 string형 배열입니다. 그렇지 않으면, newStr은 문자형 벡터로 구성된 셀형 배열입니다.

확장 기능

tall형 배열

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

extract 함수는 tall형 배열을 지원하지만 다음과 같은 사용법 관련 참고 및 제한 사항이 있습니다.

• pat가 pattern 객체로 구성된 배열인 경우 배열의 첫 번째 차원 크기는 1이어야 합니다.

자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성

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

코드 생성 시, 입력 인수는 다음이어야 합니다.

• 입력 텍스트 str에 대한 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열

• 검색 패턴 pat에 대한 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열

분산 배열

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

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

버전 내역

R2020b에 개발됨

R2025a: 코드 생성 지원

이 함수에 대한 C/C++ 코드를 생성할 수 있습니다.

참고 항목

split | join | erase | extractAfter | extractBefore | extractBetween | insertAfter | insertBefore | replace | strlength | count | pattern | digitsPattern | lettersPattern | textBoundary

도움말 항목

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