KeyPath 기초
속성을 일급 값으로 참조합니다.
KeyPath 기초은(는) CoddyKit의 무료 Swift Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Swift Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
키 경로란?
키 경로는 실제로 프로퍼티에 접근하지 않고도 해당 프로퍼티로 가는 경로를 나타내는 값입니다. 어떤 인스턴스에서 읽을지는 별도로 두고, 어떤 프로퍼티를 원하는지를 저장해 재사용할 수 있는 참조라고 생각하면 됩니다.
백슬래시, 타입 이름, 점, 프로퍼티 이름을 사용해 키 경로를 작성합니다. 스위프트는 이 표현식에 KeyPath 값을 부여하므로 다른 값처럼 전달할 수 있습니다.
struct Person {
let name: String
let age: Int
}
let nameKeyPath = \Person.name
print(type(of: nameKeyPath))값 읽기
키 경로를 통해 프로퍼티를 읽으려면 인스턴스에서 [keyPath:] 서브스크립트를 사용합니다. 대괄호 안에 키 경로를 전달하면 스위프트가 해당 경로의 값을 반환합니다.
이는 프로퍼티 이름을 직접 작성하는 방식에 대응하는 런타임 기능입니다. 이제 프로퍼티가 코드에 고정된 이름이 아니라 데이터에 따라 선택됩니다.
struct Person {
let name: String
let age: Int
}
let alice = Person(name: "Alice", age: 30)
let path = \Person.name
print(alice[keyPath: path])키 경로 구문 자세히 알아보기
일반적인 형식은 백슬래시 이스케이프, 루트 타입, 점, 프로퍼티 이름의 순서입니다. 백슬래시는 프로퍼티의 값이 아니라 키 경로를 원한다는 것을 스위프트에 알립니다.
루트 타입은 경로가 시작되는 타입입니다. 결과 타입은 마지막 프로퍼티의 타입입니다. 따라서 Person에서 age 프로퍼티로 이어지는 경로의 루트는 Person이고 값의 타입은 Int입니다.
struct Person {
let name: String
let age: Int
}
let ageKeyPath: KeyPath<Person, Int> = \Person.age
let bob = Person(name: "Bob", age: 42)
print(bob[keyPath: ageKeyPath])중첩 프로퍼티를 따라 연결하기
키 경로를 사용하면 중첩된 값 안으로 들어갈 수 있습니다. 프로퍼티 자체가 구조체라면 점을 하나 더 사용해 더 깊은 프로퍼티로 경로를 이어 갈 수 있습니다.
전체 연결은 여전히 하나의 키 경로 값이며, 루트 타입과 결과 타입은 각각 연결의 시작과 끝을 나타냅니다.
struct Address {
let city: String
}
struct Person {
let name: String
let address: Address
}
let cityPath = \Person.address.city
let carol = Person(name: "Carol", address: Address(city: "Oslo"))
print(carol[keyPath: cityPath])변수에 키 경로 저장하기
키 경로는 단순한 값이므로 변수에 저장하거나 함수에서 반환하거나 키 경로 모음으로 보관할 수 있습니다. 이를 통해 런타임에 읽을 프로퍼티를 결정할 수 있습니다.
여기서는 flag에 따라 저장된 두 키 경로 중 하나를 선택합니다.
struct Person {
let name: String
let age: Int
}
let showAge = true
let chosen: PartialKeyPath<Person> = showAge ? \Person.age : \Person.name
let dave = Person(name: "Dave", age: 27)
print(dave[keyPath: chosen])PartialKeyPath와 AnyKeyPath
스위프트에는 작은 키 경로 타입군이 있습니다. KeyPath<Root, Value>는 양쪽 끝의 타입을 모두 알고 있습니다. PartialKeyPath<Root>는 루트는 알지만 값의 타입은 지웁니다. AnyKeyPath는 두 타입을 모두 지웁니다.
타입 정보를 더 많이 유지할수록 컴파일러가 더 많은 부분을 검사할 수 있습니다. 값의 타입이 서로 다른 경로를 실제로 섞어야 할 때만 partial 형식이나 any 형식을 사용하세요.
struct Person {
let name: String
let age: Int
}
let paths: [PartialKeyPath<Person>] = [\.name, \.age]
let eve = Person(name: "Eve", age: 19)
for p in paths {
print(eve[keyPath: p])
}타입을 알고 있을 때의 간략한 표기
문맥을 통해 루트 타입을 이미 알고 있다면 타입 이름을 생략하고 백슬래시, 점, 프로퍼티만 작성할 수 있습니다. 컴파일러가 루트를 추론합니다.
이 간략한 표기를 사용하면 호출 위치가 짧아집니다. 특히 요소 타입이 명확한 컬렉션 연산 안에서 유용합니다.
struct Person {
let name: String
let age: Int
}
func value(of person: Person, at path: KeyPath<Person, Int>) -> Int {
person[keyPath: path]
}
let frank = Person(name: "Frank", age: 55)
print(value(of: frank, at: \.age))함수 인수로 사용하는 키 경로
일반적인 패턴은 키 경로를 받아 여러 인스턴스에 적용하는 제네릭 함수입니다. 이렇게 하면 무엇을 읽을지와 읽기 작업을 수행하는 로직을 분리할 수 있습니다.
여기서는 제네릭 도우미가 people 목록에서 어떤 타입의 프로퍼티든 추출합니다.
struct Person {
let name: String
let age: Int
}
func extract<T>(_ people: [Person], _ path: KeyPath<Person, T>) -> [T] {
people.map { $0[keyPath: path] }
}
let people = [Person(name: "Ana", age: 21), Person(name: "Ben", age: 34)]
print(extract(people, \.name))
print(extract(people, \.age))키 경로와 계산 프로퍼티
읽기 전용 키 경로는 계산 프로퍼티와도 함께 사용할 수 있습니다. 경로에 계산 과정이 담기므로 이를 통해 읽으면 게터가 실행됩니다.
따라서 키 경로는 저장된 프로퍼티로 제한되지 않으며, 읽을 수 있는 프로퍼티라면 무엇이든 사용할 수 있습니다.
struct Rectangle {
let width: Double
let height: Double
var area: Double { width * height }
}
let areaPath = \Rectangle.area
let r = Rectangle(width: 3, height: 4)
print(r[keyPath: areaPath])자기 자신을 가리키는 키 경로
값 전체 자체를 가리키는 특별한 키 경로가 있습니다. 백슬래시와 점 뒤에 self를 작성하면 됩니다. 이를 통해 읽으면 인스턴스가 변경되지 않은 상태로 반환됩니다.
요소 자체를 사용하고 싶지만 API가 키 경로를 요구할 때 유용합니다. 예를 들어 숫자 자체를 기준으로 정렬할 때 사용할 수 있습니다.
let numbers = [3, 1, 2]
let identity = \Int.self
for n in numbers {
print(n[keyPath: identity])
}키 경로 비교하기
키 경로는 Hashable과 Equatable을 따릅니다. 같은 타입의 같은 프로퍼티를 가리키는 두 키 경로는 서로 같으므로 집합에 저장하거나 사전 키로 사용할 수 있습니다.
프로퍼티를 레이블이나 서식 지정기에 매핑하는 표를 만들 때 유용합니다.
struct Person {
let name: String
let age: Int
}
let labels: [PartialKeyPath<Person>: String] = [
\Person.name: "Full Name",
\Person.age: "Years Old"
]
print(labels[\Person.age] ?? "unknown")빠른 확인: 키 경로로 읽기
키 경로를 통해 프로퍼티를 읽는 방법에 대한 이해도를 확인해 보세요.
복습: 키 경로 기초
키 경로의 기초를 배웠습니다.
- 키 경로는 백슬래시, 루트 타입, 점, 프로퍼티 이름으로 작성하며, 프로퍼티를 읽지 않고도 해당 프로퍼티를 나타냅니다.
- 인스턴스에서
[keyPath:]서브스크립트를 사용해 값을 읽습니다. - 경로를 중첩 프로퍼티까지 연결하거나 계산 프로퍼티를 대상으로 지정할 수 있습니다.
KeyPath,PartialKeyPath,AnyKeyPath는 타입 안전성과 유연성 사이에서 서로 다른 선택을 제공합니다.- 키 경로는 값이므로 저장하고 전달하고 비교할 수 있으며, 사전 키로도 사용할 수 있습니다.
다음에는 키 경로를 사용해 컬렉션 연산을 훨씬 간결하게 만드는 방법을 배웁니다.
struct Person {
let name: String
let age: Int
}
let path = \Person.age
let gina = Person(name: "Gina", age: 48)
print("Read via key path: \(gina[keyPath: path])")자주 묻는 질문
“KeyPath 기초” 강의는 무료인가요?
네 — “KeyPath 기초” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Swift Academy 강의 전체를 잠금 해제할 수 있습니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“KeyPath 기초”에서 뭘 배우나요?
속성을 일급 값으로 참조합니다. 브라우저에서 직접 실행하는 실습 코드로 Swift Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Swift Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Swift Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“KeyPath 기초” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Swift Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Swift Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.