快速将国家代码和其他唯一字符串转换为 emoji 表情旗帜

用法

let usa = "us".flag() // "🇺🇸"
let england = "gb-eng".flag() // "🏴󠁧󠁢󠁥󠁮󠁧󠁿"
let un = "un".flag() // "🇺🇳"
let chequered = "chequered".flag() // "🏁"

演示

查看 Veximoji-Example iOS 应用程序。

安装

只需遵循标准的 SPM 约定

Swift Package Manager

手动安装

将 package(url: "https://github.com/roz0n/Veximoji.git", from: "2.0.0") 添加到您应用程序的 Package.swift 文件中。

通过 Xcode

在 Xcode 中打开您的项目，并从状态栏菜单中选择 File > Swift Packages > Add Package Dependency。
粘贴 HTTPS Github 链接：https://github.com/roz0n/Veximoji.git 并点击 Next。
您将被要求定义软件包选项。Up to Next Major 是一个安全的默认选项，它接受任何版本直到下一个主要版本，点击 Next 继续。

一旦软件包完成下载，您应该在左侧的 Project Navigator 中看到它列出。同样，您可以随意选择项目文件，并且 Veximoji 应该在 Swift Packages 选项卡下列出。 Xcode 也会自动将其添加到您的主项目目标下的 “Frameworks, Libraries, and Embedded Content” 标题下。

CocoaPods

CocoaPods 支持正在开发中。

API

Veximoji API 非常简洁且文档齐全。它将 emoji 表情旗帜组织成四个不同的类别

类别	定义	示例
`国家/地区`	具有 ISO 3611-1 alpha-2 代码的国家/地区的旗帜	`JP`
`细分`	具有 ISO 3611-2 代码的细分的旗帜	`GB-ENG`
`国际`	为特殊保留的 ISO 3166-1 alpha-2 代码的旗帜	`EU` 或 `UN`
`独特`	与个别国家或细分无关的旗帜	`.pirate` 或 `"pirate"`

类别

以上每个类别都通过公开的简写变量以数组形式提供

`typealias EmojiFlagCategory`

Veximoji.FlagCategories 的类型别名，一个枚举，表示上述类别。

`EmojiFlagCountryCodes: [String]`

计算并返回所有受支持的 ISO 3166-1 国家/地区代码。

`EmojiFlagSubdivisionCodes: [String]`

计算并返回所有受支持的 ISO 3166-2 细分代码。

`EmojiFlagInternationalCodes: [String]`

计算并返回所有受支持的特殊保留的 ISO 3166-1 代码。

辅助方法

`String.flag(term:) -> String?`

如果字符串存在于 FlagCategory 中，则将任何字符串转换为其 emoji 表情旗帜对应物。

`country(code:) -> String?`

用于通过其 ISO 3611-1 alpha-2 代码渲染国家/地区的 emoji 表情旗帜

`subdivision(code:) -> String?`

用于通过其 ISO 3611-2 代码渲染给定细分的 emoji 表情旗帜

支持的代码

代码	旗帜
`GB-ENG`	🏴󠁧󠁢󠁥󠁮󠁧󠁿
`GB-SCT`	🏴󠁧󠁢󠁳󠁣󠁴󠁿
`GB-WLS`	🏴󠁧󠁢󠁷󠁬󠁳󠁿

`international(code:) -> String?`

用于渲染特殊保留的 ISO 3166-1 alpha-2 代码的旗帜

支持的代码

代码	旗帜
`EU`	🇪🇺
`UN`	🇺🇳

`unique(term:) -> String?`

指不对应于国家、地区或政府实体的 emoji 表情旗帜。例如，.pride 或 "pride" 指的是彩虹旗或骄傲旗。

支持的用例

用例	原始值	旗帜
`.pride`	`“pride”`	🏳️‍🌈
`.trans`	`“trans”`	🏳️‍⚧️
`.pirate`	`“pirate”`	🏴‍☠️
`.white`	`“white”`	🏳️
`.red`	`“red”`	🚩
`.black`	`“black”`	🏴
`.crossed`	`“crossed”`	🎌
`.chequered`	`“chequered”`	🏁

验证器

如果您想手动验证上述任何内容，验证方法会公开以方便您使用。

`validateISO3166_1(code:) -> Bool`

返回一个布尔值，指示给定的字符串是否为受支持的 ISO 3611 alpha-2 国家/地区代码，通过检查它是否包含在 CFLocaleCopyISOCountryCodes 集合中
有关受支持的国家/地区代码的更多信息，请访问 Apple Developer Documentation 的 CFLocaleCopyISOCountryCodes 页面

`validateISO3166_2(code:) -> Bool`

返回一个布尔值，指示给定的字符串是否为有效的 ISO 3611-2 细分代码
目前，仅支持英国的细分代码，因为它们是唯一具有 iOS 支持的 emoji 表情旗帜的细分

`validateExceptionalReservation(code:) -> Bool`

返回一个布尔值，指示给定的字符串是否为有效的 ISO 3166-1 特殊保留代码。
目前，仅支持 "EU" 和 "UN" 特殊保留代码，因为它们是唯一具有 iOS 支持的 emoji 表情旗帜的代码

支持

发送电子邮件至：arnold@rozon.org

许可证

MIT