Main Content

dictionary

고유 키를 값에 매핑하는 객체

R2022b 이후. 다음보다 권장: containers.Map.

설명

사전은 대규모 세트에서 빠르게 값을 찾는 데 유용합니다. 사전은 데이터를 으로 저장한 일종의 맵으로, 이 값은 대응하는 고유한 를 사용하여 액세스할 수 있습니다. 키와 값의 각 쌍은 항목에 해당합니다.

생성

설명

예제

d = dictionary(keys,values)는 지정된 키와 값을 사용하여 사전을 만듭니다. 그 결과로 만들어지는 사전 d는 1×1 스칼라 객체입니다. 동일한 키에 여러 값이 할당된 경우 그러한 값 중 마지막 값만 할당됩니다. 기존 키에 값을 새로 할당하면 해당 항목의 값을 덮어쓰게 됩니다.

values가 스칼라가 아닌 한, keysvalues는 동일한 크기여야 합니다. 이때 keys의 각 요소가 values에 대한 키가 됩니다. 키와 값이 배열인 경우 항목 개수는 키-값 쌍 개수와 동일합니다.

사전은 항목을 기반으로 유형이 지정됩니다. 사전의 모든 키와 모든 값은 각 데이터형을 공유하거나 구성된 데이터형으로 변환될 수 있어야 합니다. 일부 새 항목이 구성된 데이터형을 동일하게 갖지 않는 경우 MATLAB®은 변환을 시도합니다. 키와 값은 동일한 데이터형일 필요가 없습니다. 키 또는 값으로 할당될 경우 문자형 행 벡터는 string형 스칼라로 변환됩니다.

서로 다른 유형의 값이 셀형 배열에 포함된 경우 이러한 값을 사전에 추가할 수 있습니다. 셀을 값으로 사용하는 사전에서 룩업을 수행하면 셀형 배열이 반환됩니다. 셀형 배열의 내용에는 소괄호 대신에 중괄호({})를 사용하여 직접 액세스할 수 있습니다. (R2023a 이후)

d = dictionary(k1,v1,...,kN,vN)은 지정된 키-값 쌍을 포함하는 사전을 만듭니다. 동일한 키의 여러 인스턴스가 지정된 경우 마지막 키-값 쌍만 할당됩니다.

예제

d = dictionary는 아무런 키 또는 값을 갖지 않는, 구성되지 않은 사전을 만듭니다.

입력값 없이 생성된 사전은 구성되지 않은 사전에 해당하고 유형도 지정되지 않습니다. 구성되지 않은 사전에 항목을 추가하면 키의 데이터형과 값의 데이터형이 지정됩니다.

입력 인수

모두 확장

키로, 스칼라 또는 배열로 지정됩니다. keys의 개별 요소는 동일한 데이터형 또는 호환되는 데이터형을 갖는 스칼라여야 합니다.

keys가 배열인 경우 각 요소는 새 키를 생성합니다. keys에 중복 요소가 있으면 마지막 중복 요소에 대응되는 값이 할당됩니다.

값으로, 스칼라, 배열 또는 셀형 배열로 지정됩니다. values의 개별 요소는 동일한 데이터형을 갖는 스칼라여야 합니다. 값이 이종 값이거나 비 스칼라여야 하는 경우 셀형 배열을 사용하십시오.

values가 배열인 경우 각 요소는 새 값을 생성합니다. keys가 배열이고 values가 스칼라인 경우 해당 값은 keys의 각 키에 매핑됩니다.

키-값 쌍으로, 키와 값 스칼라 및 배열의 개별 인수로 지정됩니다. 모든 키 인수는 동일한 데이터형을 갖거나 호환되는 데이터형을 가져야 합니다. 모든 값 인수는 동일한 데이터형을 갖거나 호환되는 데이터형을 가져야 합니다.

사용

설명

dictionary를 사용하여 사전 d를 만듭니다. 그런 다음, 다음 구문 중 하나를 사용하여 특정 쿼리 점에서 d를 계산하거나 변경할 수 있습니다.

valueOut = d(keys)keys에 대응하는 값을 조회합니다.

d(keys) = newValuesnewValues의 요소를 keys에 대응되는 값으로 지정된 항목에 할당합니다. 지정된 키가 사전에 없는 경우 새 항목이 추가됩니다. 동일한 키에 여러 값이 할당된 경우 그러한 값 중 마지막 값만 할당됩니다. 기존 키에 값을 새로 할당하면 해당 항목의 값을 덮어쓰게 됩니다.

d(keys) = []keys와 연결된 항목을 사전에서 제거합니다.

valueOut = d{keys}keys와 연결된 값을 조회하고, 셀의 내용을 반환합니다. keys가 배열인 경우 쉼표로 구분된 해당 값 목록이 반환됩니다. 사전의 값이 셀이 아닌 다른 데이터형으로 구성된 경우 오류가 발생합니다.

d{keys} = newValuesnewValues의 요소를 포함한 셀을 해당 키 값으로 지정된 항목에 할당합니다. 사전의 값이 셀이 아닌 다른 데이터형으로 구성된 경우 오류가 발생합니다.

객체 함수

configureDictionaryCreate dictionary with specified key and value types
insertAdd entries to a dictionary
lookupFind value in dictionary by key
removeRemove dictionary entries
entriesKey-value pairs of dictionary
keys사전의 키
valuesValues of dictionary
typesTypes of dictionary keys and values
numEntriesNumber of key-value pairs in dictionary
isConfiguredDetermine if dictionary has types assigned to keys and values
isKeyDetermine if dictionary contains key

예제

모두 축소

서로 다른 차량의 바퀴 수를 저장하기 위한 사전을 만듭니다.

이름으로 구성된 배열과 그에 대응하는 바퀴 수로 구성된 배열을 만듭니다.

wheels = [1 2 3];
names = ["Monocycle" "Bicycle" "Tricycle"];

이름을 키로 사용하고 바퀴 수를 값으로 사용하여 사전을 만듭니다.

d = dictionary(names,wheels)
d =

  dictionary (string --> double) with 3 entries:

    "Monocycle" --> 1
    "Bicycle"   --> 2
    "Tricycle"  --> 3

키를 인덱스로 사용하여 사전 값에 액세스합니다.

d("Tricycle")
ans = 3

새 값을 기존 키에 할당하여 항목을 수정할 수 있습니다.

d("Bicycle") = 2.5
d =

  dictionary (string --> double) with 3 entries:

    "Monocycle" --> 1
    "Bicycle"   --> 2.5000
    "Tricycle"  --> 3

값을 키에 할당하여 새 항목을 사전에 추가합니다.

d("Car") = 4
d =

  dictionary (string --> double) with 4 entries:

    "Monocycle" --> 1
    "Bicycle"   --> 2.5000
    "Tricycle"  --> 3
    "Car"       --> 4

키와 값으로 구성된 배열을 사용하여 여러 항목을 추가합니다.

names2 = ["Truck" "Motorcycle" "Sixteen-Wheeler"];
wheels2 = [4 2 16];
d(names2) = wheels2
d =

  dictionary (string --> double) with 7 entries:

    "Monocycle"       --> 1
    "Bicycle"         --> 2.5000
    "Tricycle"        --> 3
    "Car"             --> 4
    "Truck"           --> 4
    "Motorcycle"      --> 2
    "Sixteen-Wheeler" --> 16

빈 배열을 기존 키에 할당하여 항목을 제거합니다.

d("Truck") = []
d =

  dictionary (string --> double) with 6 entries:

    "Monocycle"       --> 1
    "Bicycle"         --> 2.5000
    "Tricycle"        --> 3
    "Car"             --> 4
    "Motorcycle"      --> 2
    "Sixteen-Wheeler" --> 16

사전의 구성된 데이터형과 일치하도록 새 항목이 자동으로 변환됩니다. 변환이 가능하지 않으면 MATLAB에서 오류를 발생시킵니다.

d('Spider-Car') = "8"
d =

  dictionary (string --> double) with 7 entries:

    "Monocycle"       --> 1
    "Bicycle"         --> 2.5000
    "Tricycle"        --> 3
    "Car"             --> 4
    "Motorcycle"      --> 2
    "Sixteen-Wheeler" --> 16
    "Spider-Car"      --> 8

사전 값은 동일한 유형이어야 합니다. 하지만 서로 다른 유형의 데이터는 사전에 셀로 저장할 수 있습니다.

다양한 데이터형을 포함하는 셀형 배열을 만든 다음 키로 구성된 string형 배열을 만듭니다.

myValues = {datetime,@myfun,struct,[1 2 3 4]}
myValues=1×4 cell array
    {[25-Jan-2024 20:36:57]}    {@myfun}    {1x1 struct}    {[1 2 3 4]}

myKeys = ["my birthday" "my favorite function" "a structure" "numeric array"]
myKeys = 1x4 string
    "my birthday"    "my favorite function"    "a structure"    "numeric array"

지정된 키와 값을 사용하여 사전을 만듭니다.

d = dictionary(myKeys,myValues)
d =

  dictionary (string --> cell) with 4 entries:

    "my birthday"          --> {[25-Jan-2024 20:36:57]}
    "my favorite function" --> {@myfun}
    "a structure"          --> {1x1 struct}
    "numeric array"        --> {[1 2 3 4]}

values 함수를 사용하여 값을 셀형 배열로 추출합니다.

values(d)
ans=4×1 cell array
    {[25-Jan-2024 20:36:57]}
    {                @myfun}
    {1x1 struct            }
    {[             1 2 3 4]}

R2023a에서는 중괄호({})를 사용하여 값으로 저장된 셀의 내용을 직접 조회합니다.

d{"numeric array"}
ans = 1×4

     1     2     3     4

마찬가지로 중괄호({})를 사용하여 임의의 데이터형의 새 항목을 셀 값이 있는 기존 사전에 삽입할 수 있습니다.

d{"a new entry"} = table
d =

  dictionary (string --> cell) with 5 entries:

    "my birthday"          --> {[25-Jan-2024 20:36:57]}
    "my favorite function" --> {@myfun}
    "a structure"          --> {1x1 struct}
    "numeric array"        --> {[1 2 3 4]}
    "a new entry"          --> {0x0 table}

아무런 입력값 없이 dictionary를 호출하면 구성되지 않은 사전이 생성됩니다.

configureDictionary를 사용하여, 구성된 빈 사전을 생성합니다.

R2023b 이전: 원하는 유형의 빈 입력값을 할당합니다. 예: d = dictionary(string([]),[]).

d = configureDictionary("string","double")
d =

  dictionary (string --> double) with no entries.

이는 구성된 사전에 해당합니다. 데이터형이 일치하거나 구성된 사전의 데이터형으로 변환할 수 있으면 새 항목을 추가할 수 있습니다.

d("Unicycle") = 1;
d("Bicycle") = 2;
d("Tricycle") = 3
d =

  dictionary (string --> double) with 3 entries:

    "Unicycle" --> 1
    "Bicycle"  --> 2
    "Tricycle" --> 3

dictionary를 입력값 없이 호출하여, 구성되지 않은 사전을 만듭니다.

d = dictionary
d =

  dictionary with unset key and value types.

구성되지 않은 사전에 항목을 추가하면 사전이 구성된 형태로 변경됩니다.

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

  dictionary (double --> string) with 3 entries:

    1 --> "Unicycle"
    2 --> "Bicycle"
    3 --> "Tricycle"

버전 내역

R2022b에 개발됨

모두 확장