作者:Erica Sadun,原文链接,原文日期:2016-08-29
译者:Darren;校对:shanks;定稿:千叶知风
我在很多地方都表达了我对流的喜爱。我在 Swift Cookbook 中介绍了一些。现在,我将通过 Pearson 的内容更新计划更新 Swift 3 的相关内容,正好我有一些要说的。我想在文章中添加一些有趣的新配方。
今天,让我们谈谈『转换流』。你写 print(..., to:)
时传递的传统流,只是一个你传递给stdout、stderr或文件的一个目标而已。转换流会从根本上改变流经它的文本。你可以限制文本为全部小写,或者做拼写检查,甚至打印到你的平台的本地通知系统。
因此我决定创建一个翻译流。如截图所示,当你打印流的时候,会把英文文本转换成其他语言。
如图所示,我的解决方案充分利用了 Swift 标准库内置的 print 函数。Swift 允许打印到流。当使用我的 ItalianStream.shared
流时, 打印到控制台的内容被自动翻译成了我在流中提供的语言。
在我的实现中,我希望能够做到几个关键点:
- 所有特定的翻译功能都需要从打印流中分离,这样我可以在不打乱实现的情况下交换不同 API 提供的输入和输出。
- 我希望能使用多种语言。
- 我需要提供一个可重用的
var
成员,用于需要打印的流。
为了实现这些目标,我决定大量使用泛型和面向协议。我希望能够用一个泛型化的流类型来跟踪任意的语言,这反过来将为打印提供一个共享的流实例。这可能听起来有点绕。
标准库内置的 TextOutputStream
协议刚好满足了一个需求,一个接收一个字符串并做一些处理的方法。下面的代码翻译了字符串并打印了出来。
/// A text output stream that performs translation in
/// the process of printing
public struct TranslationStream<Language: EnglishTranslationProvider>: TextOutputStream {
/// Writes the contents of the string to stdout after
/// passing the string through an automatic translator
public func write(_ string: String) {
guard let translation = Language.translate(string) else { return }
print(translation)
}
}
比较 tricky 的是我的 TranslationStream
结构是泛型。它需要一个遵循 EnglishTraslationProvider
协议的类型,允许其从 provider 请求翻译。这是协议的内容:
/// A provider of string translations from English
public protocol EnglishTranslationProvider {
/// Returns a shared instance of the provider
static var shared: TranslationStream<Self> { get }
/// Returns a translated string
static func translate(_ string: String) -> String?
}
每个语言翻译的 provider 提供一个 shared
翻译流给 TranslationStream
类型供 打印时使用(就像在 ItalianStream.shared
的截图中所看到的那样 ),以及一个 translate
方法来返回字符串翻译后的版本。例如,这是法语 provider 类型的实现:
/// A stream type that automatically translates from English to French
public struct FrenchStream: EnglishTranslationProvider {
/// Returns a shared instance of the provider
public static var shared = TranslationStream<FrenchStream>()
/// Returns a translated string
public static func translate(_ string: String) -> String? {
return FrenchStream.translate(string, language: "fr")
}
}
很简单吧?这真的不难。它实现了两个必要的成员,另一方面作为在协议扩展中声明的默认 translate
方法的代理。我的具体实现用了两个字符的语言代码,并通过 Google 翻译成英语。我在这里并没有包含实际的translate(_ string:, language:)
方法,因为有很多易使用的 API可供选择,它们一般都需要 API key 和费用。
我试图让本文的重点是『哇,6666,你可以在打印流时转换文本。』,而不是『哦,翻译了。』。我认为翻译流是展示这个特定的 Swift 特性的好方式。
在下面的截图中,我把(第20行)打印到了用户的通知栏。
本文由 SwiftGG 翻译组翻译,已经获得作者翻译授权,最新文章请访问 http://swift.gg。