Skip to content

Commit 85f81c9

Browse files
authored
docs: add section about accessing Task return value via .value (#16)
Addresses issue #14 - explains that you can access a Task's return value using the .value property on the task handle. Added 'Accessing Task Results' section to all 11 language versions: - Arabic (ar) - English (en) - Spanish (es) - Japanese (ja) - Korean (ko) - Portuguese - Brazil (pt-BR) - Portuguese - Portugal (pt-PT) - Russian (ru) - Turkish (tr) - Simplified Chinese (zh-CN) - Traditional Chinese (zh-TW) Closes #14
1 parent abaa32c commit 85f81c9

File tree

11 files changed

+143
-0
lines changed

11 files changed

+143
-0
lines changed

src/ar/index.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,19 @@ Button("Save") {
133133
}
134134
```
135135

136+
### الوصول لنتائج المهام
137+
138+
عندما تنشئ Task، تحصل على مقبض. استخدم `.value` للانتظار واسترجاع النتيجة:
139+
140+
```swift
141+
let handle = Task {
142+
return await fetchUserData()
143+
}
144+
let userData = await handle.value // يتوقف حتى تكتمل المهمة
145+
```
146+
147+
هذا مفيد عندما تحتاج النتيجة لاحقاً، أو عندما تريد تخزين مقبض المهمة وانتظاره في مكان آخر.
148+
136149
ماذا لو احتجت تحميل الصورة والسيرة والإحصائيات كلها مرة واحدة؟ استخدم [`TaskGroup`](https://developer.apple.com/documentation/swift/taskgroup) لجلبها بالتوازي:
137150

138151
```swift

src/en/index.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -131,6 +131,19 @@ Button("Save") {
131131
}
132132
```
133133

134+
### Accessing Task Results
135+
136+
When you create a Task, you get a handle back. Use `.value` to wait for and retrieve the result:
137+
138+
```swift
139+
let handle = Task {
140+
return await fetchUserData()
141+
}
142+
let userData = await handle.value // Suspends until task completes
143+
```
144+
145+
This is useful when you need the result later, or when you want to store the task handle and await it elsewhere.
146+
134147
What if you need to load the avatar, bio, and stats all at once? Use a [`TaskGroup`](https://developer.apple.com/documentation/swift/taskgroup) to fetch them in parallel:
135148

136149
```swift

src/es/index.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,19 @@ Button("Guardar") {
133133
}
134134
```
135135

136+
### Acceder a los resultados de Task
137+
138+
Cuando creas un Task, obtienes un handle. Usa `.value` para esperar y obtener el resultado:
139+
140+
```swift
141+
let handle = Task {
142+
return await fetchUserData()
143+
}
144+
let userData = await handle.value // Se suspende hasta que la tarea termine
145+
```
146+
147+
Esto es útil cuando necesitas el resultado más tarde, o cuando quieres guardar el handle de la tarea y hacer await en otro lugar.
148+
136149
¿Y si necesitas cargar el avatar, la bio y las estadísticas a la vez? Usa un [`TaskGroup`](https://developer.apple.com/documentation/swift/taskgroup) para obtenerlos en paralelo:
137150

138151
```swift

src/ja/index.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,19 @@ Button("Save") {
133133
}
134134
```
135135

136+
### Taskの結果にアクセスする
137+
138+
Taskを作成すると、ハンドルが返される。`.value`を使って結果を待って取得する:
139+
140+
```swift
141+
let handle = Task {
142+
return await fetchUserData()
143+
}
144+
let userData = await handle.value // タスクが完了するまで中断
145+
```
146+
147+
これは後で結果が必要な場合や、タスクハンドルを保存して別の場所でawaitしたい場合に便利。
148+
136149
アバター、自己紹介、統計情報を一度に読み込む必要がある場合は?[`TaskGroup`](https://developer.apple.com/documentation/swift/taskgroup) を使って並列に取得する:
137150

138151
```swift

src/ko/index.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,19 @@ Button("Save") {
133133
}
134134
```
135135

136+
### Task 결과 접근하기
137+
138+
Task를 생성하면 핸들을 받습니다. `.value`를 사용해서 결과를 기다리고 가져올 수 있습니다:
139+
140+
```swift
141+
let handle = Task {
142+
return await fetchUserData()
143+
}
144+
let userData = await handle.value // 태스크가 완료될 때까지 일시 중단
145+
```
146+
147+
이건 나중에 결과가 필요하거나, 태스크 핸들을 저장해서 다른 곳에서 await하고 싶을 때 유용합니다.
148+
136149
아바타, 바이오, 통계를 한꺼번에 로드해야 한다면? [`TaskGroup`](https://developer.apple.com/documentation/swift/taskgroup)을 사용해서 병렬로 가져오세요:
137150

138151
```swift

src/pt-BR/index.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,19 @@ Button("Salvar") {
133133
}
134134
```
135135

136+
### Acessando resultados de Task
137+
138+
Quando você cria uma Task, recebe um handle. Use `.value` para esperar e obter o resultado:
139+
140+
```swift
141+
let handle = Task {
142+
return await fetchUserData()
143+
}
144+
let userData = await handle.value // Suspende até a task completar
145+
```
146+
147+
Isso é útil quando você precisa do resultado mais tarde, ou quando quer guardar o handle da task e fazer await em outro lugar.
148+
136149
E se você precisa carregar o avatar, bio, e estatísticas tudo de uma vez? Use um [`TaskGroup`](https://developer.apple.com/documentation/swift/taskgroup) para buscá-los em paralelo:
137150

138151
```swift

src/pt-PT/index.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,19 @@ Button("Guardar") {
133133
}
134134
```
135135

136+
### Aceder aos resultados de Task
137+
138+
Quando crias uma Task, recebes um handle. Usa `.value` para esperar e obter o resultado:
139+
140+
```swift
141+
let handle = Task {
142+
return await fetchUserData()
143+
}
144+
let userData = await handle.value // Suspende até a task completar
145+
```
146+
147+
Isto é útil quando precisas do resultado mais tarde, ou quando queres guardar o handle da task e fazer await noutro sítio.
148+
136149
E se precisares de carregar o avatar, bio e estatísticas de uma vez? Usa um [`TaskGroup`](https://developer.apple.com/documentation/swift/taskgroup) para buscar em paralelo:
137150

138151
```swift

src/ru/index.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,19 @@ Button("Save") {
133133
}
134134
```
135135

136+
### Доступ к результатам Task
137+
138+
Когда вы создаёте Task, вы получаете дескриптор. Используйте `.value`, чтобы дождаться и получить результат:
139+
140+
```swift
141+
let handle = Task {
142+
return await fetchUserData()
143+
}
144+
let userData = await handle.value // Приостанавливается до завершения задачи
145+
```
146+
147+
Это полезно, когда результат нужен позже, или когда вы хотите сохранить дескриптор задачи и дождаться его в другом месте.
148+
136149
Что если нужно загрузить аватар, био и статистику одновременно? Используйте [`TaskGroup`](https://developer.apple.com/documentation/swift/taskgroup) для параллельной загрузки:
137150

138151
```swift

src/tr/index.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -134,6 +134,19 @@ Button("Save") {
134134
}
135135
```
136136

137+
### Task Sonuçlarına Erişim
138+
139+
Bir Task oluşturduğunuzda, bir handle alırsınız. Sonucu beklemek ve almak için `.value` kullanın:
140+
141+
```swift
142+
let handle = Task {
143+
return await fetchUserData()
144+
}
145+
let userData = await handle.value // Task tamamlanana kadar askıya alır
146+
```
147+
148+
Bu, sonuca daha sonra ihtiyacınız olduğunda veya task handle'ını saklayıp başka bir yerde await etmek istediğinizde kullanışlıdır.
149+
137150
Peki ya avatar, biyografi ve istatistiklerin hepsini aynı anda yüklemeniz gerekirse? Bunları paralel olarak fetch'lemek için bir [`TaskGroup`](https://developer.apple.com/documentation/swift/taskgroup) kullanın:
138151

139152
```swift

src/zh-CN/index.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,19 @@ Button("Save") {
133133
}
134134
```
135135

136+
### 访问 Task 结果
137+
138+
当你创建一个 Task 时,会得到一个句柄。使用 `.value` 来等待并获取结果:
139+
140+
```swift
141+
let handle = Task {
142+
return await fetchUserData()
143+
}
144+
let userData = await handle.value // 暂停直到任务完成
145+
```
146+
147+
当你需要稍后获取结果,或者想要保存任务句柄并在其他地方 await 它时,这很有用。
148+
136149
如果你需要同时加载头像、简介和统计数据怎么办?用 [`TaskGroup`](https://developer.apple.com/documentation/swift/taskgroup) 并行获取它们:
137150

138151
```swift

0 commit comments

Comments
 (0)