Skip to content

Add Challenge 16: Iterator #260

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 23 commits into from
Apr 4, 2025
Merged
Changes from 18 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
68 changes: 68 additions & 0 deletions doc/src/challenges/0016-iter.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
# Challenge 16: Verify the safety of Iterator functions

- **Status:** Open
- **Tracking Issue:** [#280](https://github.com/model-checking/verify-rust-std/issues/280)
- **Start date:** *2025-03-07*
- **End date:** *2025-10-17*
- **Reward:** *5000 USD*

-------------------


## Goal

Verify the safety of iter functions that are defined in (library/core/src/iter/adapters):



### Success Criteria

Write and prove the contract for the safety of the following functions:

| Function | Defined in |
|---------| ---------|
|next_back_remainder| array_chunks.rs|
|fold| array_chunks.rs|
|__iterator_get_unchecked| clone.rs|
|fold| clone.rs|
|next_unchecked| clone.rs|
|__iterator_get_unchecked| copied.rs|
|spec_next_chunk| copied.rs|
|__iterator_get_unchecked| enumerate.rs|
|next_chunk| filter.rs|
|next_chunk| filter_map.rs|
|__iterator_get_unchecked | fuse.rs|
|__iterator_get_unchecked | map.rs|
|next_unchecked | map.rs|
|as_array_ref | map_windows.rs|
|as_uninit_array_mut | map_windows.rs|
|push | map_windows.rs|
|drop | map_windows.rs|
|__iterator_get_unchecked | skip.rs|
|original_step | step_by.rs|
|spec_fold| take.rs|
|spec_for_each| take.rs|
|__iterator_get_unchecked | zip.rs|
|get_unchecked| zip.rs|
|fold| zip.rs|
|next| zip.rs|
|nth| zip.rs|
|next_back| zip.rs|
|spec_fold| zip.rs|

The verification must be unbounded---it must hold for slices of arbitrary length.

The verification must hold for generic type `T` (no monomorphization).

### List of UBs

All proofs must automatically ensure the absence of the following undefined behaviors [ref](https://github.com/rust-lang/reference/blob/142b2ed77d33f37a9973772bd95e6144ed9dce43/src/behavior-considered-undefined.md):

* Accessing (loading from or storing to) a place that is dangling or based on a misaligned pointer.
* Reading from uninitialized memory except for padding or unions.
* Mutating immutable bytes.
* Producing an invalid value


Note: All solutions to verification challenges need to satisfy the criteria established in the [challenge book](../general-rules.md)
in addition to the ones listed above.
Loading