pad

문자열에 선행 또는 후행 문자 추가

구문

newStr = pad(str)

newStr = pad(str,numberOfCharacters)

newStr = pad(str,side)

newStr = pad(str,numberOfCharacters,side)

newStr = pad(___,padCharacter)

설명

newStr = pad(str)은 str의 문자열 중에서 가장 긴 문자열을 제외한 나머지 문자열의 끝에 공백 문자를 추가합니다.

• str이 여러 개의 요소를 갖는 string형 배열 또는 여러 개의 요소를 갖는 문자형 벡터로 구성된 셀형 배열인 경우 pad는 공백 문자를 추가합니다. newStr의 모든 문자열은 str의 가장 긴 요소와 길이가 같습니다.

• str이 문자형 벡터이거나 하나의 요소를 갖는 string형 배열 또는 하나의 요소를 갖는 문자형 벡터로 구성된 셀형 배열인 경우 pad는 str을 변경하지 않고 그대로 반환합니다.

newStr = pad(str,numberOfCharacters)는 newStr의 문자열이 numberOfCharacters로 지정된 길이를 갖도록 공백 문자를 추가합니다. str의 문자열 중 numberOfCharacters보다 많은 문자를 갖는 문자열이 있으면 pad는 해당 문자열을 수정하지 않습니다.

newStr = pad(str,side)는 side로 지정된 쪽에 공백 문자를 추가합니다. side 인수는 'left', 'right' 또는 'both'일 수 있습니다.

newStr = pad(str,numberOfCharacters,side)는 side로 지정된 쪽에 numberOfCharacters로 지정된 길이까지 공백 문자를 추가합니다.

newStr = pad(___,padCharacter)는 문자열에 공백 문자 대신 padCharacter로 지정된 문자를 채웁니다. 위에 열거된 구문의 모든 입력 인수와 사용할 수 있습니다.

str이 텍스트 하나만 포함하는 경우 pad(str,padCharacter)는 str을 변경하지 않고 그대로 반환합니다.

예제

string형 배열을 공백으로 채우기

string형 배열을 만듭니다.

str = ["Mercury","Gemini","Apollo";
       "Skylab","Skylab B","ISS"]

str = 2×3 string
    "Mercury"    "Gemini"      "Apollo"
    "Skylab"     "Skylab B"    "ISS"   

str의 요소를 공백 문자로 채웁니다.

newStr = pad(str)

newStr = 2×3 string
    "Mercury "    "Gemini  "    "Apollo  "
    "Skylab  "    "Skylab B"    "ISS     "

string형 배열을 지정된 길이까지 채우기

string형 배열을 만듭니다.

str = ["Mercury","Gemini","Apollo";
       "Skylab","Skylab B","ISS"]

str = 2×3 string
    "Mercury"    "Gemini"      "Apollo"
    "Skylab"     "Skylab B"    "ISS"   

가장 긴 문자열도 공백으로 채워질 수 있도록 길이를 지정합니다.

newStr = pad(str,12)

newStr = 2×3 string
    "Mercury     "    "Gemini      "    "Apollo      "
    "Skylab      "    "Skylab B    "    "ISS         "

문자열을 다른 방향으로 채우기

string형 배열을 만듭니다.

str = ["Mary";"Elizabeth";"James"]

str = 3×1 string
    "Mary"
    "Elizabeth"
    "James"

문자열의 왼쪽을 채웁니다.

newStr = pad(str,'left')

newStr = 3×1 string
    "     Mary"
    "Elizabeth"
    "    James"

문자열의 양쪽을 채웁니다.

newStr = pad(str,'both')

newStr = 3×1 string
    "  Mary   "
    "Elizabeth"
    "  James  "

string형 배열을 다른 문자로 채우기

숫자를 나타내는 string형 배열을 만들고 공백 문자 대신 선행 0으로 문자열을 채웁니다.

A = [69.45 31.71 95.36 3.44 7.82];
A = A';
str = string(A)

str = 5×1 string
    "69.45"
    "31.71"
    "95.36"
    "3.44"
    "7.82"

newStr = pad(str,7,'left','0')

newStr = 5×1 string
    "0069.45"
    "0031.71"
    "0095.36"
    "0003.44"
    "0007.82"

입력 인수

str — 입력 텍스트

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

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

데이터형: string | char | cell

numberOfCharacters — 출력 문자열의 총 문자 수

양의 정수

출력 문자열의 총 문자 수로, 양의 정수로 지정됩니다.

데이터형: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

side — 채울 문자열의 방향

'right' (디폴트 값) | 'left' | 'both'

채울 문자열의 방향으로, 'left', 'right' 또는 'both'로 지정됩니다. 디폴트 동작은 문자열의 오른쪽을 채우는 것입니다.

데이터형: char | string

padCharacter — 채울 문자

' ' (디폴트 값) | 문자형 | string형

채울 문자로, 하나의 문자를 포함하는 문자형 또는 string형으로 지정됩니다.

데이터형: char | string

출력 인수

newStr — 출력 텍스트

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

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

데이터형: string | char | cell

확장 기능

tall형 배열

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

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

• numberOfCharacters는 첫 번째 차원의 크기가 1이어야 합니다. numberOfCharacters를 지정하지 않으면 그 값을 결정하기 위해 데이터 전체를 거치면서 확인해야 합니다.

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

스레드 기반 환경

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

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

분산 배열

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

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

버전 내역

R2016b에 개발됨

참고 항목

strsplit | join | erase | replace | strip | split

도움말 항목

• string형 배열 생성하기
• 텍스트를 검색하고 바꾸기