Objective-C 로 iOS 개발을 진행할 때 CGRect, CGSize, CGPoint 와 같은 C 언어 기반 구조체 데이터를 디버깅 목적으로 로그에 출력해야 하는 경우가 빈번합니다. 구조체의 각 멤버 변수를 individually 접근하여 문자열로 포맷팅하는 것은 비효율적이며 가독성이 떨어집니다. UIKit 프레임워크는 이러한 구조체를 Objective-C 객체인 NSString 으로 손쉽게 변환할 수 있는 유틸리티 함수를 기본적으로 제공합니다.
예를 들어, 뷰의 프레임 정보나 오프셋 값을 로그로 남길 때 다음과 같이 helper 함수를 활용하면 코드가 간결해지고 유지보수가 용이해집니다.
// 구조체 값을 직접 생성하여 문자열로 변환 후 출력
CGRect viewFrame = CGRectMake(10.5, 20.0, 100.0, 50.0);
NSLog(@"Frame Information: %@", NSStringFromCGRect(viewFrame));
CGPoint originPoint = CGPointMake(0.0, 0.0);
NSLog(@"Origin Point: %@", NSStringFromCGPoint(originPoint));
CGSize contentSize = CGSizeMake(320.0, 480.0);
NSLog(@"Content Size: %@", NSStringFromCGSize(contentSize));
위 코드에서 사용된 NSStringFrom... 시리즈 함수들은 UIGeometry.h 헤더 파일에 정의되어 있습니다. 이 헤더 파일에는 기하학적 구조체 처리를 위한 다양한 인라인 함수와 변환 메서드가 포함되어 있으므로 참고하는 것이 좋습니다.
주요 변환 함수 목록은 다음과 같이 정리할 수 있습니다. 구조체를 문자열로 변환하는 함수와 반대로 문자열을 구조체로 파싱하는 함수가 쌍으로 존재합니다.
// 구조체 → NSString 변환 함수
NSString *NSStringFromCGPoint(CGPoint point);
NSString *NSStringFromCGSize(CGSize size);
NSString *NSStringFromCGRect(CGRect rect);
NSString *NSStringFromCGAffineTransform(CGAffineTransform transform);
NSString *NSStringFromUIEdgeInsets(UIEdgeInsets insets);
NSString *NSStringFromUIOffset(UIOffset offset);
// NSString → 구조체 변환 함수
CGPoint CGPointFromString(NSString *string);
CGSize CGSizeFromString(NSString *string);
CGRect CGRectFromString(NSString *string);
CGAffineTransform CGAffineTransformFromString(NSString *string);
UIEdgeInsets UIEdgeInsetsFromString(NSString *string);
UIOffset UIOffsetFromString(NSString *string);
또한, 이러한 구조체 데이터를 NSArray 나 NSDictionary 와 같은 컬렉션에 저장하거나 아카이빙해야 할 때는 NSValue 클래스의 확장 기능을 사용할 수 있습니다. NSValue 는 C 구조체를 객체로 래핑 (wrapping) 하여 Cocoa 컬렉션에서 사용할 수 있게 해줍니다.
@interface NSValue (NSValueUIGeometryExtensions)
+ (NSValue *)valueWithCGPoint:(CGPoint)point;
+ (NSValue *)valueWithCGSize:(CGSize)size;
+ (NSValue *)valueWithCGRect:(CGRect)rect;
+ (NSValue *)valueWithUIEdgeInsets:(UIEdgeInsets)insets;
+ (NSValue *)valueWithUIOffset:(UIOffset)insets;
- (CGPoint)CGPointValue;
- (CGSize)CGSizeValue;
- (CGRect)CGRectValue;
- (UIEdgeInsets)UIEdgeInsetsValue;
- (UIOffset)UIOffsetValue;
@end
데이터의 직렬화가 필요한 경우 NSCoder 를 통한 인코딩 및 디코딩 메서드도 지원됩니다. UIGeometryKeyedCoding 카테고리를 활용하면 구조체 값을 키 기반 인코딩 과정에 직접 포함시킬 수 있습니다.
@interface NSCoder (UIGeometryKeyedCoding)
- (void)encodeCGRect:(CGRect)rect forKey:(NSString *)key;
- (void)encodeCGSize:(CGSize)size forKey:(NSString *)key;
- (void)encodeUIEdgeInsets:(UIEdgeInsets)insets forKey:(NSString *)key;
- (CGRect)decodeCGRectForKey:(NSString *)key;
- (CGSize)decodeCGSizeForKey:(NSString *)key;
- (UIEdgeInsets)decodeUIEdgeInsetsForKey:(NSString *)key;
@end