Feature gate: #![feature(file_with_nul)]

This is a tracking issue for Location::file_with_nul.

This feature allows you to obtain NUL-terminated file names from core::panic::Location when using #[track_caller]. This allows for better error messages in projects performing interop with C/C++.

Public API

// core::panic

pub struct Location<'a>;

impl<'a> Location<'a> {
    pub const fn file_with_nul(&self) -> &'a CStr;
}

Steps / History

(Remember to update the S-tracking-* label when checking boxes.)

• Accept ACP: ACP: Add nul-terminated version of core::panic::Location::file libs-team#466
• Implementation:
  • Add Location::file_with_nul #135054
  • Fix overly restrictive lifetime in core::panic::Location::file return type #132087
• Resolve open questions:
  • Use raw pointer for NUL-terminated file location with #[track_caller] #142579
• Final comment period (FCP)¹
  • Rename Location::file_with_nul to file_as_c_str #145928
• Stabilization PR
  • Stabilize std::panic::Location::file_as_c_str #145664

Related PRs:

• Add nul-terminated filename for #[track_caller] #131828
• Add unstable option to nul-terminate location strings #135240
• Null terminate core::panic::Location file strings #117431
• Use raw pointer for NUL-terminated file location with #[track_caller] #142579
• Do not include NUL-terminator in computed length #142708