[转]Swift中的标准函数

本文转自cocoaChina，原文链接：点这里

　　Swift中的标准函数

　　本文将列举Swift所有的内建函数。本文中提到的所谓的内建函数是指那些在Swift中不需要导入任何模块（如Foundation等）或者引用任何类就可以使用的函数。

Swift中共有74个内建函数，但是在Swift官方文档（“The Swift Programming Language”）中只记录了7中。剩下的67个都没有记录。

本文将列举Swift所有的内建函数。本文中提到的所谓的内建函数是指那些在Swift中不需要导入任何模块（如Foundation等）或者引用任何类就可以使用的函数。

abs(signedNumber): 返回给定的有符号数字的绝对值。很简单，但是没有在文档中记录。

1 abs(-1) == 1
2 abs(-42) == 42
3 abs(42) == 42 

contains(sequence, element): 如果给定的序列（如数组）包含特定的元素，则返回true。

1 var languages = ["Swift", "Objective-C"]
2 contains(languages, "Swift") == true
3 contains(languages, "Java") == false
4 contains([29, 85, 42, 96, 75], 42) == true 

dropFirst(sequence): 返回一个去掉第一个元素的新序列（如数组）。

var languages = ["Swift", "Objective-C"]
var oldLanguages = dropFirst(languages)
equal(oldLanguages, ["Objective-C"]) == true

dropLast(sequence): 返回一个的新序列（如数组），该序列去掉作为参数传递给函数的最后一个元素。

var languages = ["Swift", "Objective-C"]
var newLanguages = dropLast(languages)
equal(newLanguages, ["Swift"]) == true

dump(object): 一个对象的内容转储到标准输出。

 1 var languages = ["Swift", "Objective-C"]
 2
 3 dump(languages)
 4
 5 // Prints:
 6
 7 // ? 2 elements
 8
 9 // - [0]: Swift
10
11 // - [1]: Objective-C 

equal(sequence1, sequence2): 如果序列1和序列2包含相同的元素，则返回true。

1 var languages = ["Swift", "Objective-C"]
2
3 equal(languages, ["Swift", "Objective-C"]) == true
4
5 var oldLanguages = dropFirst(languages)
6
7 equal(oldLanguages, ["Objective-C"]) == true 

filter(sequence, includeElementClosure): 返回序列的一个元素，这个元素满足includeElementClosure所指定的条件。

 1 for i in filter(1...100, { $0 % 10 == 0 })
 2
 3 {
 4
 5 // 10, 20, 30, ...
 6
 7     println(i)
 8
 9     assert(contains([10, 20, 30, 40, 50, 60, 70, 80, 90, 100], i))
10
11 } 

find(sequence, element): 再给定的序列中返回一个指定的索引，如果在序列中没有找到这个元素就返回nil。

1 var languages = ["Swift", "Objective-C"]
2
3 find(languages, "Objective-C") == 1
4
5 find(languages, "Java") == nil
6
7 find([29, 85, 42, 96, 75], 42) == 2 

indices(sequence): 在指定的序列中返回元素的索引（零索引）。

1 equal(indices([29, 85, 42]), [0, 1, 2])
2 for i in indices([29, 85, 42]) {
3
4 // 0, 1, 2
5
6     println(i)
7
8 } 

join(separator, sequence): 返回一个由给定的分隔符分离出来的序列的元素。

1 join(":", ["A", "B", "C"]) == "A:B:C"
2
3 var languages = ["Swift", "Objective-C"]
4
5 join("/", languages) == "Swift/Objective-C" 

map(sequence, transformClosure): 如果transformClosure适用于所给序列中所有的元素，则返回一个新序列。

 1 equal(map(1...3, { $0 * 5 }), [5, 10, 15])
 2 for i in map(1...10, { $0 * 10 }) {
 3
 4 // 10, 20, 30, ...
 5
 6     println(i)
 7
 8     assert(contains([10, 20, 30, 40, 50, 60, 70, 80, 90, 100], i))
 9
10 } 

max(comparable1, comparable2, etc.): 返回函数所给参数中的最大值。

1 max(0, 1) == 1
2 max(8, 2, 3) == 8 

maxElement(sequence): 返回所给序列的同类元素中的最大元素。

1 maxElement(1...10) == 10
2 var languages = ["Swift", "Objective-C"]
3
4 maxElement(languages) == "Swift" 

minElements(sequence): 返回所给序列的同类元素中的最小元素。

1 minElement(1...10) == 1
2 var languages = ["Swift", "Objective-C"]
3
4 minElement(languages) == "Objective-C" 

reduce(sequence, initial, combineClosure): 从第一个初始值开始对其进行combineClosure操作，递归式地将序列中的元素合并为一个元素。

1 var languages = ["Swift", "Objective-C"]
2
3 reduce(languages, "", { $0 + $1 }) == "SwiftObjective-C"
4
5 reduce([10, 20, 5], 1, { $0 * $1 }) == 1000 

reverse(sequence): 返回所给序列的倒序。

1 equal(reverse([1, 2, 3]), [3, 2, 1])
2 for i in reverse([1, 2, 3]) {
3
4 // 3, 2, 1
5
6     println(i)
7
8 } 

startsWith(sequence1, sequence2):如果序列1和序列2的起始元素相等，则返回true。

1 startsWith("foobar", "foo") == true
2
3 startsWith(10..100, 10..15) == true
4
5 var languages = ["Swift", "Objective-C"]
6
7 startsWith(languages, ["Swift"]) == true 

如下列表为Swift中的74个内建函数。上文所描述的函数是我认为在日常开发中比较有用处的。当然我可能遗漏了一些常用函数。欢迎大家在评论中讨论，并且请用一个简短的代码段来展示如何使用该函数。

 1 abs(...)
 2 advance(...)
 3 alignof(...)
 4 alignofValue(...)
 5 assert(...)
 6 bridgeFromObjectiveC(...)
 7 bridgeFromObjectiveCUnconditional(...)
 8 bridgeToObjectiveC(...)
 9 bridgeToObjectiveCUnconditional(...)
10 c_malloc_size(...)
11 c_memcpy(...)
12 c_putchar(...)
13 contains(...)
14 count(...)
15 countElements(...)
16 countLeadingZeros(...)
17 debugPrint(...)
18 debugPrintln(...)
19 distance(...)
20 dropFirst(...)
21 dropLast(...)
22 dump(...)
23 encodeBitsAsWords(...)
24 enumerate(...)
25 equal(...)
26 filter(...)
27 find(...)
28 getBridgedObjectiveCType(...)
29 getVaList(...)
30 indices(...)
31 insertionSort(...)
32 isBridgedToObjectiveC(...)
33 isBridgedVerbatimToObjectiveC(...)
34 isUniquelyReferenced(...)
35 join(...)
36 lexicographicalCompare(...)
37 map(...)
38 max(...)
39 maxElement(...)
40 min(...)
41 minElement(...)
42 numericCast(...)
43 partition(...)
44 posix_read(...)
45 posix_write(...)
46 print(...)
47 println(...)
48 quickSort(...)
49 reduce(...)
50 reflect(...)
51 reinterpretCast(...)
52 reverse(...)
53 roundUpToAlignment(...)
54 sizeof(...)
55 sizeofValue(...)
56 sort(...)
57 split(...)
58 startsWith(...)
59 strideof(...)
60 strideofValue(...)
61 swap(...)
62 swift_MagicMirrorData_summaryImpl(...)
63 swift_bufferAllocate(...)
64 swift_keepAlive(...)
65 toString(...)
66 transcode(...)
67 underestimateCount(...)
68 unsafeReflect(...)
69 withExtendedLifetime(...)
70 withObjectAtPlusZero(...)
71 withUnsafePointer(...)
72 withUnsafePointerToObject(...)
73 withUnsafePointers(...)
74 withVaList(...) 

欢迎讨论，敬请勘误！

原文：Standard functions in Swift

推荐阅读：

Swift -- 中文版两大官方文档汇总

Swift专题

[转]Swift中的标准函数