Struct core::panic::Location

1.10.0 · source ·
pub struct Location<'a> { /* private fields */ }
Expand description

包含有关 panic 位置信息的结构体。

该结构体由 PanicInfo::location() 创建。

Examples

use std::panic;

panic::set_hook(Box::new(|panic_info| {
    if let Some(location) = panic_info.location() {
        println!("panic occurred in file '{}' at line {}", location.file(), location.line());
    } else {
        println!("panic occurred but can't get location information...");
    }
}));

panic!("Normal panic");
Run

Comparisons

在文件,行和列优先级中进行相等性和顺序的比较。 文件被比较为字符串,而不是 Path,这可能是意外的。 有关更多讨论,请参见 Location::file 的文档。

Implementations§

source§

impl<'a> Location<'a>

1.46.0 (const: unstable) · source

pub fn caller() -> &'static Location<'static>

返回此函数的调用者的源位置。 如果该函数的调用者被注释,那么它的调用位置将被返回,以此类推,直到堆栈中第一个未被跟踪的函数体中的调用。

Examples
use std::panic::Location;

/// 返回调用它的 [`Location`]。
#[track_caller]
fn get_caller_location() -> &'static Location<'static> {
    Location::caller()
}

/// 从此函数的定义中返回 [`Location`]。
fn get_just_one_location() -> &'static Location<'static> {
    get_caller_location()
}

let fixed_location = get_just_one_location();
assert_eq!(fixed_location.file(), file!());
assert_eq!(fixed_location.line(), 14);
assert_eq!(fixed_location.column(), 5);

// 在不同的位置运行相同的未跟踪函数会得到相同的结果
let second_fixed_location = get_just_one_location();
assert_eq!(fixed_location.file(), second_fixed_location.file());
assert_eq!(fixed_location.line(), second_fixed_location.line());
assert_eq!(fixed_location.column(), second_fixed_location.column());

let this_location = get_caller_location();
assert_eq!(this_location.file(), file!());
assert_eq!(this_location.line(), 28);
assert_eq!(this_location.column(), 21);

// 在其他位置运行跟踪的函数会产生不同的值
let another_location = get_caller_location();
assert_eq!(this_location.file(), another_location.file());
assert_ne!(this_location.line(), another_location.line());
assert_ne!(this_location.column(), another_location.column());
Run
const: unstable · source

pub fn file(&self) -> &str

返回 panic 源自的源文件的名称。

&str,不是 &Path

返回的名称指向编译系统上的源路径,但是将其直接表示为 &Path 是无效的。 与提供内容的系统相比,编译后的代码可以在具有不同 Path 实现的不同系统上运行,并且此库当前没有不同的 “host path” 类型。

当通过模块系统中的多个路径可访问 “the same” 文件时 (通常使用 #[path = "..."] 属性或类似属性),会发生最令人惊讶的行为,这可能导致看似相同的代码返回与此函数不同的值。

Cross-compilation

当主机平台和目标平台不同时,此值不适合传递给 Path::new 或类似的构造函数。

Examples
use std::panic;

panic::set_hook(Box::new(|panic_info| {
    if let Some(location) = panic_info.location() {
        println!("panic occurred in file '{}'", location.file());
    } else {
        println!("panic occurred but can't get location information...");
    }
}));

panic!("Normal panic");
Run
const: unstable · source

pub fn line(&self) -> u32

返回 panic 起源的行号。

Examples
use std::panic;

panic::set_hook(Box::new(|panic_info| {
    if let Some(location) = panic_info.location() {
        println!("panic occurred at line {}", location.line());
    } else {
        println!("panic occurred but can't get location information...");
    }
}));

panic!("Normal panic");
Run
1.25.0 (const: unstable) · source

pub fn column(&self) -> u32

返回 panic 起源的列。

Examples
use std::panic;

panic::set_hook(Box::new(|panic_info| {
    if let Some(location) = panic_info.location() {
        println!("panic occurred at column {}", location.column());
    } else {
        println!("panic occurred but can't get location information...");
    }
}));

panic!("Normal panic");
Run

Trait Implementations§

source§

impl<'a> Clone for Location<'a>

source§

fn clone(&self) -> Location<'a>

返回值的副本。 Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

source 执行复制分配。 Read more
source§

impl<'a> Debug for Location<'a>

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

使用给定的格式化程序格式化该值。 Read more
1.26.0 · source§

impl Display for Location<'_>

source§

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

使用给定的格式化程序格式化该值。 Read more
source§

impl<'a> Hash for Location<'a>

source§

fn hash<__H: Hasher>(&self, state: &mut __H)

将该值输入给定的 HasherRead more
1.3.0 · source§

fn hash_slice<H: Hasher>(data: &[Self], state: &mut H)where Self: Sized,

将这种类型的切片送入给定的 Hasher 中。 Read more
source§

impl<'a> Ord for Location<'a>

source§

fn cmp(&self, other: &Location<'a>) -> Ordering

此方法返回 selfother 之间的 OrderingRead more
1.21.0 · source§

fn max(self, other: Self) -> Selfwhere Self: Sized,

比较并返回两个值中的最大值。 Read more
1.21.0 · source§

fn min(self, other: Self) -> Selfwhere Self: Sized,

比较并返回两个值中的最小值。 Read more
1.50.0 · source§

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd,

将值限制在某个时间间隔内。 Read more
source§

impl<'a> PartialEq<Location<'a>> for Location<'a>

source§

fn eq(&self, other: &Location<'a>) -> bool

此方法测试 selfother 值是否相等,并由 == 使用。
1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

此方法测试 !=。 默认实现几乎总是足够的,并且不应在没有充分理由的情况下被覆盖。
source§

impl<'a> PartialOrd<Location<'a>> for Location<'a>

source§

fn partial_cmp(&self, other: &Location<'a>) -> Option<Ordering>

如果存在,则此方法返回 selfother 值之间的顺序。 Read more
1.0.0 · source§

fn lt(&self, other: &Rhs) -> bool

此方法测试的内容少于 (对于 selfother),并且由 < 操作员使用。 Read more
1.0.0 · source§

fn le(&self, other: &Rhs) -> bool

此方法测试小于或等于 (对于 selfother),并且由 <= 运算符使用。 Read more
1.0.0 · source§

fn gt(&self, other: &Rhs) -> bool

此方法测试大于 (对于 selfother),并且由 > 操作员使用。 Read more
1.0.0 · source§

fn ge(&self, other: &Rhs) -> bool

此方法测试是否大于或等于 (对于 selfother),并且由 >= 运算符使用。 Read more
source§

impl<'a> Copy for Location<'a>

source§

impl<'a> Eq for Location<'a>

source§

impl<'a> StructuralEq for Location<'a>

source§

impl<'a> StructuralPartialEq for Location<'a>

Auto Trait Implementations§

§

impl<'a> RefUnwindSafe for Location<'a>

§

impl<'a> Send for Location<'a>

§

impl<'a> Sync for Location<'a>

§

impl<'a> Unpin for Location<'a>

§

impl<'a> UnwindSafe for Location<'a>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

获取 selfTypeIdRead more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

从拥有的值中一成不变地借用。 Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

从拥有的值中借用。 Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

返回未更改的参数。

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

调用 U::from(self)

也就是说,这种转换是 From<T> for U 实现选择执行的任何操作。

source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

发生转换错误时返回的类型。
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

执行转换。
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

发生转换错误时返回的类型。
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

执行转换。