Struct test_assembler::Section

pub struct Section {
    pub endian: Endian,
    // some fields omitted
}

A section is a sequence of bytes, constructed by appending bytes to the end.

Sections have a convenient and flexible set of member functions for appending data in various formats: big-endian and little-endian signed and unsigned values of different sizes, and raw blocks of bytes.

There are methods for appending each of u8, u16, u32, and u64 in each of big, little, or the Section's default endianness. The method names are {D,L,B}{8,16,32,64} for each variant, so D16 writes a u16 in the Section's default endianness, and L64 writes a u64 in little-endian byte order.

Each of these methods also accepts a Label to write non-constant values.

See the module-level documentation for examples.

Fields

endian: Endian

The current endianness of the writer.

This sets the behavior of the D appending functions.

Methods

impl Section

fn new() -> Section

Construct a Section with platform-default endianness.

fn with_endian(endian: Endian) -> Section

Construct a Section with endian endianness.

fn size(&self) -> u64

Return the current size of the section.

fn final_size(&self) -> Label

Return a Label that will resolve to the final size of the section.

This label is undefined until get_contents is called.

fn get_contents(self) -> Option<Vec<u8>>

Get the contents of this section as a slice of bytes.

Consumes the section. If there were still undefined labels, return None.

fn start(&self) -> Label

Return a label representing the start of the section.

It is up to the user whether this label represents the section's position in an object file, the section's address in memory, or what have you; some applications may need both, in which case this simple-minded interface won't be enough. This class only provides a single start label, for use with the Here and Mark member functions.

fn here(&self) -> Label

A label representing the point at which the next Appended item will appear in the section, relative to start().

fn set_start_const(self, value: u64) -> Section

Set the value of start() to value.

fn mark(self, label: &Label) -> Section

Set label to Here, and return this section.

fn append_bytes(self, data: &[u8]) -> Section

Append data to the end of this section.

Return this section.

fn append_section<S: Into<Section>>(self, section: S) -> Section

Append section's contents to the end of this section.

Any Labels that were appended to section will not be resolved until this section is finalized. Return this section.

fn append_repeated(self, byte: u8, count: usize) -> Section

Append count copies of byte to the end of this section.

Return this section.

fn align(self, alignment: u64) -> Section

Jump to the next location aligned on an alignment-byte boundary, relative to the start of the section.

Fill the gap with zeroes. alignment must be a power of two. Return this section.

fn D8<'a, T: ToLabelOrNum<'a, u8>>(self, byte: T) -> Section

Append byte with the Section's default endianness.

byte may be a Label or a u8. Return this section.

fn L8<'a, T: ToLabelOrNum<'a, u8>>(self, byte: T) -> Section

Append byte as little-endian (identical to D8).

Return this section.

fn B8<'a, T: ToLabelOrNum<'a, u8>>(self, byte: T) -> Section

Append byte as big-endian (identical to D8).

Return this section.

fn D16<'a, T: ToLabelOrNum<'a, u16>>(self, word: T) -> Section

Append word with the Section's default endianness.

word may be a Label or a u16. Return this section.

fn L16<'a, T: ToLabelOrNum<'a, u16>>(self, word: T) -> Section

Append word as little-endian.

word may be a Label or a u16. Return this section.

fn B16<'a, T: ToLabelOrNum<'a, u16>>(self, word: T) -> Section

Append word as big-endian.

word may be a Label or a u16. Return this section.

fn D32<'a, T: ToLabelOrNum<'a, u32>>(self, dword: T) -> Section

Append dword with the Section's default endianness.

dword may be a Label or a u32. Return this section.

fn L32<'a, T: ToLabelOrNum<'a, u32>>(self, dword: T) -> Section

Append dword as little-endian.

dword may be a Label or a u32. Return this section.

fn B32<'a, T: ToLabelOrNum<'a, u32>>(self, dword: T) -> Section

Append dword as big-endian.

dword may be a Label or a u32. Return this section.

fn D64<'a, T: ToLabelOrNum<'a, u64>>(self, qword: T) -> Section

Append qword with the Section's default endianness.

qword may be a Label or a u32. Return this section.

fn L64<'a, T: ToLabelOrNum<'a, u64>>(self, qword: T) -> Section

Append qword as little-endian.

qword may be a Label or a u32. Return this section.

fn B64<'a, T: ToLabelOrNum<'a, u64>>(self, qword: T) -> Section

Append qword as big-endian.

qword may be a Label or a u32. Return this section.