Struct cursive_hexview::HexView

pub struct HexView { /* fields omitted */ }

Hexadecimal viewer.

This is a classic hexview which can be used to view and manipulate data which resides inside this struct. There are severeal states in which the view can be operatered, see DisplayState. You should consider the corresponding method docs for each state.

Examples

extern crate cursive;
extern crate cursive_hexview;

use cursive_hexview::{DisplayState,HexView};

fn main() {
    let view = HexView::new().display_state(DisplayState::Editable);
    let mut cur = cursive::dummy();

    cur.add_layer(cursive::views::Dialog::around(view).title("HexView"));

    // cur.run();
}

Implementations

impl HexView

pub fn new() -> Self

Creates a new, default HexView with an empty databuffer and disabled state.

Examples

let view = HexView::new();

pub fn new_from_iter<B: Borrow<u8>, I: IntoIterator<Item = B>>(data: I) -> Self

Crates a new HexView with the given data and disabled state.

Examples

With data from a Vec:

let view = HexView::new_from_iter(vec![3, 6, 1, 8, 250]);

With data from a byte string literal:

let view = HexView::new_from_iter(b"Hello, World!");

Or with a slice

let view = HexView::new_from_iter(&[5, 6, 2, 89]);

pub fn set_config(&mut self, config: HexViewConfig)

This function allows the customization of the HexView output.

For options and explanation of every possible option, see the HexViewConfig struct.

#Examples

let mut view = HexView::new();
view.set_config(HexViewConfig {
    bytes_per_line: 8,
    ..Default::default()
});

pub fn config(self, config: HexViewConfig) -> Self

set_config

pub fn data(&self) -> &Vec<u8>

Returns a reference to the internal data.

Examples

let data = vec![3, 4, 9, 1];
let view = HexView::new_from_iter(data.clone());
assert_eq!(view.data(), &data);

pub fn set_data<B: Borrow<u8>, I: IntoIterator<Item = B>>(&mut self, data: I)

Sets the data during the lifetime of this instance.

For insance to update the data due to an external event.

let mut view = cursive_hexview::HexView::new();
view.set_data(b"Hello, World!".to_owned().iter());

pub fn display_state(self, state: DisplayState) -> Self

set_display_state

pub fn set_display_state(&mut self, state: DisplayState)

Sets the state of the view to one of the variants from DisplayState.

This will alter the behavior of the view accrodingly to the set state.

If the state is set to Disabled this view can neither be focused nor edited. If the state is set to Enabled it can be focused and the cursor can be moved around, but no data can be altered. If set to Editable this view behaves like Enabled but the data can be altered.

Note

This has nothing to do with rusts type system, which means even when this instance is set to Disabled you still can alter the data through set_data but you cannot alter it with the keyboard commands (+, -, #hexvalue).

Examples

let view = HexView::new().display_state(DisplayState::Editable);

pub fn len(&self) -> usize

Returns the length of the data.

Examples

let view = HexView::new_from_iter(vec![0, 1, 2, 3]);
assert_eq!(4, view.len());

pub fn is_empty(&self) -> bool

Checks whether the data is empty.

Examples

let view = HexView::new();
assert!(view.is_empty());

let view = HexView::new_from_iter(b"ABC");
assert!(!view.is_empty());

pub fn set_len(&mut self, length: usize)

Sets the length of the data which this view displays.

If the new length is greater than the current one, 0's will be appended to the data. If the new length is less than the current one, the data will be truncated and is lost.

Examples

let mut view = HexView::new();
view.set_len(3);

assert_eq!(view.len(), 3);
assert_eq!(view.data(), &vec![0u8, 0u8, 0u8]);

Trait Implementations

impl Default for HexView

fn default() -> Self

Creates a new, default HexView with an empty databuffer and disabled state.

impl View for HexView

fn on_event(&mut self, event: Event) -> EventResult

Called when an event is received (key press, mouse event, ...).

fn required_size(&mut self, _: Vec2) -> Vec2

Returns the minimum size the view requires with the given restrictions.

fn draw(&self, printer: &Printer<'_, '_>)

Draws the view with the given printer (includes bounds) and focus.

fn take_focus(&mut self, _: Direction) -> bool

This view is offered focus. Will it take it?

pub fn layout(&mut self, XY<usize>)

Called once the size for this view has been decided.

pub fn needs_relayout(&self) -> bool

Should return true if the view content changed since the last call to layout().

pub fn call_on_any(
    &mut self,
    &Selector<'_>,
    &'a mut (dyn FnMut(&mut (dyn View + 'static)) + 'a)
)

Runs a closure on the view identified by the given selector.

pub fn focus_view(&mut self, &Selector<'_>) -> Result<(), ViewNotFound>

Moves the focus to the view identified by the given selector.

pub fn important_area(&self, view_size: XY<usize>) -> Rect

What part of the view is important and should be visible?

pub fn type_name(&self) -> &'static str

Returns the type of this view.