萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> iOS 開發

iOS 整數類型完全指南:int、NSInteger、NSUInteger、NSNumber 選型與轉換

iOS 開發涉及四種整數表示形式,理解它們的定義、適用場景與相互轉換,能避免 32/64 位截斷、有符號無符號混淆、集合存儲等經典 Bug。

類型定義與關係

類型本質位寬範圍適用場景
intC 基本類型32 位 (固定)-2^31 ~ 2^31-1純 C 邏輯、OpenGL ES、第三方 C 庫交互
NSIntegertypedef**架構相關**
32位: 32bit
64位: 64bit
平台相關**Cocoa API 通用整數** (索引、計數、標籤、枚舉底層)
NSUIntegertypedef同上0 ~ 2^位寬-1**無符號場景**:數組索引、長度、計數、位掩碼
NSNumber**類 (對象)**封裝任意基本類型同上**集合存儲**、Key-Value Coding、Core Data、JSON 序列化、跨語言橋接

定義源碼 (NSObjCRuntime.h)

#if __LP64__ || TARGET_OS_EMBEDDED || TARGET_OS_IPHONE || TARGET_OS_WIN32 || NS_BUILD_32_LIKE_64
typedef long NSInteger;
typedef unsigned long NSUInteger;
#else
typedef int NSInteger;
typedef unsigned int NSUInteger;
#endif

結論: 現代 iOS/macOS (64 位) 下,NSInteger = long = 64 位,NSUInteger = unsigned long = 64 位。

選型決策樹

  1. 需放入 NSArray/NSDictionary/NSSet → NSNumber (對象)
  2. 調用 Cocoa API 參數/返回值 → NSInteger/NSUInteger (匹配 SDK)
  3. 純邏輯計算、位運算、性能敏感 → int64_t / uint64_t / int32_t (固定寬度,<stdint.h>)
  4. 與 C/C++ 庫交互 → 對方要求什麼類型傳什麼,必要時轉換。

NSNumber 裝箱/拆箱

// 裝箱
NSNumber *numInt = @42;                    // 字面量語法 (推薦)
NSNumber *numLong = @(1234567890123L);
NSNumber *numBool = @YES;
NSNumber *numFloat = @3.14f;

// 拆箱
int i = [numInt intValue];
long l = [numLong longValue];
BOOL b = [numBool boolValue];
float f = [numFloat floatValue];
NSString *str = [numInt stringValue]; // "42"

// 格式化輸出
NSLog(@"%@", numInt);       // 42
NSLog(@"%ld", (long)[numLong longValue]); // 1234567890123

常見陷阱與避坑

1. 32/64 位截斷

// 錯誤:64 位值賦給 32 位 int
NSInteger large = 3000000000; // 30 億
int truncated = (int)large;   // 截斷為 -1294967296 (溢出)

// 正確:統一用 NSInteger 或 int64_t
NSInteger correct = large;    // 保持 30 億

2. 有符號/無符號比較陷阱

NSUInteger count = 0;
for (NSInteger i = 0; i < count - 1; i++) { // 當 count=0 時,count-1 = UINT_MAX (極大值) → 死循環/越界
    // ...
}

// 正確寫法
if (count > 0) {
    for (NSInteger i = 0; i < count - 1; i++) { ... }
}
// 或用 NSUInteger 變量
for (NSUInteger i = 0; i + 1 < count; i++) { ... }

3. 集合存儲基本類型

// ❌ 編譯錯誤:基本類型非對象
NSArray *arr = @[@1, @2, @3]; // 正確:字面量自動裝箱為 NSNumber
// 或
[array addObject:@(primitiveInt)];

4. 格式化字符串陷阱

NSInteger val = 100;
NSLog(@"%d", val);   // ⚠️ 32 位下正常,64 位下 %d 只讀 32 位 → 輸出錯誤
NSLog(@"%ld", (long)val); // ✅ 正確:%ld 對應 long (NSInteger 在 64 位下是 long)
NSLog(@"%@", @(val));     // ✅ 最安全:NSNumber 字面量

Swift 映射關係

OC 類型Swift 類型備註
NSIntegerInt平台相關,Swift Int 也是架構相關
NSUIntegerUInt同上
intInt32固定 32 位
NSNumberNSNumber / Int (橋接)自動橋接,let n: NSNumber = 42

總結

  • 默認用 NSInteger/NSUInteger 對接 Cocoa API。
  • 集合存儲必用 NSNumber (或字面量 @(...))。
  • 固定寬度用 int32_t/int64_t 做序列化/網絡協議/文件格式。
  • 格式化字符串用 %ld/%lu 或 %@ 避免 32/64 位 Bug。

類型嚴謹,代碼無憂。

copyright © 萬盛學電腦網 all rights reserved