---
title: "prefix(_:)"
framework: swift
role: symbol
role_heading: Instance Method
path: "swift/throwingtaskgroup/prefix(_:)"
---

# prefix(_:)

Returns an asynchronous sequence, up to the specified maximum length, containing the initial elements of the base asynchronous sequence.

## Declaration

```swift
func prefix(_ count: Int) -> AsyncPrefixSequence<Self>
```

## Parameters

- `count`: The maximum number of elements to return. The value of count must be greater than or equal to zero.

## Return Value

Return Value An asynchronous sequence starting at the beginning of the base sequence with at most count elements.

## Discussion

Discussion Use prefix(_:) to reduce the number of elements produced by the asynchronous sequence. In this example, an asynchronous sequence called Counter produces Int values from 1 to 10. The prefix(_:) method causes the modified sequence to pass through the first six values, then end. for await number in Counter(howHigh: 10).prefix(6) {     print(number, terminator: " ") } // Prints "1 2 3 4 5 6 " If the count passed to prefix(_:) exceeds the number of elements in the base sequence, the result contains all of the elements in the sequence.

## See Also

### Accessing an Asynchronous Sequence of Results

- [makeAsyncIterator()](swift/throwingtaskgroup/makeasynciterator().md)
- [allSatisfy(_:)](swift/throwingtaskgroup/allsatisfy(_:).md)
- [compactMap(_:)](swift/throwingtaskgroup/compactmap(_:)-944nh.md)
- [compactMap(_:)](swift/throwingtaskgroup/compactmap(_:)-7mgi5.md)
- [contains(_:)](swift/throwingtaskgroup/contains(_:).md)
- [contains(where:)](swift/throwingtaskgroup/contains(where:).md)
- [drop(while:)](swift/throwingtaskgroup/drop(while:).md)
- [dropFirst(_:)](swift/throwingtaskgroup/dropfirst(_:).md)
- [filter(_:)](swift/throwingtaskgroup/filter(_:).md)
- [first(where:)](swift/throwingtaskgroup/first(where:).md)
- [map(_:)](swift/throwingtaskgroup/map(_:)-58nrv.md)
- [map(_:)](swift/throwingtaskgroup/map(_:)-4a4ju.md)
- [max()](swift/throwingtaskgroup/max().md)
- [max(by:)](swift/throwingtaskgroup/max(by:).md)
- [min()](swift/throwingtaskgroup/min().md)