keys

사전의 키

R2022b 이후

구문

k = keys(d)

k = keys(d,'cell')

설명

k = keys(d)는 지정한 사전 키를 N×1 배열로 반환합니다. 여기서 N은 사전의 항목 개수입니다. 키는 항목이 사전에 추가된 순서대로 반환됩니다.

k = keys(d,'cell')은 선택적으로 키를 셀형 배열로 반환합니다.

예제

사전의 키 쿼리하기

숫자를 문자열에 매핑하는 세 개의 키-값 쌍을 포함하는 사전을 만듭니다.

names = ["Unicycle" "Bicycle" "Tricyle"];
wheels = [1 2 3];
d = dictionary(wheels,names)

d =

  dictionary (double ⟼ string) with 3 entries:

    1 ⟼ "Unicycle"
    2 ⟼ "Bicycle"
    3 ⟼ "Tricyle"

keys를 사용하여, 사전에 저장된 키를 포함하는 배열을 반환합니다.

k = keys(d)

k = 3×1

     1
     2
     3

사전의 각 키를 반복하여 표시합니다.

for currentKey = keys(d)'
    disp("key: " + currentKey)
end

key: 1
key: 2
key: 3

사전의 키를 셀형 배열로 반환하기

숫자를 문자열에 매핑하는 세 개의 키-값 쌍을 포함하는 사전을 만듭니다.

names = ["Unicycle" "Bicycle" "Tricyle"];
wheels = [1 2 3];
d = dictionary(wheels,names)

d =

  dictionary (double ⟼ string) with 3 entries:

    1 ⟼ "Unicycle"
    2 ⟼ "Bicycle"
    3 ⟼ "Tricyle"

keys를 선택적 입력값 "cell"과 함께 사용하여, 사전에 저장된 키를 포함하는 배열을 셀형 배열로 반환합니다.

k = keys(d,"cell")

k=3×1 cell array
    {[1]}
    {[2]}
    {[3]}

입력 인수

d — 사전

dictionary 객체

사전으로, dictionary 객체로 지정됩니다. d가 구성되지 않은 경우 keys는 오류를 발생시킵니다.

출력 인수

k — 사전 키

N×1 배열

사전 키로, N×1 배열로 반환됩니다. 여기서 N은 사전의 항목 개수입니다. 키는 항목이 사전에 추가된 순서대로 반환됩니다.

확장 기능

C/C++ 코드 생성

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

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

• 코드 생성기가 사전 키를 배열로 반환할 수 없으면 코드 생성이 실패합니다. 이 경우에는 "cell" 인수를 사용하여 사전 키를 셀형 배열로 반환하십시오.

• "cell" 인수를 사용할 경우, 이 인수는 코드 생성 시 상수여야 합니다.

• 코드 생성 시점에 사전이 상수인 경우에도 코드 생성기는 사전을 상수로 취급하지 않습니다. 이는 keys 함수가 상수를 반환하지 않음을 의미합니다. 상수 입력값을 필요로 하는 함수에는 keys 함수의 출력값을 전달할 수 없습니다. 상수가 필요한 작업(예: 이종 셀형 배열의 요소 참조)에 keys 함수의 출력값을 사용할 수 없습니다. 코드 생성기는 keys 함수의 출력값에 대해 상수에 종속되는 최적화(예: 상수 폴딩)도 수행할 수 없습니다.

MATLAB^® 사전에 대한 C/C++ 코드를 생성할 때 적용되는 추가 고려 사항은 Dictionary Limitations for Code Generation (MATLAB Coder) 항목을 참조하십시오.

GPU 코드 생성

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

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

버전 내역

R2022b에 개발됨

R2024b: 코드 생성 지원

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

참고 항목

dictionary | entries | values | types | numEntries | isConfigured | isKey | keyHash | keyMatch

도움말 항목

• 사전으로 데이터 매핑하기
• Manage Data Types in Dictionaries
• Use Dictionaries to Process Text Data