isKey

사전에 키가 포함되어 있는지 확인

R2022b 이후

구문

tf = isKey(d,key)

설명

tf = isKey(d,key)는 구성된 사전에 지정된 키가 포함된 경우 논리값 1(true)을 반환하고, 그렇지 않으면 논리값 0(false)을 반환합니다. d가 구성되지 않은 사전인 경우 isKey는 오류를 발생시킵니다.

key가 여러 개의 키를 지정하는 배열이면 논리형 배열 tf는 이 배열과 같은 크기를 가집니다.

예제

사전에서 키 찾기

여러 개의 키-값 쌍이 포함된 사전을 만듭니다.

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

d =

  dictionary (double ⟼ string) with 3 entries:

    1 ⟼ "Unicycle"
    2 ⟼ "Bicycle"
    3 ⟼ "Tricycle"

사전이 1을 키로 갖는지 여부를 확인합니다.

tf = isKey(d,1)

tf = logical
   1

여러 개의 키를 검색합니다.

key = [1 2 3 4 5];
tf = isKey(d,key)

tf = 1×5 logical array

   1   1   1   0   0

입력 인수

d — 사전

dictionary 객체

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

key — 키 집합

배열

키 집합으로, 배열로 지정됩니다. key의 데이터형은 d의 키의 데이터형과 일치하거나 해당 데이터형으로 변환 가능해야 합니다.

확장 기능

C/C++ 코드 생성

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

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

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

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

GPU 코드 생성

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

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

버전 내역

R2022b에 개발됨

R2024b: 코드 생성 지원

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

참고 항목

dictionary | configureDictionary | insert | lookup | remove | entries | keys | values | types | numEntries | isConfigured

도움말 항목

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