insertBefore

지정된 부분문자열 앞에 문자열 삽입

구문

newStr = insertBefore(str,pat,newText)

newStr = insertBefore(str,pos,newText)

설명

newStr = insertBefore(str,pat,newText)는 str에서 pat로 지정된 부분문자열 앞에 newText를 삽입하고 그 결과를 newStr로 반환합니다. pat가 str에 여러 번 나오는 경우 insertBefore는 pat가 나올 때마다 그 앞에 텍스트를 삽입합니다.

str이 string형 배열이나 문자형 벡터로 구성된 셀형 배열이면 insertBefore는 newText를 str의 각 요소에 삽입합니다. 출력 인수 newStr은 str과 데이터형이 동일합니다.

newStr = insertBefore(str,pos,newText)는 newText로 지정된 텍스트를 str에서 pos로 지정된 위치 앞에 삽입합니다.

예제

부분문자열 앞에 텍스트 삽입하기

string형 배열을 생성하고 부분문자열 앞에 텍스트를 삽입합니다.

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

str = "bread cheese wine"

str = 
"bread cheese wine"

문자열에서 각 공백 문자 앞에 쉼표를 삽입합니다. insertBefore 함수는 일치하는 각 부분문자열 앞에 텍스트를 삽입합니다.

newStr = insertBefore(str," ",",")

newStr = 
"bread, cheese, wine"

string형 배열의 각 요소에 부분문자열을 삽입합니다. 각각 다른 부분문자열을 위치로 지정할 경우, 이러한 부분문자열은 str과 같은 크기의 string형 배열이나 셀형 배열에 포함시켜야 합니다.

str = ["The quick fox jumps";"over the dog"]

str = 2×1 string
    "The quick fox jumps"
    "over the dog"

newStr = insertBefore(str,[" fox";" dog"],[" brown";" lazy"])

newStr = 2×1 string
    "The quick brown fox jumps"
    "over the lazy dog"

패턴을 사용하여 파일 이름 앞에 텍스트 삽입하기

R2020b 이상

전체 경로를 포함하는 파일 이름으로 구성된 string형 배열을 만듭니다.

str = ["C:\Temp\MyReport.docx";
       "C:\Data\Experiment1\Trial1\Sample1.csv";
       "C:\Temp\Slides.pptx"]

str = 3×1 string
    "C:\Temp\MyReport.docx"
    "C:\Data\Experiment1\Trial1\Sample1.csv"
    "C:\Temp\Slides.pptx"

각 경로의 끝부분에서 파일 이름 직전에 새 폴더 이름을 삽입합니다. 파일 이름과 일치하게 만들려면 마지막 "\" 문자와 나머지 모든 텍스트를 문자열 끝부분에 일치시키는 패턴을 만듭니다. wildcardPattern 함수를 사용하여 "\"를 제외한 모든 문자와 일치하게 만들고 textBoundary 함수를 사용하여 문자열의 끝부분과 일치하게 만듭니다. 그러고 나서, insertBefore를 호출하여 일치하는 텍스트 앞에 새 폴더 이름을 삽입합니다.

pat = "\" + wildcardPattern("Except","\") + textBoundary

pat = pattern
  Matching:

    "\" + wildcardPattern("Except","\") + textBoundary

filenames = insertBefore(str,pat,"\20200601")

filenames = 3×1 string
    "C:\Temp\20200601\MyReport.docx"
    "C:\Data\Experiment1\Trial1\20200601\Sample1.csv"
    "C:\Temp\20200601\Slides.pptx"

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

특정 위치 앞에 부분문자열 삽입하기

string형 배열을 생성하고 부분문자열을 삽입할 위치를 지정합니다.

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

str = "James Maxwell"

str = 
"James Maxwell"

일곱 번째 문자 앞에 부분문자열을 삽입합니다.

newStr = insertBefore(str,7,"Clerk ")

newStr = 
"James Clerk Maxwell"

string형 배열의 각 요소에 부분문자열을 삽입합니다. 숫자형 배열을 사용하여 각각 다른 위치를 지정할 경우, 숫자형 배열의 크기는 입력 string형 배열과 동일해야 합니다.

str = ["James Maxwell";"Carl Gauss"]

str = 2×1 string
    "James Maxwell"
    "Carl Gauss"

newStr = insertBefore(str,[7;6],["Clerk ";"Friedrich "])

newStr = 2×1 string
    "James Clerk Maxwell"
    "Carl Friedrich Gauss"

문자형 벡터의 특정 위치 앞에 텍스트 삽입하기

문자형 벡터를 생성하고 지정된 위치 앞에 텍스트를 삽입합니다.

chr = 'mushrooms and onions'

chr = 
'mushrooms and onions'

열 번째 위치 앞에 텍스트를 삽입합니다.

newChr = insertBefore(chr,10,', peppers,')

newChr = 
'mushrooms, peppers, and onions'

부분문자열 앞에 텍스트를 삽입합니다.

newChr = insertBefore(chr,' and',', peppers,')

newChr = 
'mushrooms, peppers, and onions'

입력 인수

str — 입력 텍스트

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

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

pat — 끝 위치를 표시하는 텍스트 또는 패턴

string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | pattern 배열(R2020b 이상)

삽입된 텍스트의 끝 위치를 표시하는 str의 텍스트 또는 패턴으로, 다음 중 하나로 지정됩니다.

• string형 배열

• 문자형 벡터

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

• pattern 배열(R2020b 이상)

str이 string형 배열이거나 문자형 벡터로 구성된 셀형 배열이면 str의 모든 요소에 텍스트를 삽입할 수 있습니다. 삽입부가 모두 같은 끝 위치를 가진다고 지정하거나 str의 각 요소에서 서로 다른 끝 위치를 가진다고 지정할 수 있습니다.

• 같은 끝 위치를 지정하려면 pat를 문자형 벡터, string형 스칼라 또는 pattern 객체로 지정하십시오.

• 서로 다른 끝 위치를 지정하려면 pat를 string형 배열, 문자형 벡터로 구성된 셀형 배열 또는 pattern 배열로 지정하십시오.

pos — 끝 위치

숫자형 배열

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

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

newText — 삽입할 텍스트

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

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

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

출력 인수

newStr — 출력 텍스트

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

출력 텍스트로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 반환됩니다. str과 newStr은 데이터형이 동일합니다.

확장 기능

tall형 배열

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

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

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

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

C/C++ 코드 생성

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

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

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

스레드 기반 환경

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

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

분산 배열

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

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

• pattern 객체는 스칼라여야 합니다.

자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2016b에 개발됨

참고 항목

split | join | erase | extract | insertAfter | replace | pattern | wildcardPattern | textBoundary | count

도움말 항목

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