NSValue

C나 Objective-C의 단일 데이터 항목에 대한 단순한 컨테이너

원문 출처

개요

NSValue 객체는 int, float 및 char와 같은 스칼라 타입뿐만 아니라 포인터, 구조체 및 객체 ID 참조를 포함할 수 있습니다. 콜렉션(예: 및 ), 및 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 메소드를 만들어서 저장 및 불러오기를 수행하고 있습니다:

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?

같이 보기

Value 래퍼와 변형

class NSNumber
원시 스칼라 숫자값에 대한 객체 래퍼
class ValueTransformer 하나의 표현형에서 다른 표현형으로 값을 변환하는데 사용되는 추상 클래스

PreviousObject Runtime NextUIKit

Last updated 5 years ago

원문 출처

개요

Subclassing Notes

오버라이드 할 메서드

서브클래스가 collection에서 잘 동작하도록 하려면 hash 메소드를 구현하는 것이 좋습니다.

서브클래싱의 대안

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?

같이 보기

Value 래퍼와 변형

class NSNumber
원시 스칼라 숫자값에 대한 객체 래퍼
class ValueTransformer 하나의 표현형에서 다른 표현형으로 값을 변환하는데 사용되는 추상 클래스

개요

Subclassing Notes

오버라이드 할 메서드

서브클래싱의 대안

주제

Working with Raw Values

Working with Pointer and Object Values

Working with Range Values

Working with Foundation Geometry Values

Working with CoreGraphics Geometry Values

Working with UIKit Geometry Values

Working with CoreAnimation Transform Values

Working with Media Time Values

Working with Geographic Coordinate Values

Working with SceneKit Vector and Matrix Values

Comparing Value Objects

Initializers

Instance Properties

Instance Methods

관련 문서

상속받은 대상

준수하는 프로토콜

같이 보기

Value 래퍼와 변형

개요

Subclassing Notes

오버라이드 할 메서드

서브클래싱의 대안

주제

Working with Raw Values

Working with Pointer and Object Values

Working with Range Values

Working with Foundation Geometry Values

Working with CoreGraphics Geometry Values

Working with UIKit Geometry Values

Working with CoreAnimation Transform Values

Working with Media Time Values

Working with Geographic Coordinate Values

Working with SceneKit Vector and Matrix Values

Comparing Value Objects

Initializers

Instance Properties

Instance Methods

관련 문서

상속받은 대상

준수하는 프로토콜

같이 보기

Value 래퍼와 변형