Struct gimli::read::line::FileEntry

pub struct FileEntry<R, Offset = <R as Reader>::Offset>
where
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset,
{
    path_name: AttributeValue<R, Offset>,
    directory_index: u64,
    timestamp: u64,
    size: u64,
    md5: [u8; 16],
    source: Option<AttributeValue<R, Offset>>,
}

An entry in the LineProgramHeader’s file_names set.

Fields

path_name: AttributeValue<R, Offset>

directory_index: u64

timestamp: u64

size: u64

md5: [u8; 16]

source: Option<AttributeValue<R, Offset>>

Implementations

impl<R, Offset> FileEntry<R, Offset>

where R: Reader<Offset = Offset>, Offset: ReaderOffset,

fn parse(input: &mut R, path_name: R) -> Result<FileEntry<R, Offset>>

pub fn path_name(&self) -> AttributeValue<R, Offset>

A slice containing the full or relative path name of a source file. If the entry contains a file name or a relative path name, the file is located relative to either the compilation directory (as specified by the DW_AT_comp_dir attribute given in the compilation unit) or one of the directories in the include_directories section.

pub fn directory_index(&self) -> u64

An unsigned LEB128 number representing the directory index of the directory in which the file was found.

…

The directory index represents an entry in the include_directories section of the line number program header. The index is 0 if the file was found in the current directory of the compilation, 1 if it was found in the first directory in the include_directories section, and so on. The directory index is ignored for file names that represent full path names.

pub fn directory( &self, header: &LineProgramHeader<R>, ) -> Option<AttributeValue<R, Offset>>

Get this file’s directory.

A directory index of 0 corresponds to the compilation unit directory.

pub fn timestamp(&self) -> u64

The implementation-defined time of last modification of the file, or 0 if not available.

pub fn size(&self) -> u64

The size of the file in bytes, or 0 if not available.

pub fn md5(&self) -> &[u8; 16]

A 16-byte MD5 digest of the file contents.

Only valid if LineProgramHeader::file_has_md5 returns true.

pub fn source(&self) -> Option<AttributeValue<R, Offset>>

The source code of this file. (UTF-8 source text string with “\n” line endings).

Note: For DWARF v5 files this may return an empty attribute that indicates that no source code is available, which this function represents as Some(<zero-length attr>).

Trait Implementations

impl<R, Offset> Clone for FileEntry<R, Offset>

where R: Reader<Offset = Offset> + Clone, Offset: ReaderOffset + Clone,

fn clone(&self) -> FileEntry<R, Offset>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<R, Offset> Debug for FileEntry<R, Offset>

where R: Reader<Offset = Offset> + Debug, Offset: ReaderOffset + Debug,

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

Formats the value using the given formatter.

impl<R, Offset> PartialEq for FileEntry<R, Offset>

where R: Reader<Offset = Offset> + PartialEq, Offset: ReaderOffset + PartialEq,

fn eq(&self, other: &FileEntry<R, Offset>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<R, Offset> Copy for FileEntry<R, Offset>

where R: Reader<Offset = Offset> + Copy, Offset: ReaderOffset + Copy,

impl<R, Offset> Eq for FileEntry<R, Offset>

where R: Reader<Offset = Offset> + Eq, Offset: ReaderOffset + Eq,

impl<R, Offset> StructuralPartialEq for FileEntry<R, Offset>

where R: Reader<Offset = Offset>, Offset: ReaderOffset,