做網路開發時,App 要與伺服器透過 HTTP URL 溝通。如果網址裡含有中文、空白,或是要上傳圖片被轉成 Base64 的字串,直接拼接就會出問題——這些字元不在 URL 的合法字元集裡,伺服器收到的路徑會跟你想的不一樣。反過來,伺服器回傳的內容若經過編碼,客戶端也得解回來才能正確顯示。
做法是利用 CoreFoundation 的 CFURLCreateStringByAddingPercentEscapes,並透過第四個參數指定「哪些字元不要 escape」。這裡刻意把 ! * ' ( ) ; : @ & = + $ , / ? % # [ ] 全部列入,因為它們在 URL 中有語意,不能隨便被轉掉。
- (NSString *)URLEncodedString:(NSString *)str {
NSString *encodedString = (NSString *)CFBridgingRelease(
CFURLCreateStringByAddingPercentEscapes(
kCFAllocatorDefault,
(CFStringRef)str,
NULL,
(CFStringRef)@"!*'();:@&=+$,/?%#[]",
kCFStringEncodingUTF8));
return encodedString;
}
- (NSString *)URLDecodedString:(NSString *)str {
NSString *decodedString = (__bridge_transfer NSString *)
CFURLCreateStringByReplacingPercentEscapesUsingEncoding(
NULL,
(__bridge CFStringRef)str,
CFSTR(""),
CFStringConvertNSStringEncodingToEncoding(NSUTF8StringEncoding));
return decodedString;
}
NSString *readyEcodeStr = @"adsfa asdfa s+asdf"; NSString *ecodeStr = [self URLEncodedString:readyEcodeStr]; NSLog(@"readyEcodeStr=%@ ecodeStr=%@", readyEcodeStr, ecodeStr);
輸出的結果符合預期:
readyEcodeStr=adsfa asdfa s+asdf
ecodeStr=adsfa%20asdfa%20s%2Basdf
可以看到空白被轉成 %20,加號被轉成 %2B——這一步非常關鍵,因為在 query string 的慣例中「+」本身代表空白,若不轉義就會被伺服器誤解。
如果只是要處理 query 參數,iOS 7 之後提供了更簡潔的 API,不必動用 CoreFoundation:
NSString *encoded = [str stringByAddingPercentEncodingWithEncoding:NSUTF8StringEncoding]; NSString *decoded = [encoded stringByRemovingPercentEncoding];
這兩個方法在 Swift 與後續 iOS 版本中都是官方建議做法,程式碼更短、記憶體管理也由 ARC 全權處理,不會有 CFBridgingRelease 寫錯導致洩漏的風險。