Skip to content

Commit 15786c6

Browse files
authored
1340: Swift 6 Generic Parameters and Arguments 的翻译⭐️⭐️⭐️ (#1395)
* test * Reference manual:Generic Parameters And Arguments 的翻译初稿 * 翻译初稿 * Update GenericParametersAndArguments.md 根据 comment 修订了翻译
1 parent 5c3df02 commit 15786c6

File tree

2 files changed

+244
-698
lines changed

2 files changed

+244
-698
lines changed

swift-6-beta.docc/ReferenceManual/GenericParametersAndArguments.md

Lines changed: 42 additions & 123 deletions
Original file line numberDiff line numberDiff line change
@@ -4,55 +4,36 @@ Swift 文档源文件地址:https://docs.swift.org/swift-book/documentation/th
44
翻译估计用时:⭐️⭐️⭐️
55
-->
66

7-
# Generic Parameters and Arguments
7+
# 泛型形参和实参
88

9-
Generalize declarations to abstract away concrete types.
9+
将参数声明抽象化以脱离具体类型。
1010

11-
This chapter describes parameters and arguments for generic types, functions, and
12-
initializers. When you declare a generic type, function, subscript, or initializer,
13-
you specify the type parameters that the generic type, function, or initializer
14-
can work with. These type parameters act as placeholders that
15-
are replaced by actual concrete type arguments when an instance of a generic type is
16-
created or a generic function or initializer is called.
11+
本节描述泛型类型、泛型函数和泛型构造器的形参和实参。在声明泛型类型、函数或构造器时,需要指定泛型可处理的类型形参。这些类型形参相当于占位符,当实例化泛型类型或调用泛型函数、初始化器时,会被具体的类型实参替换。
1712

18-
For an overview of generics in Swift, see <doc:Generics>.
13+
关于 Swift 语言中的“泛型”,参阅 <doc:Generics>.
1914

2015
<!--
2116
NOTE: Generic types are sometimes referred to as :newTerm:`parameterized types`
2217
because they're declared with one or more type parameters.
2318
-->
2419

25-
## Generic Parameter Clause
20+
## 泛型形参子句
2621

27-
A *generic parameter clause* specifies the type parameters of a generic
28-
type or function, along with any associated constraints and requirements on those parameters.
29-
A generic parameter clause is enclosed in angle brackets (<>)
30-
and has the following form:
22+
*泛型形参子句* 指定了泛型类型或函数的类型形参,以及对这些形参的任何相关约束和要求。泛型形参用尖括号(<>)括起来,格式如下:
3123

3224
```swift
3325
<<#generic parameter list#>>
3426
```
3527

36-
The *generic parameter list* is a comma-separated list of generic parameters,
37-
each of which has the following form:
28+
多个*泛型形参*用逗号分开,每个形参的形式如下:
3829

3930
```swift
4031
<#type parameter#>: <#constraint#>
4132
```
4233

43-
A generic parameter consists of a *type parameter* followed by
44-
an optional *constraint*. A *type parameter* is simply the name
45-
of a placeholder type
46-
(for example, `T`, `U`, `V`, `Key`, `Value`, and so on).
47-
You have access to the type parameters (and any of their associated types) in the rest of the
48-
type, function, or initializer declaration, including in the signature of the function
49-
or initializer.
34+
泛型形参由一个*类型形参*和一个可选的*约束*组成。*类型形参*只是一个占位符(如 `T``U``V``Key``Value`等),用来表示类型。在声明类型、函数或构造器时(包括函数或构造器的签名),你可以访问这些类型形参及其任何关联的类型。
5035

51-
The *constraint* specifies that a type parameter inherits
52-
from a specific class or conforms to a protocol or protocol composition.
53-
For example, in the generic function below, the generic parameter `T: Comparable`
54-
indicates that any type argument substituted
55-
for the type parameter `T` must conform to the `Comparable` protocol.
36+
*约束*指定了类型形参要继承自特定类,或遵循某个协议或协议组合。例如:在下面的泛型函数中,泛型形参 `T: Comparable` 表示任何替代类型形参 `T` 的类型实参都必须遵循 `Comparable` 协议。
5637

5738
```swift
5839
func simpleMax<T: Comparable>(_ x: T, _ y: T) -> T {
@@ -76,11 +57,7 @@ func simpleMax<T: Comparable>(_ x: T, _ y: T) -> T {
7657
```
7758
-->
7859

79-
Because `Int` and `Double`, for example, both conform to the `Comparable` protocol,
80-
this function accepts arguments of either type. In contrast with generic types, you don't
81-
specify a generic argument clause when you use a generic function or initializer.
82-
The type arguments are instead inferred from the type of the arguments passed
83-
to the function or initializer.
60+
`Int``Double`,因为都遵循 `Comparable` 协议,所以该函数可以接受这两种类型的参数。与泛型类型不同,调用泛型函数或构造器时,你不需要指定泛型实参子句。泛型实参的类型会根据传给函数或构造器的参数类型推断出来。
8461

8562
```swift
8663
simpleMax(17, 42) // T is inferred to be Int
@@ -105,55 +82,23 @@ simpleMax(3.14159, 2.71828) // T is inferred to be Double
10582
Tracking bug is <rdar://problem/35301593>
10683
-->
10784

108-
### Generic Where Clauses
85+
### 泛型 Where 子句
10986

110-
You can specify additional requirements on type parameters and their associated types
111-
by including a generic `where` clause right before the opening curly brace
112-
of a type or function's body.
113-
A generic `where` clause consists of the `where` keyword,
114-
followed by a comma-separated list of one or more *requirements*.
87+
你可以通过在类型或函数体的起始大括号前包含一个泛型`where`子句,来对类型形参及其相关类型指定额外的要求。泛型 `where`子句由`where`关键字组成,后跟一个或多个要求,多个*要求*用逗号进行分隔。
11588

11689
```swift
11790
where <#requirements#>
11891
```
11992

120-
The *requirements* in a generic `where` clause specify that a type parameter inherits from
121-
a class or conforms to a protocol or protocol composition.
122-
Although the generic `where` clause provides syntactic
123-
sugar for expressing simple constraints on type parameters
124-
(for example, `<T: Comparable>` is equivalent to `<T> where T: Comparable` and so on),
125-
you can use it to provide more complex constraints on type parameters
126-
and their associated types. For example,
127-
you can constrain the associated types of type parameters to conform to protocols.
128-
For example, `<S: Sequence> where S.Iterator.Element: Equatable`
129-
specifies that `S` conforms to the `Sequence` protocol
130-
and that the associated type `S.Iterator.Element`
131-
conforms to the `Equatable` protocol.
132-
This constraint ensures that each element of the sequence is equatable.
133-
134-
You can also specify the requirement that two types be identical,
135-
using the `==` operator. For example,
136-
`<S1: Sequence, S2: Sequence> where S1.Iterator.Element == S2.Iterator.Element`
137-
expresses the constraints that `S1` and `S2` conform to the `Sequence` protocol
138-
and that the elements of both sequences must be of the same type.
139-
140-
Any type argument substituted for a type parameter must
141-
meet all the constraints and requirements placed on the type parameter.
142-
143-
A generic `where` clause can appear
144-
as part of a declaration that includes type parameters,
145-
or as part of a declaration
146-
that's nested inside of a declaration that includes type parameters.
147-
The generic `where` clause for a nested declaration
148-
can still refer to the type parameters of the enclosing declaration;
149-
however,
150-
the requirements from that `where` clause
151-
apply only to the declaration where it's written.
152-
153-
If the enclosing declaration also has a `where` clause,
154-
the requirements from both clauses are combined.
155-
In the example below, `startsWithZero()` is available
156-
only if `Element` conforms to both `SomeProtocol` and `Numeric`.
93+
泛型 `where` 子句中的*要求*指明类型形参要继承自某个类或遵循某个协议或协议组合。虽然 `where` 子句为表达类型形参的简单约束提供了语法糖(比如,`<T: Comparable>` 等同于 `where T: Comparable` 等),但它可以用于为类型形参及其关联类型提供更复杂的约束。比如,你可以指定类型形参的关联类型遵循某个协议:`<S: Sequence> where S.Iterator.Element: Equatable` 指定了`S`遵循 `Sequence`协议,并且`S`的关联类型`S.Iterator.Element`遵循`Equatable`协议。此约束确保序列中的每个元素都是符合`Equatable`协议的。
94+
95+
还可以使用 == 运算符来指定两个类型必须相同。例如, `<S1: Sequence, S2: Sequence> where S1.Iterator.Element == S2.Iterator.Element`,表示 S1 和 S2 都遵循 Sequence 协议,并且两个序列元素的类型必须相同。
96+
97+
任何替代类型形参的类型实参都必须满足对该类型形参指定的所有约束与要求。
98+
99+
`where`子句可以出现在包含类型形参的声明中,或作为声明的一部分,被嵌套另一个在含有类型形参的声明中。被嵌套的泛型 `where`子句依然可以指向包围它的声明中的类型形参,然而此时 `where`子句指定的要求仅用于它被声明的地方。
100+
101+
如果外层的声明也有一个 `where` 子句,那么两个子句的要求会合并。在下面的示例中,`startsWithZero()`仅在 `Element` 同时遵循`someProtocol``Numeric`协议时可用。
157102

158103
```swift
159104
extension Collection where Element: SomeProtocol {
@@ -200,55 +145,41 @@ extension Collection where Element: SomeProtocol {
200145
```
201146
-->
202147

203-
You can overload a generic function or initializer by providing different
204-
constraints, requirements, or both on the type parameters.
205-
When you call an overloaded generic function or initializer,
206-
the compiler uses these constraints to resolve which overloaded function
207-
or initializer to invoke.
148+
重载泛型函数或构造器,泛型形参子句中的类型形参必须有不同的约束或要求。当调用重载的泛型函数或构造器时,编译器会使用这些约束来决定调用哪个重载的函数或构造器。
208149

209-
For more information about generic `where` clauses and to see an example
210-
of one in a generic function declaration,
211-
see <doc:Generics#Generic-Where-Clauses>.
150+
更多关于泛型 `where` 从句的内容和关于泛型函数声明的例子,参阅 <doc:Generics#Generic-Where-Clauses>.
212151

213-
> Grammar of a generic parameter clause:
152+
> 泛型形参子句的语法格式:
214153
>
215-
> *generic-parameter-clause***`<`** *generic-parameter-list* **`>`** \
216-
> *generic-parameter-list**generic-parameter* | *generic-parameter* **`,`** *generic-parameter-list* \
217-
> *generic-parameter**type-name* \
218-
> *generic-parameter**type-name* **`:`** *type-identifier* \
219-
> *generic-parameter**type-name* **`:`** *protocol-composition-type*
154+
> *泛型形参子句***`<`** *泛型形参列表* **`>`** \
155+
> *泛型形参列表**泛型形参* | *泛型形参* **`,`** *泛型形参列表* \
156+
> *泛型形参**类型名称* \
157+
> *泛型形参**类型名称* **`:`** *类型标识符* \
158+
> *泛型形参**类型名称* **`:`** *协议合成类型*
220159
>
221-
> *generic-where-clause***`where`** *requirement-list* \
222-
> *requirement-list**requirement* | *requirement* **`,`** *requirement-list* \
223-
> *requirement**conformance-requirement* | *same-type-requirement*
160+
> *泛型 where 子句***`where`** *约束列表* \
161+
> *要求列表**要求* | *要求* **`,`** *要求列表* \
162+
> *要求**一致性要求* | *同类型要求*
224163
>
225-
> *conformance-requirement**type-identifier* **`:`** *type-identifier* \
226-
> *conformance-requirement**type-identifier* **`:`** *protocol-composition-type* \
227-
> *same-type-requirement**type-identifier* **`==`** *type*
164+
> *一致性要求**类型标识符* **`:`** *类型标识符* \
165+
> *一致性要求**类型标识符* **`:`** *协议合成类型* \
166+
> *同类型要求**类型标识符* **`==`** *类型*
228167
229168
<!--
230169
NOTE: A conformance requirement can only have one type after the colon,
231170
otherwise, you'd have a syntactic ambiguity
232171
(a comma-separated list types inside of a comma-separated list of requirements).
233172
-->
234173

235-
## Generic Argument Clause
174+
## 泛型实参子句
236175

237-
A *generic argument clause* specifies the type arguments of a generic
238-
type.
239-
A generic argument clause is enclosed in angle brackets (<>)
240-
and has the following form:
176+
*泛型实参* 指定了泛型类型的类型实参。泛型实参用尖括号(<>)包围,格式如下
241177

242178
```swift
243179
<<#generic argument list#>>
244180
```
245181

246-
The *generic argument list* is a comma-separated list of type arguments.
247-
A *type argument* is the name of an actual concrete type that replaces
248-
a corresponding type parameter in the generic parameter clause of a generic type.
249-
The result is a specialized version of that generic type.
250-
The example below shows a simplified version of the Swift standard library's
251-
generic dictionary type.
182+
多个泛型实参用逗号分开。类型实参是实际具体类型的名称,用来替代泛型类型中对应的类型参数,从而得到该泛型类型的特定版本。下面的示例展示了 Swift 标准库中的泛型字典类型的简化版本:
252183

253184
```swift
254185
struct Dictionary<Key: Hashable, Value>: Collection, ExpressibleByDictionaryLiteral {
@@ -260,19 +191,9 @@ struct Dictionary<Key: Hashable, Value>: Collection, ExpressibleByDictionaryLite
260191
TODO: How are we supposed to wrap code lines like the above?
261192
-->
262193

263-
The specialized version of the generic `Dictionary` type, `Dictionary<String, Int>`
264-
is formed by replacing the generic parameters `Key: Hashable` and `Value`
265-
with the concrete type arguments `String` and `Int`. Each type argument must satisfy
266-
all the constraints of the generic parameter it replaces, including any additional
267-
requirements specified in a generic `where` clause. In the example above,
268-
the `Key` type parameter is constrained to conform to the `Hashable` protocol
269-
and therefore `String` must also conform to the `Hashable` protocol.
194+
泛型`Dictionary`的特定版本`Dictionary<String, Int>`是通过具体的类型实参(`String``Int`)来替换泛型形参(`Key: Hashable` 和 `Value`)而形成的。每个类型实参必须满足它替换的泛型形参的所有约束,包括在泛型`where`子句中指定的额外要求。在上述例子中,`Key`类型形参要遵循`Hashable`协议,因此传入的实参`String`也要遵循`Hashable`协议。
270195

271-
You can also replace a type parameter with a type argument that's itself
272-
a specialized version of a generic type (provided it satisfies the appropriate
273-
constraints and requirements). For example, you can replace the type parameter
274-
`Element` in `Array<Element>` with a specialized version of an array, `Array<Int>`,
275-
to form an array whose elements are themselves arrays of integers.
196+
还可以用本身就是泛型类型的特定版本的类型实参替代类型形参(假设已满足合适的约束和关联类型要求)。例如,可以将 `Array<Element>`中的类型形参 `Element` 替换 Array 泛型专用版本 `Array<Int>` ,以形成一个元素本身是整数数组的二维数组。
276197

277198
```swift
278199
let arrayOfArrays: Array<Array<Int>> = [[1, 2, 3], [4, 5, 6], [7, 8, 9]]
@@ -286,11 +207,9 @@ let arrayOfArrays: Array<Array<Int>> = [[1, 2, 3], [4, 5, 6], [7, 8, 9]]
286207
```
287208
-->
288209

289-
As mentioned in <doc:GenericParametersAndArguments#Generic-Parameter-Clause>,
290-
you don't use a generic argument clause to specify the type arguments
291-
of a generic function or initializer.
210+
正如在<doc:GenericParametersAndArguments#Generic-Parameter-Clause>中提到的,在指定泛型函数或构造器的类型实参时,不能使用泛型实参子句。
292211

293-
> Grammar of a generic argument clause:
212+
> 泛型实参的语法格式:
294213
>
295214
> *generic-argument-clause***`<`** *generic-argument-list* **`>`** \
296215
> *generic-argument-list**generic-argument* | *generic-argument* **`,`** *generic-argument-list* \

0 commit comments

Comments
 (0)