dictionary
설명
사전은 대규모 세트에서 빠르게 값을 찾는 데 유용합니다. 사전은 데이터를 값으로 저장한 일종의 맵으로, 이 값은 대응하는 고유한 키를 사용하여 액세스할 수 있습니다. 키와 값의 각 쌍은 항목에 해당합니다.
생성
설명
는 지정된 키와 값을 사용하여 사전을 만듭니다. 그 결과로 만들어지는 사전 d
= dictionary(keys
,values
)d
는 1×1 스칼라 객체입니다. 동일한 키에 여러 값이 할당된 경우 그러한 값 중 마지막 값만 할당됩니다. 기존 키에 값을 새로 할당하면 해당 항목의 값을 덮어쓰게 됩니다.
values
가 스칼라가 아닌 한, keys
와 values
는 동일한 크기여야 합니다. 이때 keys
의 각 요소가 values
에 대한 키가 됩니다. 키와 값이 배열인 경우 항목 개수는 키-값 쌍 개수와 동일합니다.
사전은 항목을 기반으로 유형이 지정됩니다. 사전의 모든 키와 모든 값은 각 데이터형을 공유하거나 구성된 데이터형으로 변환될 수 있어야 합니다. 일부 새 항목이 구성된 데이터형을 동일하게 갖지 않는 경우 MATLAB®은 변환을 시도합니다. 키와 값은 동일한 데이터형일 필요가 없습니다. 키 또는 값으로 할당될 경우 문자형 행 벡터는 string형 스칼라로 변환됩니다.
서로 다른 유형의 값이 셀형 배열에 포함된 경우 이러한 값을 사전에 추가할 수 있습니다. 셀을 값으로 사용하는 사전에서 룩업을 수행하면 셀형 배열이 반환됩니다. 셀형 배열의 내용에는 소괄호 대신에 중괄호({}
)를 사용하여 직접 액세스할 수 있습니다. (R2023a 이후)
은 지정된 키-값 쌍을 포함하는 사전을 만듭니다. 동일한 키의 여러 인스턴스가 지정된 경우 마지막 키-값 쌍만 할당됩니다.d
= dictionary(k1,v1,...,kN,vN
)
는 아무런 키 또는 값을 갖지 않는, 구성되지 않은 사전을 만듭니다. d
= dictionary
입력값 없이 생성된 사전은 구성되지 않은 사전에 해당하고 유형도 지정되지 않습니다. 구성되지 않은 사전에 항목을 추가하면 키의 데이터형과 값의 데이터형이 지정됩니다.
입력 인수
사용
설명
dictionary
를 사용하여 사전 d
를 만듭니다. 그런 다음, 다음 구문 중 하나를 사용하여 특정 쿼리 점에서 d
를 계산하거나 변경할 수 있습니다.
valueOut = d(keys)
는 keys
에 대응하는 값을 조회합니다.
d(keys) = newValues
는 newValues
의 요소를 keys
에 대응되는 값으로 지정된 항목에 할당합니다. 지정된 키가 사전에 없는 경우 새 항목이 추가됩니다. 동일한 키에 여러 값이 할당된 경우 그러한 값 중 마지막 값만 할당됩니다. 기존 키에 값을 새로 할당하면 해당 항목의 값을 덮어쓰게 됩니다.
d(keys) = []
은 keys
와 연결된 항목을 사전에서 제거합니다.
valueOut = d{keys}
는 keys
와 연결된 값을 조회하고, 셀의 내용을 반환합니다. keys
가 배열인 경우 쉼표로 구분된 해당 값 목록이 반환됩니다. 사전의 값이 셀이 아닌 다른 데이터형으로 구성된 경우 오류가 발생합니다.
d{keys} = newValues
는 newValues
의 요소를 포함한 셀을 해당 키 값으로 지정된 항목에 할당합니다. 사전의 값이 셀이 아닌 다른 데이터형으로 구성된 경우 오류가 발생합니다.
객체 함수
configureDictionary | Create dictionary with specified key and value types |
insert | Add entries to a dictionary |
lookup | Find value in dictionary by key |
remove | Remove dictionary entries |
entries | Key-value pairs of dictionary |
keys | 사전의 키 |
values | Values of dictionary |
types | Types of dictionary keys and values |
numEntries | Number of key-value pairs in dictionary |
isConfigured | Determine if dictionary has types assigned to keys and values |
isKey | Determine if dictionary contains key |
예제
버전 내역
R2022b에 개발됨참고 항목
configureDictionary
| insert
| lookup
| remove
| entries
| keys
| values
| types
| numEntries
| isConfigured
| isKey
| keyHash
| keyMatch