Skip to content

Tracking Issue for std::ffi::c_str module #112134

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.

Sign up for GitHub

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

Jump to bottom
Closed
4 of 5 tasks
clarfonthey opened this issue May 31, 2023 · 6 comments · Fixed by #137439
Closed
4 of 5 tasks

Tracking Issue for std::ffi::c_str module #112134

clarfonthey opened this issue May 31, 2023 · 6 comments · Fixed by #137439
Labels
C-tracking-issue Category: An issue tracking the progress of sth. like the implementation of an RFC disposition-merge This issue / PR is in PFCP or FCP with a disposition to merge it. finished-final-comment-period The final comment period is finished for this PR / Issue. T-libs-api Relevant to the library API team, which will review and decide on the PR/issue.

Comments

@clarfonthey
Copy link
Contributor

clarfonthey commented May 31, 2023 •
edited
Loading

Feature gate: #![feature(c_str_module)]

This is a tracking issue for the std::ffi::c_str module.

Public API

This adds {core, alloc, std}::ffi::c_str modules and migrates some existing types into them. Types will still be re-exported in their current places to ensure compatibility.

The following migrations are made:

  • core::ffi::CStr => core::ffi::c_str::CStr
  • core::ffi::FromBytesUntilNulError => core::ffi::c_str::FromBytesUntilNulError
  • core::ffi::FromBytesWithNulError => core::ffi::c_str::FromBytesWithNulError
  • alloc::ffi::CString => alloc::ffi::c_str::CString
  • alloc::ffi::FromVecWIthNulError => alloc::ffi::c_str::FromVecWIthNulError
  • alloc::ffi::IntoStringError => alloc::ffi::c_str::IntoStringError
  • alloc::ffi::NulError => alloc::ffi::c_str::NulError

And these types are also migrated on the std crate as well.

Steps / History

Unresolved Questions

  • Should c_str and c_string be separated? This was not discussed in the original ACP. Decision: no.

Footnotes

  1. https://std-dev-guide.rust-lang.org/feature-lifecycle/api-change-proposals.html ↩

  2. https://std-dev-guide.rust-lang.org/feature-lifecycle/stabilization.html ↩
@clarfonthey clarfonthey added C-tracking-issue Category: An issue tracking the progress of sth. like the implementation of an RFC T-libs-api Relevant to the library API team, which will review and decide on the PR/issue. labels May 31, 2023
@clarfonthey clarfonthey changed the title Tracking Issue for std::ffi::c_str module Tracking Issue for {core, std}::ffi::c_str and {alloc, std}::ffi::c_string modules May 31, 2023
@clarfonthey clarfonthey changed the title Tracking Issue for {core, std}::ffi::c_str and {alloc, std}::ffi::c_string modules Tracking Issue for {core, alloc, std}::ffi::c_str module Jun 1, 2023
@clarfonthey clarfonthey changed the title Tracking Issue for {core, alloc, std}::ffi::c_str module Tracking Issue for std::ffi::c_str module Jun 1, 2023
@dtolnay
Copy link
Member

dtolnay commented Jul 20, 2024

@rust-lang/libs-api:
@rfcbot fcp merge

This module has been available since 1.78-nightly, and is valuable in tidying all those types you will never need to name out of std::ffi's "Structs" section.

Without modules, are you able to guess whether std::ffi::IntoStringError refers to the error type returned by std::ffi::CString::into_string or by std::ffi::OsString::into_string?

Before:

After:

@rfcbot
Copy link
Collaborator

rfcbot commented Jul 20, 2024 •
edited by Amanieu
Loading

Team member @dtolnay has proposed to merge this. The next step is review by the rest of the tagged team members:

No concerns currently listed.

Once a majority of reviewers approve (and at most 2 approvals are outstanding), this will enter its final comment period. If you spot a major issue that hasn't been raised at any point in this process, please speak up!

See this document for info about what commands tagged team members can give me.

@rfcbot rfcbot added proposed-final-comment-period Proposed to merge/close by relevant subteam, see T-<team> label. Will enter FCP once signed off. disposition-merge This issue / PR is in PFCP or FCP with a disposition to merge it. labels Jul 20, 2024
@clarfonthey
Copy link
Contributor Author

clarfonthey commented Jul 20, 2024 •
edited
Loading

Note that the os_str module, while part of the initial ACP, was rejected, and isn't part of this tracking issue. If you'd like to include it as part of the FCP, I would not oppose, but that should be stated explicitly instead of being roped in implicitly. Just don't want to avoid a headache when it comes to stabilisation.

@joshtriplett
Copy link
Member

For people wanting to follow std::ffi::os_str, it's #120048 .

@rfcbot rfcbot added final-comment-period In the final comment period and will be merged soon unless new substantive objections are raised. and removed proposed-final-comment-period Proposed to merge/close by relevant subteam, see T-<team> label. Will enter FCP once signed off. labels Jul 23, 2024
@rfcbot
Copy link
Collaborator

rfcbot commented Jul 23, 2024

🔔 This is now entering its final comment period, as per the review above. 🔔

@rfcbot rfcbot added finished-final-comment-period The final comment period is finished for this PR / Issue. and removed final-comment-period In the final comment period and will be merged soon unless new substantive objections are raised. labels Aug 2, 2024
@rfcbot
Copy link
Collaborator

rfcbot commented Aug 2, 2024

The final comment period, with a disposition to merge, as per the review above, is now complete.

As the automated representative of the governance process, I would like to thank the author for their work and everyone else who contributed.

This will be merged soon.

@rfcbot rfcbot added the to-announce Announce this issue on triage meeting label Aug 2, 2024
@apiraino apiraino removed the to-announce Announce this issue on triage meeting label Aug 15, 2024
@clarfonthey clarfonthey mentioned this issue Feb 22, 2025
Merged
tgross35 added a commit to tgross35/rust that referenced this issue Apr 27, 2025
@tgross35
Rollup merge of rust-lang#137439 - clarfonthey:c-str-module, r=tgross35
59eca8a 
Stabilise `std::ffi::c_str`

This finished FCP in rust-lang#112134 but never actually got a stabilisation PR. Since the FCP in rust-lang#120048 recently passed to add the `os_str` module, it would be nice to also merge this too, to ensure that both get added in the next version.

Note: The added stability attributes which *somehow* were able to be omitted before (rustc bug?) were added based on the fact that they were added in 3025513, which ended up in 1.85.0.

Closes: rust-lang#112134

r? libs-api
tgross35 added a commit to tgross35/rust that referenced this issue Apr 27, 2025
@tgross35
Rollup merge of rust-lang#137439 - clarfonthey:c-str-module, r=tgross35
1e295a2 
Stabilise `std::ffi::c_str`

This finished FCP in rust-lang#112134 but never actually got a stabilisation PR. Since the FCP in rust-lang#120048 recently passed to add the `os_str` module, it would be nice to also merge this too, to ensure that both get added in the next version.

Note: The added stability attributes which *somehow* were able to be omitted before (rustc bug?) were added based on the fact that they were added in 3025513, which ended up in 1.85.0.

Closes: rust-lang#112134

r? libs-api
tgross35 added a commit to tgross35/rust that referenced this issue Apr 27, 2025
@tgross35
Rollup merge of rust-lang#137439 - clarfonthey:c-str-module, r=tgross35
2257a1c 
Stabilise `std::ffi::c_str`

This finished FCP in rust-lang#112134 but never actually got a stabilisation PR. Since the FCP in rust-lang#120048 recently passed to add the `os_str` module, it would be nice to also merge this too, to ensure that both get added in the next version.

Note: The added stability attributes which *somehow* were able to be omitted before (rustc bug?) were added based on the fact that they were added in 3025513, which ended up in 1.85.0.

Closes: rust-lang#112134

r? libs-api
@bors bors closed this as completed in 9630242 Apr 27, 2025
rust-timer added a commit to rust-lang-ci/rust that referenced this issue Apr 27, 2025
@rust-timer
Unrolled build for rust-lang#137439
6fc31eb 
Rollup merge of rust-lang#137439 - clarfonthey:c-str-module, r=tgross35

Stabilise `std::ffi::c_str`

This finished FCP in rust-lang#112134 but never actually got a stabilisation PR. Since the FCP in rust-lang#120048 recently passed to add the `os_str` module, it would be nice to also merge this too, to ensure that both get added in the next version.

Note: The added stability attributes which *somehow* were able to be omitted before (rustc bug?) were added based on the fact that they were added in 3025513, which ended up in 1.85.0.

Closes: rust-lang#112134

r? libs-api
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
C-tracking-issue Category: An issue tracking the progress of sth. like the implementation of an RFC disposition-merge This issue / PR is in PFCP or FCP with a disposition to merge it. finished-final-comment-period The final comment period is finished for this PR / Issue. T-libs-api Relevant to the library API team, which will review and decide on the PR/issue.
Projects
None yet
Milestone
No milestone
Development

Successfully merging a pull request may close this issue.

Stabilise std::ffi::c_str clarfonthey/rust
5 participants
@joshtriplett @dtolnay @apiraino @clarfonthey @rfcbot