C#에서 딕셔너리(Dictionary)는 키(Key)와 값(Value)의 쌍으로 데이터를 저장하는 대표적인 컬렉션입니다. Dictionary<TKey, TValue>는 제네릭 타입으로 선언되며, System.Collections.Generic 네임스페이스에 포함되어 있어 별도의 형 변환 없이 안전하게 사용할 수 있습니다.
키는 중복될 수 없으며, 각 키는 하나의 값과 매핑됩니다. 이러한 특성 덕분에 빠른 조회 성능이 필요한 상황에서 딕셔너리가 자주 활용됩니다.
C# 딕셔너리의 주요 메서드 및 속성
| 번호 | 메서드 및 설명 |
|---|---|
| 1 | Add 딕셔너리에 키-값 쌍을 추가합니다. 이미 존재하는 키를 추가하면 예외가 발생합니다. |
| 2 | Clear() 딕셔너리의 모든 키와 값을 제거하여 비웁니다. |
| 3 | Remove 지정한 키에 해당하는 요소를 딕셔너리에서 삭제합니다. |
| 4 | ContainsKey 지정한 키가 Dictionary<TKey, TValue>에 존재하는지 여부를 확인하고 true 또는 false를 반환합니다. |
| 5 | ContainsValue 지정한 값이 Dictionary<TKey, TValue>에 존재하는지 여부를 확인하고 true 또는 false를 반환합니다. |
| 6 | Count 딕셔너리에 저장된 키-값 쌍의 개수를 반환합니다. 참고로 Count는 메서드가 아닌 속성(Property)입니다. |
예제 코드: 요소 추가 및 개수 확인
아래 예제에서는 Add 메서드를 사용해 딕셔너리에 요소를 추가하고, Count 속성으로 저장된 항목의 개수를 출력합니다.
using System;
using System.Collections.Generic;
public class Demo {
public static void Main() {
IDictionary<int, int> d = new Dictionary<int, int>();
d.Add(1, 97);
d.Add(2, 89);
d.Add(3, 77);
d.Add(4, 88);
d.Add(5, 78);
d.Add(6, 98);
Console.WriteLine(d.Count);
}
}실행 결과
6
위 코드에서는 IDictionary<int, int> 인터페이스 타입으로 딕셔너리를 생성한 뒤, 정수형 키와 값을 6쌍 추가했습니다. 따라서 d.Count를 호출하면 저장된 요소의 총 개수인 6이 출력됩니다.
마무리
딕셔너리는 키 기반으로 데이터를 관리해야 하는 다양한 상황에서 유용하게 사용됩니다. Add, Remove, ContainsKey 같은 기본 메서드와 Count 속성만 잘 익혀두면 실무에서 데이터를 효율적으로 처리할 수 있습니다.