join

R2026b

문자열 결합

구문

newStr = join(str)

newStr = join(str,delimiter)

newStr = join(str,dim)

newStr = join(str,delimiter,dim)

설명

newStr = join(str)은 입력 배열의 연속 요소 사이에 공백 문자를 넣어 결합하여 str의 텍스트를 결합합니다. str은 string형 배열이거나 문자형 벡터로 구성된 셀형 배열일 수 있습니다. newStr은 str과 동일한 데이터형을 가집니다.

• str이 1×N 또는 N×1 string형 배열 또는 셀형 배열인 경우 newStr은 문자형 벡터 1개가 들어 있는 string형 스칼라 또는 셀형 배열입니다.

• str이 M×N string형 배열이거나 셀형 배열인 경우 newStr은 M×1 string형 배열 또는 셀형 배열입니다.

어떤 크기의 string형 또는 string형 배열에 대해서도, join은 크기가 1이 아닌 str의 마지막 차원에서 요소를 결합합니다.

newStr = join(str,delimiter)는 str의 텍스트를 결합하고 공백 문자 대신 str의 요소 사이에 delimiter의 요소를 배치합니다.

delimiter 인수가 다양한 구분 기호로 구성된 배열이고 str에 결합된 차원에 N개의 요소가 있는 경우, delimiter에는 같은 차원에 N–1개의 요소가 있어야 합니다. delimiter의 다른 차원은 크기가 1이거나 str의 해당 차원과 같은 크기여야 합니다.

newStr = join(str,dim)은 차원 dim에서 str의 요소를 결합합니다.

newStr = join(str,delimiter,dim)은 차원 dim에서 str의 요소를 결합하고 str의 요소 사이에 delimiter의 요소를 배치합니다.

예제

string형 배열의 문자열 결합하기

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

str = ["Carlos","Sada";
       "Ella","Olsen";
       "Diana","Lee"]

str = 3×2 string
    "Carlos"    "Sada" 
    "Ella"      "Olsen"
    "Diana"     "Lee"  

join 함수를 사용하여 문자열을 결합합니다. join은 str의 문자열을 결합하고 문자열 사이에 공백 문자를 배치합니다. join은 크기가 1이 아닌 마지막 차원인 두 번째 차원을 따라 결합합니다.

newStr = join(str)

newStr = 3×1 string
    "Carlos Sada"
    "Ella Olsen"
    "Diana Lee"

구분 기호를 사용하여 string형 배열 요소 결합하기

string형 배열의 요소를 결합합니다. str의 문자열 사이에 공백 대신 다양한 텍스트 조각을 삽입할 수 있습니다.

string형 배열을 만듭니다.

str = ["x","y","z";
       "a","b","c"]

str = 2×3 string
    "x"    "y"    "z"
    "a"    "b"    "c"

문자열 사이에 대시를 배치하여 문자열을 결합합니다.

newStr = join(str,"-")

newStr = 2×1 string
    "x-y-z"
    "a-b-c"

출력 문자열이 수식을 나타내도록 하는 기호와 문자열을 결합합니다. str이 2×3 배열이기 때문에 delimiters 인수는 2×2 배열이어야 합니다.

delimiters = [" + "," = ";
              " - "," = "];
newStr = join(str,delimiters)

newStr = 2×1 string
    "x + y = z"
    "a - b = c"

지정된 차원을 따라 String형 배열 결합하기

string형 배열을 만듭니다.

str = ["Carlos","Sada";
       "Ella","Olsen";
       "Diana","Lee"]

str = 3×2 string
    "Carlos"    "Sada" 
    "Ella"      "Olsen"
    "Diana"     "Lee"  

첫 번째 차원을 따라 str의 문자열을 결합합니다. 기본적으로, join 함수는 크기가 1이 아닌 마지막 차원을 따라 문자열을 결합합니다. 첫 번째 차원을 따라 문자열을 결합하려면 이를 추가 입력 인수로 지정하십시오.

newStr = join(str,1)

newStr = 1×2 string
    "Carlos Ella Diana"    "Sada Olsen Lee"

입력 인수

str — 입력 텍스트

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

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

delimiter — 문자열 결합에 사용되는 구분 문자

' ' (디폴트 값) | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | string형 배열

문자열 결합에 사용되는 구분 문자로, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, string형 배열 중 하나로 지정됩니다. join은 문자열 요소 사이에 구분 기호를 넣어 문자열 요소를 결합하여 출력 string형 배열을 형성합니다.

join은 이스케이프된 문자 시퀀스를 포함하여 delimiter의 모든 문자를 리터럴 텍스트로 삽입합니다.

dim — 문자열 결합 시 기준이 되는 차원

양의 정수

문자열 결합 시 기준이 되는 차원으로, 양의 정수로 지정됩니다. dim이 지정되지 않은 경우 디폴트 값은 크기가 1이 아닌 마지막 차원입니다.

출력 인수

newStr — 출력 텍스트

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

출력 텍스트로, string형 배열 또는 문자형 벡터로 구성된 셀형 배열로 반환됩니다. newStr은 입력 테스트와 데이터형이 같고 결합되는 차원에서 크기가 1입니다.

확장 기능

tall형 배열

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

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

스레드 기반 환경

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

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

분산 배열

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

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

버전 내역

R2016b에 개발됨

R2026a: 두 개의 출력값 반환 시 tall형 테이블의 성능이 향상됨

첫 번째 입력값이 tall형 테이블이고 두 개의 출력 인수가 반환될 때의 join 함수 성능이 향상되었습니다. 두 번째 입력 인수는 메모리 내 테이블이거나 tall형 테이블의 축소 연산 결과일 수 있습니다. 이 성능 향상은 tall형 테이블을 읽거나 통과하는 횟수를 줄인 데 따른 결과입니다.

예를 들어, 다음 코드는 tall형 테이블과 메모리 내 테이블을 조인하고 조인된 테이블과 인덱스 벡터를 모두 수집합니다. 이 코드는 이전 릴리스보다 약 5.3배 빠릅니다.

function t = timeJoinWithTwoOutputs
% Run tall code on the local MATLAB session
mapreducer(0)

% Create sample data
keysVar = (1:5e3)';
keysVarShuffled = randi(5e3,1e4,1);
x = randi(1e5,1e4,1);
y = randi(10,5e3,1);
z = randi(1e3,5e3,1,"single");
zz = randi(1e3,1e4,1,"single");

% Create tall table
t = table(x,keysVarShuffled,zz,VariableNames=["X","keys","ZZ"]);
tallTable = tall(t);

% Create in-memory table
inMemoryTable = table(y,z,keysVar,VariableNames=["Y","Z","keys"]);

% Measure time for join
    function joinWithTwoOutputs
        [C,idxb] = join(tallTable,inMemoryTable);
        gather(C,idxb);
    end
t = timeit(@joinWithTwoOutputs);
end

대략적인 실행 시간은 다음과 같습니다.

R2025b: 0.74초

R2026a: 0.14초

코드 실행 시간은 Windows^® 11, Intel^® Xeon^® Silver CPU 4310 @ 2.1GHz 테스트 시스템에서 timeJoinWithTwoOutputs 함수를 호출하여 측정했습니다.

참고 항목

split | regexp | string | splitlines | newline | compose | sprintf | plus