为什么String.addingPercentEncoding()的返回值是可选的？

Question

String百分比转义方法的签名是:

func addingPercentEncoding(withAllowedCharacters: CharacterSet)
    -> String?

(这是stringByAddingPercentEncodingWithAllowedCharacters在Swift 2中.)

为什么这个方法返回一个可选的？

文档说该方法返回nil"如果转换不可能",但不清楚在什么情况下转义转换可能会失败:

• 使用UTF-8转义字符,这是一个完整的Unicode编码.任何有效的Unicode字符都可以使用UTF-8进行编码,因此可以进行转义.

• 我想也许该方法对允许的字符集和用于转义的字符之间的不良交互应用了某种形式的检查,但事实并非如此:无论允许的字符集是否包含"%",该方法都会成功,如果允许的char集为空,也会成功.

就目前而言,非可选的返回值似乎是强制进行无意义的错误检查.

Answer 1

我向Apple提交了一份关于此问题的错误报告,然后回复了 - 回复非常有帮助!

结果(令我惊讶的是)可以成功创建包含无配对UTF-16代理字符形式的无效Unicode的Swift字符串.这样的字符串可能导致UTF-8编码失败.以下是一些说明此行为的代码:

// Succeeds (wat?!):
let str = String(
    bytes: [0xD8, 0x00] as [UInt8],
    encoding: String.Encoding.utf16BigEndian)!

// Returns nil:
str.addingPercentEncoding(withAllowedCharacters:
    CharacterSet.alphanumerics)