# NSValue > 원문 출처\ > ## 개요 NSValue 객체는 int, float 및 char와 같은 스칼라 타입뿐만 아니라 포인터, 구조체 및 객체 ID 참조를 포함할 수 있습니다. 콜렉션(예: [NSArray](https://melod-it.gitbook.io/sagwa/etc/not-found) 및 [NSSet](https://melod-it.gitbook.io/sagwa/etc/not-found)), [Key-Value Coding](https://melod-it.gitbook.io/sagwa/etc/not-found) 및 Objective-C 객체가 필요한 기타 API에 이러한 데이터 타입을 사용해야 할 경우 이 클래스를 사용하세요. NSValue 객체는 변경 불가능(immutable)합니다. ## Subclassing Notes 추상 NSValue 클래스는 주어진 상황에 적합한 값 객체를 만들고 반환하는 private, concrete 클래스로 구성된 클래스 클러스터의 공용 인터페이스입니다. NSValue를 서브 클래스할 수는 있지만 그렇게 하려면 (하위 클래스에 상속되지 않는)값에 대한 저장 기능을 제공하고 두 가지 기본 메서드를 구현해야합니다. ### 오버라이드 할 메서드 NSValue의 서브클래스는 기본 인스턴스 메서드인 getValue(\_:)와 objCType을 오버라이드해야 합니다. 이 메서드들은 값을 제공하는 스토리지에서 동작되어야 합니다. 제공할 스토리지에 알맞는 서브클래스 이니셜라이저를 구현하고 싶을 수도 있습니다. NSValue 클래스는 지정된 이니셜라이저가 없기 때문에 구현할 이니셜라이저가 호출해야 할 것은 슈퍼 클래스의 init() 메서드 뿐입니다. NSValue 클래스는 NSCopying과 NSSecuerCoding 프로토콜을 준수합니다. copying이나 coding을 통해서 커스텀 서브클래스의 인스턴스를 생성하고자 한다면 이들 프로토콜의 메서드를 오버라이드하세요. 서브클래스가 collection에서 잘 동작하도록 하려면 hash 메소드를 구현하는 것이 좋습니다. ### 서브클래싱의 대안 커스텀 데이터 타입이나 구조체를 감싸는 목적으로만 NSValue를 사용하는 것이라면 NSValue의 서브클래스를 꼭 생성할 필요는 없습니다. 대신에 기존의 NSValue 메서드를 사용해서 커스텀 타입 데이터를 저장하고 불러올 수 있습니다. 예를 들어 아래의 코드는 Polyhedron 커스텀 구조체를 정의하고, NSValue convenience 메소드를 만들어서 저장 및 불러오기를 수행하고 있습니다: ```objectivec typedef struct { int numFaces; float radius; } Polyhedron; @interface NSValue (Polyhedron) + (instancetype)valuewithPolyhedron:(Polyhedron)value; @property (readonly) Polyhedron polyhedronValue; @end @implementation NSValue (Polyhedron) + (instancetype)valuewithPolyhedron:(Polyhedron)value { return [self valueWithBytes:&value objCType:@encode(Polyhedron)]; } - (Polyhedron) polyhedronValue { Polyhedron value; [self getValue:&value]; return value; } @end ``` ## 주제 ### Working with Raw Values * init(bytes: UnsafeRawPointer, objCType: UnsafePointer)\ 주어진 값이 지정된 Objective-C 타입으로 변환된 값을 포함하는 객체를 초기화 합니다. * init(UnsafeRawPointer, withObjCType: UnsafePointer)\ 주어진 값이 지정된 Objective-C 타입으로 변환된 값 객체(value object)를 생성합니다. * func getValue(UnsafeMutableRawPointer) ~~Copies the value into the specified buffer.~~ `Deprecated` * var objCType: UnsafePointer\ 값 객체에 포함된 데이터의 Objective-C 타입을 보유하는 C 문자열 ### Working with Pointer and Object Values * init(pointer: UnsafeRawPointer?)\ 포인터를 포함하는 값 객체를 생성합니다. * init(nonretainedObject: Any?)\ non-retained 객체를 포함하는 값 객체를 생성합니다. * var pointerValue: UnsafeMutableRawPointer?\ 타입지정되지 않은 포인터를 값으로 반환합니다. * var nonretainedObjectValue: Any? non-retained 객체를 반환합니다. ### Working with Range Values * init(range: NSRange)\ Foundation range 구조체를 포함하는 새 값 객체를 생성합니다. * var rangeValue: NSRange\ Foundation range 구조체 표현값 ### Working with Foundation Geometry Values * init(point: NSPoint)\ Foundation point 구조체를 포함하는 값 객체를 생성합니다. * init(size: NSSize) Foundation size 구조체를 포함하는 값 객체를 생성합니다. * init(rect: NSRect) Foundation rectangle 구조체를 포함하는 값 객체를 생성합니다. * var pointValue: NSPoint Foundation point 구조체 표현 * var sizeValue: NSSize Foundation size 구조체 표현 * var rectValue: NSRect Foundation rectangle 구조체 표현 ### Working with CoreGraphics Geometry Values * init(cgPoint: CGPoint) CoreGrapics point 구조체를 포함하는 값 객체를 생성합니다. * init(cgVector: CGVector) CoreGrapics vector 구조체를 포함하는 값 객체를 생성합니다. * init(cgSize: CGSize) CoreGrapics size 구조체를 포함하는 값 객체를 생성합니다. * init(cgRect: CGRect) CoreGrapics rectangle 구조체를 포함하는 값 객체를 생성합니다. * init(cgAffineTransform: CGAffineTransform) CoreGrapics affine transform 구조체를 포함하는 값 객체를 생성합니다. * var cgPointValue: CGPoint\ CoreGraphics point 구조체 반환합니다. * var cgVectorValue: CGVector\ CoreGraphics vector 구조체를 반환합니다. * var cgSizeValue: CGSize\ CoreGraphics size 구조체를 반환합니다. * var cgRectValue: CGRect\ CoreGraphics rectangle 구조체를 반환합니다. * var cgAffineTransformValue: CGAffineTransform CoreGraphics affine transform을 반환합니다. ### Working with UIKit Geometry Values * init(uiEdgeInsets: UIEdgeInsets) UIKit edge inset 구조체를 포함하는 값 객체를 생성합니다. * init(uiOffset: UIOffset) UIKit offset 구조체를 포함하는 값 객체를 생성합니다. * var uiEdgeInsetsValue: UIEdgeInsets\ UIKit edge inset 구조체 반환합니다. * var uiOffsetValue: UIOffset UIKit offset 구조체를 반환합니다. ### Working with CoreAnimation Transform Values * init(caTransform3D: CATransform3D) CoreAnimation transform 구조체를 포함하는 값 객체를 생성합니다. * var caTransform3DValue: CATransform3D\ CoreAnimation transform 구조체를 반환합니다. ### Working with Media Time Values * init(time: CMTime) CoreMedia time 구조체를 포함하는 값 객체를 생성합니다. * init(timeRange: CMTimeRange) CoreMedia time range 구조체를 포함하는 값 객체를 생성합니다. * init(timeMapping: CMTimeMapping) CoreMedia time mapping 구조체를 포함하는 값 객체를 생성합니다. * var timeValue: CMTime\ CoreMedia time 구조체를 반환합니다. * var timeRangeValue: CMTimeRange\ CoreMedia time range 구조체를 반환합니다. * var timeMappingValue: CMTimeMapping\ CoreMedia time mapping 구조체를 반환합니다. ### Working with Geographic Coordinate Values * init(mkCoordinate: CLLocationCoordinate2D) CoreLocation geographic coordinate 구조체를 포함하는 값 객체를 생성합니다. * init(mkCoordinateSpan: MKCoordinateSpan) MapKit coordinate span 구조체를 포함하는 값 객체를 생성합니다. * var mkCoordinateValue: CLLocationCoordinate2D\ CoreLocation geographic coordinate 구조체를 반환합니다. * var mkCoordinateSpanValue: MKCoordinateSpan\ MapKit coordinate span 구조체를 반환합니다. ### Working with SceneKit Vector and Matrix Values * init(scnVector3: SCNVector3) Three-element SceneKit vector를 포함하는 값 객체를 생성합니다. * init(scnVector4: SCNVector4) Four-element SceneKit vector를 포함하는 값 객체를 생성합니다. * init(scnMatrix4: SCNMatrix4) SceneKit 4 x 4 matrix를 포함하는 값 객체를 생성합니다. * var scnVector3Value: SCNVector3\ three-element Scene Kit vector를 반환합니다. * var scnVector4Value: SCNVector4\ four-element Scene Kit vector를 반환합니다. * var scnMatrix4Value: SCNMatrix4\ Scene Kit 4 x 4 matrix를 반환합니다. ### Comparing Value Objects * func isEqual(to: NSValue) -> Bool 값 객체와 다른 값 객체가 동일한지를 알려주는 Boolean 값을 반환합니다. ### Initializers * init?(coder: NSCoder) * init(directionalEdgeInsets: NSDirectionalEdgeInsets) * init(edgeInsets: NSEdgeInsets) ### Instance Properties * var directionalEdgeInsetsValue: NSDirectionalEdgeInsets * var edgeInsetsValue: NSEdgeInsets ### Instance Methods * func getValue(UnsafeMutableRawPointer, size: Int) * func value(of: StoredType.Type) -> StoredType? ## 관련 문서 ### 상속받은 대상 * NSObject ### 준수하는 프로토콜 * CVarArg * Equatable * Hashable * NSCopying * NSSecureCoding ## 같이 보기 ### Value 래퍼와 변형 * *class* NSNumber 원시 스칼라 숫자값에 대한 객체 래퍼 * *class* ValueTransformer\ 하나의 표현형에서 다른 표현형으로 값을 변환하는데 사용되는 추상 클래스 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://melod-it.gitbook.io/sagwa/app-frameworks/foundation/object-runtime/nsvalue.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.