[−][src]Struct rusqlite::blob::Blob
feature = "blob"
Handle to an open BLOB. See rusqlite::blob
documentation for
in-depth discussion.
Implementations
impl<'conn> Blob<'conn>
[src]
pub fn write_at(&mut self, buf: &[u8], write_start: usize) -> Result<()>
[src]
Write buf
to self
starting at write_start
, returning an error if
write_start + buf.len()
is past the end of the blob.
If an error is returned, no data is written.
Note: the blob cannot be resized using this function -- that must be
done using SQL (for example, an UPDATE
statement).
Note: This is part of the positional I/O API, and thus takes an absolute
position write to, instead of using the internal position that can be
manipulated by the std::io
traits.
Unlike the similarly named FileExt::write_at
function
(from std::os::unix
), it's always an error to perform a "short write".
pub fn write_all_at(&mut self, buf: &[u8], write_start: usize) -> Result<()>
[src]
An alias for write_at
provided for compatibility with the conceptually
equivalent std::os::unix::FileExt::write_all_at
function from libstd:
pub fn read_at(&self, buf: &mut [u8], read_start: usize) -> Result<usize>
[src]
Read as much as possible from offset
to offset + buf.len()
out of
self
, writing into buf
. On success, returns the number of bytes
written.
If there's insufficient data in self
, then the returned value will be
less than buf.len()
.
See also Blob::raw_read_at
, which can take an uninitialized buffer,
or Blob::read_at_exact
which returns an error if the entire buf
is
not read.
Note: This is part of the positional I/O API, and thus takes an absolute
position to read from, instead of using the internal position that can
be manipulated by the std::io
traits. Consequently, it does not change
that value either.
pub fn raw_read_at<'a>(
&self,
buf: &'a mut [MaybeUninit<u8>],
read_start: usize
) -> Result<&'a mut [u8]>
[src]
&self,
buf: &'a mut [MaybeUninit<u8>],
read_start: usize
) -> Result<&'a mut [u8]>
Read as much as possible from offset
to offset + buf.len()
out of
self
, writing into buf
. On success, returns the portion of buf
which was initialized by this call.
If there's insufficient data in self
, then the returned value will be
shorter than buf
.
See also Blob::read_at
, which takes a &mut [u8]
buffer instead of
a slice of MaybeUninit<u8>
.
Note: This is part of the positional I/O API, and thus takes an absolute
position to read from, instead of using the internal position that can
be manipulated by the std::io
traits. Consequently, it does not change
that value either.
pub fn read_at_exact(&self, buf: &mut [u8], read_start: usize) -> Result<()>
[src]
Equivalent to Blob::read_at
, but returns a BlobSizeError
if buf
is not fully initialized.
pub fn raw_read_at_exact<'a>(
&self,
buf: &'a mut [MaybeUninit<u8>],
read_start: usize
) -> Result<&'a mut [u8]>
[src]
&self,
buf: &'a mut [MaybeUninit<u8>],
read_start: usize
) -> Result<&'a mut [u8]>
Equivalent to Blob::raw_read_at
, but returns a BlobSizeError
if
buf
is not fully initialized.
impl<'_> Blob<'_>
[src]
pub fn reopen(&mut self, row: i64) -> Result<()>
[src]
Move a BLOB handle to a new row.
Failure
Will return Err
if the underlying SQLite BLOB reopen call fails.
pub fn size(&self) -> i32
[src]
Return the size in bytes of the BLOB.
pub fn len(&self) -> usize
[src]
Return the current size in bytes of the BLOB.
pub fn is_empty(&self) -> bool
[src]
Return true if the BLOB is empty.
pub fn close(self) -> Result<()>
[src]
Close a BLOB handle.
Calling close
explicitly is not required (the BLOB will be closed
when the Blob
is dropped), but it is available so you can get any
errors that occur.
Failure
Will return Err
if the underlying SQLite close call fails.
Trait Implementations
impl<'_> Drop for Blob<'_>
[src]
impl<'_> Read for Blob<'_>
[src]
pub fn read(&mut self, buf: &mut [u8]) -> Result<usize>
[src]
Read data from a BLOB incrementally. Will return Ok(0) if the end of the blob has been reached.
Failure
Will return Err
if the underlying SQLite read call fails.
pub fn read_vectored(
&mut self,
bufs: &mut [IoSliceMut<'_>]
) -> Result<usize, Error>
1.36.0[src]
&mut self,
bufs: &mut [IoSliceMut<'_>]
) -> Result<usize, Error>
pub fn is_read_vectored(&self) -> bool
[src]
pub unsafe fn initializer(&self) -> Initializer
[src]
pub fn read_to_end(&mut self, buf: &mut Vec<u8, Global>) -> Result<usize, Error>
1.0.0[src]
pub fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>
1.0.0[src]
pub fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>
1.6.0[src]
pub fn by_ref(&mut self) -> &mut Self
1.0.0[src]
pub fn bytes(self) -> Bytes<Self>
1.0.0[src]
pub fn chain<R>(self, next: R) -> Chain<Self, R> where
R: Read,
1.0.0[src]
R: Read,
pub fn take(self, limit: u64) -> Take<Self>
1.0.0[src]
impl<'_> Seek for Blob<'_>
[src]
pub fn seek(&mut self, pos: SeekFrom) -> Result<u64>
[src]
Seek to an offset, in bytes, in BLOB.
pub fn stream_len(&mut self) -> Result<u64, Error>
[src]
pub fn stream_position(&mut self) -> Result<u64, Error>
[src]
impl<'_> Write for Blob<'_>
[src]
pub fn write(&mut self, buf: &[u8]) -> Result<usize>
[src]
Write data into a BLOB incrementally. Will return Ok(0)
if the end of
the blob has been reached; consider using Write::write_all(buf)
if you want to get an error if the entirety of the buffer cannot be
written.
This function may only modify the contents of the BLOB; it is not possible to increase the size of a BLOB using this API.
Failure
Will return Err
if the underlying SQLite write call fails.
pub fn flush(&mut self) -> Result<()>
[src]
pub fn write_vectored(&mut self, bufs: &[IoSlice<'_>]) -> Result<usize, Error>
1.36.0[src]
pub fn is_write_vectored(&self) -> bool
[src]
pub fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>
1.0.0[src]
pub fn write_all_vectored(
&mut self,
bufs: &mut [IoSlice<'_>]
) -> Result<(), Error>
[src]
&mut self,
bufs: &mut [IoSlice<'_>]
) -> Result<(), Error>
pub fn write_fmt(&mut self, fmt: Arguments<'_>) -> Result<(), Error>
1.0.0[src]
pub fn by_ref(&mut self) -> &mut Self
1.0.0[src]
Auto Trait Implementations
impl<'conn> !RefUnwindSafe for Blob<'conn>
impl<'conn> !Send for Blob<'conn>
impl<'conn> !Sync for Blob<'conn>
impl<'conn> Unpin for Blob<'conn>
impl<'conn> !UnwindSafe for Blob<'conn>
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,