Swift Academy · 강의

래퍼 만들기, projectedValue

사용자 지정 래퍼를 만들고 wrappedValue 를 구성한 다음, projectedValue ( $ )로 메타데이터와 도우미를 제공합니다.

래퍼 만들기, projectedValue은(는) CoddyKit의 무료 Swift Academy 강의입니다. 이것은 3개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Swift Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Swift Academy 강의에는 총 3개의 강의가 포함되어 있습니다.

프로퍼티 래퍼를 사용하는 이유

프로퍼티 래퍼는 프로퍼티가 저장되고 읽히는 방식을 관리하는 재사용 가능한 타입입니다:

wrappedValue: 공개 값
projectedValue: $를 통한 추가 API
초기화 구문/인수를 통한 구성

Clamped와 투영 플래그

@Clamped는 숫자를 범위 안으로 제한합니다. projectedValue($hp)는 마지막 설정에서 clamped가 적용되었는지 알려 줍니다.

@propertyWrapper
struct Clamped {
    private var value: Int
    private let range: ClosedRange<Int>
    private(set) var wasClampedLastSet = false

    var wrappedValue: Int {
        get { value }
        set {
            let clamped = min(max(newValue, range.lowerBound), range.upperBound)
            wasClampedLastSet = (clamped != newValue)
            value = clamped
        }
    }

    var projectedValue: Bool { wasClampedLastSet } // $prop -> was it clamped?

    init(wrappedValue: Int, range: ClosedRange<Int>) {
        self.range = range
        let clamped = min(max(wrappedValue, range.lowerBound), range.upperBound)
        self.value = clamped
        self.wasClampedLastSet = (clamped != wrappedValue)
    }
}

struct Player {
    @Clamped(range: 0...100) var hp: Int = 120  // init clamps to 100
}

var p = Player()
print(p.hp)     // 100
p.hp = -5
print(p.hp, p.$hp)  // 0 true (was clamped)

정규화 및 대체 뷰

래퍼는 입력을 변환할 수 있습니다(공백 제거/소문자화). $property는 편리한 대체 형식을 노출할 수 있습니다.

@propertyWrapper
struct Normalized {
    private var storage: String = ""
    var wrappedValue: String {
        get { storage }
        set { storage = newValue.trimmingCharacters(in: .whitespacesAndNewlines).lowercased() }
    }
    var projectedValue: String { storage.uppercased() } // alternate view

    init(wrappedValue: String) { self.wrappedValue = wrappedValue }
}

struct User {
    @Normalized var username: String = "  Alice  "
}
let u = User()
print(u.username)   // "alice"
print(u.$username)  // "ALICE" (projected)

구성 가능한 래퍼

래퍼에 인수를 전달하세요(예: 길이). 프로퍼티를 설정할 때마다 래퍼가 형식을 적용합니다.

@propertyWrapper
struct Padded {
    private var value: String
    private let length: Int
    var wrappedValue: String {
        get { value }
        set {
            let s = newValue
            value = s.count >= length ? String(s.prefix(length))
                                      : s + String(repeating: " ", count: length - s.count)
        }
    }
    var projectedValue: Int { value.count } // current width
    init(wrappedValue: String, length: Int) {
        self.length = length
        self.value = ""
        self.wrappedValue = wrappedValue
    }
}

struct Row {
    @Padded(length: 6) var code: String = "AB"
}
var r = Row()
print("|\(r.code)|")   // |AB    |
print(r.$code)        // 6

$value를 통한 History

projectedValue를 사용하면 기본 값 API를 복잡하게 만들지 않고 변경 이력 같은 메타데이터를 노출할 수 있습니다.

@propertyWrapper
struct History<Value> {
    private var value: Value
    private(set) var changes: [Value] = []
    var wrappedValue: Value {
        get { value }
        set { changes.append(value); value = newValue }
    }
    var projectedValue: [Value] { changes } // $prop -> previous values
    init(wrappedValue: Value) { self.value = wrappedValue }
}

struct Settings {
    @History var level: Int = 1
}
var s = Settings()
s.level = 2
s.level = 3
print(s.level)    // 3
print(s.$level)   // [1, 2]

설계 지침

팁:

래퍼를 작고 목적에 집중하도록 유지하세요.
$projectedValue가 무엇을 노출하는지 문서화하세요.
순수 변환을 우선하고, 무거운 부작용은 피하세요.
명확한 초기화 구문과 합리적인 기본값을 제공하세요.

투영 값의 목적

빠른 확인: 래퍼에서 $property는 무엇에 사용하나요?

복습

복습: @propertyWrapper를 wrappedValue와 함께 구현하고, projectedValue($)를 통해 도우미/플래그/이력을 노출하며, 초기화 구문으로 동작을 구성하세요.

자주 묻는 질문

“래퍼 만들기, projectedValue” 강의는 무료인가요?

네 — “래퍼 만들기, projectedValue” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Swift Academy 강의 전체를 잠금 해제할 수 있습니다. Swift Academy 강의에는 총 3개의 강의가 포함되어 있습니다.

“래퍼 만들기, projectedValue”에서 뭘 배우나요?

사용자 지정 래퍼를 만들고 wrappedValue 를 구성한 다음, projectedValue ( $ )로 메타데이터와 도우미를 제공합니다. 브라우저에서 직접 실행하는 실습 코드로 Swift Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Swift Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Swift Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 3개 중 1번째 강의입니다.

“래퍼 만들기, projectedValue” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Swift Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Swift Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Swift Academy(으)로 돌아가기