BorrowedCursor in std::io - Rust (original) (raw)

Struct BorrowedCursor

Source

pub struct BorrowedCursor<'a> { /* private fields */ }

🔬This is a nightly-only experimental API. (core_io_borrowed_buf #117693)

Expand description

A writeable view of the unfilled portion of a BorrowedBuf.

The unfilled portion consists of an initialized and an uninitialized part; see BorrowedBuffor details.

Data can be written directly to the cursor by using append or indirectly by getting a slice of part or all of the cursor and writing into the slice. In the indirect case, the caller must call advance after writing to inform the cursor how many bytes have been written.

Once data is written to the cursor, it becomes part of the filled portion of the underlyingBorrowedBuf and can no longer be accessed or re-written by the cursor. I.e., the cursor tracks the unfilled part of the underlying BorrowedBuf.

The lifetime 'a is a bound on the lifetime of the underlying buffer (which means it is a bound on the data in that buffer by transitivity).

Source§

Source

🔬This is a nightly-only experimental API. (core_io_borrowed_buf #117693)

Reborrows this cursor by cloning it with a smaller lifetime.

Since a cursor maintains unique access to its underlying buffer, the borrowed cursor is not accessible while the new cursor exists.

Source

🔬This is a nightly-only experimental API. (core_io_borrowed_buf #117693)

Returns the available space in the cursor.

Source

🔬This is a nightly-only experimental API. (core_io_borrowed_buf #117693)

Returns the number of bytes written to this cursor since it was created from a BorrowedBuf.

Note that if this cursor is a reborrowed clone of another, then the count returned is the count written via either cursor, not the count since the cursor was reborrowed.

Source

🔬This is a nightly-only experimental API. (core_io_borrowed_buf #117693)

Returns a shared reference to the initialized portion of the cursor.

Source

🔬This is a nightly-only experimental API. (core_io_borrowed_buf #117693)

Returns a mutable reference to the initialized portion of the cursor.

Source

🔬This is a nightly-only experimental API. (core_io_borrowed_buf #117693)

Returns a mutable reference to the uninitialized part of the cursor.

It is safe to uninitialize any of these bytes.

Source

🔬This is a nightly-only experimental API. (core_io_borrowed_buf #117693)

Returns a mutable reference to the whole cursor.

§Safety

The caller must not uninitialize any bytes in the initialized portion of the cursor.

Source

🔬This is a nightly-only experimental API. (core_io_borrowed_buf #117693)

Advances the cursor by asserting that n bytes have been filled.

After advancing, the n bytes are no longer accessible via the cursor and can only be accessed via the underlying buffer. I.e., the buffer’s filled portion grows by n elements and its unfilled portion (and the capacity of this cursor) shrinks by n elements.

If less than n bytes initialized (by the cursor’s point of view), set_init should be called first.

§Panics

Panics if there are less than n bytes initialized.

Source

🔬This is a nightly-only experimental API. (core_io_borrowed_buf #117693)

Advances the cursor by asserting that n bytes have been filled.

After advancing, the n bytes are no longer accessible via the cursor and can only be accessed via the underlying buffer. I.e., the buffer’s filled portion grows by n elements and its unfilled portion (and the capacity of this cursor) shrinks by n elements.

§Safety

The caller must ensure that the first n bytes of the cursor have been properly initialised.

Source

🔬This is a nightly-only experimental API. (core_io_borrowed_buf #117693)

Initializes all bytes in the cursor.

Source

🔬This is a nightly-only experimental API. (core_io_borrowed_buf #117693)

Asserts that the first n unfilled bytes of the cursor are initialized.

BorrowedBuf assumes that bytes are never de-initialized, so this method does nothing when called with fewer bytes than are already known to be initialized.

§Safety

The caller must ensure that the first n bytes of the buffer have already been initialized.

Source

🔬This is a nightly-only experimental API. (core_io_borrowed_buf #117693)

Appends data to the cursor, advancing position within its buffer.

§Panics

Panics if self.capacity() is less than buf.len().

Source§

Source§

Source§

Writes a buffer into this writer, returning how many bytes were written. Read more

Source§

Flushes this output stream, ensuring that all intermediately buffered contents reach their destination. Read more

1.36.0 · Source§

Like write, except that it writes from a slice of buffers. Read more

Source§

🔬This is a nightly-only experimental API. (can_vector #69941)

1.0.0 · Source§

Attempts to write an entire buffer into this writer. Read more

Source§

🔬This is a nightly-only experimental API. (write_all_vectored #70436)

Attempts to write multiple buffers into this writer. Read more

1.0.0 · Source§

Writes a formatted string into this writer, returning any error encountered. Read more

1.0.0 · Source§

Creates a “by reference” adapter for this instance of Write. Read more

§

§

§

§

§

§