Struct tokio_io::codec::length_delimited::Builder [] [src]

pub struct Builder { /* fields omitted */ }

Configure length delimited FramedRead, FramedWrite, and Framed values.

Builder enables constructing configured length delimited framers. Note that not all configuration settings apply to both encoding and decoding. See the documentation for specific methods for more detail.

Methods

impl Builder
[src]

[src]

Creates a new length delimited framer builder with default configuration values.

Examples

use tokio_io::codec::length_delimited::Builder;

Builder::new()
    .length_field_offset(0)
    .length_field_length(2)
    .length_adjustment(0)
    .num_skip(0)
    .new_read(io);

[src]

Read the length field as a big endian integer

This is the default setting.

This configuration option applies to both encoding and decoding.

Examples

use tokio_io::codec::length_delimited::Builder;

Builder::new()
    .big_endian()
    .new_read(io);

[src]

Read the length field as a little endian integer

The default setting is big endian.

This configuration option applies to both encoding and decoding.

Examples

use tokio_io::codec::length_delimited::Builder;

Builder::new()
    .little_endian()
    .new_read(io);

[src]

Read the length field as a native endian integer

The default setting is big endian.

This configuration option applies to both encoding and decoding.

Examples

use tokio_io::codec::length_delimited::Builder;

Builder::new()
    .native_endian()
    .new_read(io);

[src]

Sets the max frame length

This configuration option applies to both encoding and decoding. The default value is 8MB.

When decoding, the length field read from the byte stream is checked against this setting before any adjustments are applied. When encoding, the length of the submitted payload is checked against this setting.

When frames exceed the max length, an io::Error with the custom value of the FrameTooBig type will be returned.

Examples

use tokio_io::codec::length_delimited::Builder;

Builder::new()
    .max_frame_length(8 * 1024)
    .new_read(io);

[src]

Sets the number of bytes used to represent the length field

The default value is 4. The max value is 8.

This configuration option applies to both encoding and decoding.

Examples

use tokio_io::codec::length_delimited::Builder;

Builder::new()
    .length_field_length(4)
    .new_read(io);

[src]

Sets the number of bytes in the header before the length field

This configuration option only applies to decoding.

Examples

use tokio_io::codec::length_delimited::Builder;

Builder::new()
    .length_field_offset(1)
    .new_read(io);

[src]

Delta between the payload length specified in the header and the real payload length

Examples

use tokio_io::codec::length_delimited::Builder;

Builder::new()
    .length_adjustment(-2)
    .new_read(io);

[src]

Sets the number of bytes to skip before reading the payload

Default value is length_field_len + length_field_offset

This configuration option only applies to decoding

Examples

use tokio_io::codec::length_delimited::Builder;

Builder::new()
    .num_skip(4)
    .new_read(io);

Important traits for FramedRead<T>
[src]

Create a configured length delimited FramedRead

Examples

use tokio_io::codec::length_delimited::Builder;

Builder::new()
    .length_field_offset(0)
    .length_field_length(2)
    .length_adjustment(0)
    .num_skip(0)
    .new_read(io);

Important traits for FramedWrite<T, B>
[src]

Create a configured length delimited FramedWrite

Examples

length_delimited::Builder::new()
    .length_field_length(2)
    .new_write(io);

[src]

Create a configured length delimited Framed

Examples

length_delimited::Builder::new()
    .length_field_length(2)
    .new_framed(io);

Trait Implementations

impl Debug for Builder
[src]

[src]

Formats the value using the given formatter. Read more

impl Clone for Builder
[src]

[src]

Returns a copy of the value. Read more

1.0.0
[src]

Performs copy-assignment from source. Read more

impl Copy for Builder
[src]