rusqlite

Struct Row

Source 
pub struct Row<'stmt> { /* private fields */ }
Expand description

A single result row of a query.

Implementations§

Source§

impl Row<'_>

Source

pub fn get_unwrap<I: RowIndex, T: FromSql>(&self, idx: I) -> T

Get the value of a particular column of the result row.

§Panics

Panics if calling row.get(idx) would return an error, including:

  • If the underlying SQLite column type is not a valid type as a source for T
  • If the underlying SQLite integral value is outside the range representable by T
  • If idx is outside the range of columns in the returned query
Source

pub fn get<I: RowIndex, T: FromSql>(&self, idx: I) -> Result<T>

Get the value of a particular column of the result row.

§Failure

Returns an Error::InvalidColumnType if the underlying SQLite column type is not a valid type as a source for T.

Returns an Error::InvalidColumnIndex if idx is outside the valid column range for this row.

Returns an Error::InvalidColumnName if idx is not a valid column name for this row.

If the result type is i128 (which requires the i128_blob feature to be enabled), and the underlying SQLite column is a blob whose size is not 16 bytes, Error::InvalidColumnType will also be returned.

Source

pub fn get_ref<I: RowIndex>(&self, idx: I) -> Result<ValueRef<'_>>

Get the value of a particular column of the result row as a ValueRef, allowing data to be read out of a row without copying.

This ValueRef is valid only as long as this Row, which is enforced by its lifetime. This means that while this method is completely safe, it can be somewhat difficult to use, and most callers will be better served by get or get_unwrap.

§Failure

Returns an Error::InvalidColumnIndex if idx is outside the valid column range for this row.

Returns an Error::InvalidColumnName if idx is not a valid column name for this row.

Source

pub fn get_ref_unwrap<I: RowIndex>(&self, idx: I) -> ValueRef<'_>

Get the value of a particular column of the result row as a ValueRef, allowing data to be read out of a row without copying.

This ValueRef is valid only as long as this Row, which is enforced by its lifetime. This means that while this method is completely safe, it can be difficult to use, and most callers will be better served by get or get_unwrap.

§Panics

Panics if calling row.get_ref(idx) would return an error, including:

  • If idx is outside the range of columns in the returned query.
  • If idx is not a valid column name for this row.

Trait Implementations§

Source§

impl<'stmt> AsRef<Statement<'stmt>> for Row<'stmt>

Source§

fn as_ref(&self) -> &Statement<'stmt>

Converts this type into a shared reference of the (usually inferred) input type.
Source§

impl Debug for Row<'_>

Debug Row like an ordered Map<Result<&str>, Result<(Type, ValueRef)>> with column name as key except that for Type::Blob only its size is printed (not its content).

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl<'a> TryFrom<&'a Row<'a>> for ()

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P> TryFrom<&'a Row<'a>> for (A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P)
where A: FromSql, B: FromSql, C: FromSql, D: FromSql, E: FromSql, F: FromSql, G: FromSql, H: FromSql, I: FromSql, J: FromSql, K: FromSql, L: FromSql, M: FromSql, N: FromSql, O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P> TryFrom<&'a Row<'a>> for (B, C, D, E, F, G, H, I, J, K, L, M, N, O, P)
where B: FromSql, C: FromSql, D: FromSql, E: FromSql, F: FromSql, G: FromSql, H: FromSql, I: FromSql, J: FromSql, K: FromSql, L: FromSql, M: FromSql, N: FromSql, O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, C, D, E, F, G, H, I, J, K, L, M, N, O, P> TryFrom<&'a Row<'a>> for (C, D, E, F, G, H, I, J, K, L, M, N, O, P)
where C: FromSql, D: FromSql, E: FromSql, F: FromSql, G: FromSql, H: FromSql, I: FromSql, J: FromSql, K: FromSql, L: FromSql, M: FromSql, N: FromSql, O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, D, E, F, G, H, I, J, K, L, M, N, O, P> TryFrom<&'a Row<'a>> for (D, E, F, G, H, I, J, K, L, M, N, O, P)
where D: FromSql, E: FromSql, F: FromSql, G: FromSql, H: FromSql, I: FromSql, J: FromSql, K: FromSql, L: FromSql, M: FromSql, N: FromSql, O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, E, F, G, H, I, J, K, L, M, N, O, P> TryFrom<&'a Row<'a>> for (E, F, G, H, I, J, K, L, M, N, O, P)
where E: FromSql, F: FromSql, G: FromSql, H: FromSql, I: FromSql, J: FromSql, K: FromSql, L: FromSql, M: FromSql, N: FromSql, O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, F, G, H, I, J, K, L, M, N, O, P> TryFrom<&'a Row<'a>> for (F, G, H, I, J, K, L, M, N, O, P)
where F: FromSql, G: FromSql, H: FromSql, I: FromSql, J: FromSql, K: FromSql, L: FromSql, M: FromSql, N: FromSql, O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, G, H, I, J, K, L, M, N, O, P> TryFrom<&'a Row<'a>> for (G, H, I, J, K, L, M, N, O, P)
where G: FromSql, H: FromSql, I: FromSql, J: FromSql, K: FromSql, L: FromSql, M: FromSql, N: FromSql, O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, H, I, J, K, L, M, N, O, P> TryFrom<&'a Row<'a>> for (H, I, J, K, L, M, N, O, P)
where H: FromSql, I: FromSql, J: FromSql, K: FromSql, L: FromSql, M: FromSql, N: FromSql, O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, I, J, K, L, M, N, O, P> TryFrom<&'a Row<'a>> for (I, J, K, L, M, N, O, P)
where I: FromSql, J: FromSql, K: FromSql, L: FromSql, M: FromSql, N: FromSql, O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, J, K, L, M, N, O, P> TryFrom<&'a Row<'a>> for (J, K, L, M, N, O, P)
where J: FromSql, K: FromSql, L: FromSql, M: FromSql, N: FromSql, O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, K, L, M, N, O, P> TryFrom<&'a Row<'a>> for (K, L, M, N, O, P)
where K: FromSql, L: FromSql, M: FromSql, N: FromSql, O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, L, M, N, O, P> TryFrom<&'a Row<'a>> for (L, M, N, O, P)
where L: FromSql, M: FromSql, N: FromSql, O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, M, N, O, P> TryFrom<&'a Row<'a>> for (M, N, O, P)
where M: FromSql, N: FromSql, O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, N, O, P> TryFrom<&'a Row<'a>> for (N, O, P)
where N: FromSql, O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, O, P> TryFrom<&'a Row<'a>> for (O, P)
where O: FromSql, P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.
Source§

impl<'a, P> TryFrom<&'a Row<'a>> for (P,)
where P: FromSql,

Source§

type Error = Error

The type returned in the event of a conversion error.
Source§

fn try_from(row: &'a Row<'a>) -> Result<Self>

Performs the conversion.

Auto Trait Implementations§

§

impl<'stmt> !Crossing for Row<'stmt>

§

impl<'stmt> Freeze for Row<'stmt>

§

impl<'stmt> !ObjSafe for Row<'stmt>

§

impl<'stmt> !RefUnwindSafe for Row<'stmt>

§

impl<'stmt> !Send for Row<'stmt>

§

impl<'stmt> StoreCopy for Row<'stmt>

§

impl<'stmt> !Sync for Row<'stmt>

§

impl<'stmt> Unpin for Row<'stmt>

§

impl<'stmt> !UnwindSafe for Row<'stmt>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<D> OwoColorize for D

§

fn fg<C>(&self) -> FgColorDisplay<'_, C, Self>
where C: Color,

Set the foreground color generically Read more
§

fn bg<C>(&self) -> BgColorDisplay<'_, C, Self>
where C: Color,

Set the background color generically. Read more
§

fn black(&self) -> FgColorDisplay<'_, Black, Self>

Change the foreground color to black
§

fn on_black(&self) -> BgColorDisplay<'_, Black, Self>

Change the background color to black
§

fn red(&self) -> FgColorDisplay<'_, Red, Self>

Change the foreground color to red
§

fn on_red(&self) -> BgColorDisplay<'_, Red, Self>

Change the background color to red
§

fn green(&self) -> FgColorDisplay<'_, Green, Self>

Change the foreground color to green
§

fn on_green(&self) -> BgColorDisplay<'_, Green, Self>

Change the background color to green
§

fn yellow(&self) -> FgColorDisplay<'_, Yellow, Self>

Change the foreground color to yellow
§

fn on_yellow(&self) -> BgColorDisplay<'_, Yellow, Self>

Change the background color to yellow
§

fn blue(&self) -> FgColorDisplay<'_, Blue, Self>

Change the foreground color to blue
§

fn on_blue(&self) -> BgColorDisplay<'_, Blue, Self>

Change the background color to blue
§

fn magenta(&self) -> FgColorDisplay<'_, Magenta, Self>

Change the foreground color to magenta
§

fn on_magenta(&self) -> BgColorDisplay<'_, Magenta, Self>

Change the background color to magenta
§

fn purple(&self) -> FgColorDisplay<'_, Magenta, Self>

Change the foreground color to purple
§

fn on_purple(&self) -> BgColorDisplay<'_, Magenta, Self>

Change the background color to purple
§

fn cyan(&self) -> FgColorDisplay<'_, Cyan, Self>

Change the foreground color to cyan
§

fn on_cyan(&self) -> BgColorDisplay<'_, Cyan, Self>

Change the background color to cyan
§

fn white(&self) -> FgColorDisplay<'_, White, Self>

Change the foreground color to white
§

fn on_white(&self) -> BgColorDisplay<'_, White, Self>

Change the background color to white
§

fn default_color(&self) -> FgColorDisplay<'_, Default, Self>

Change the foreground color to the terminal default
§

fn on_default_color(&self) -> BgColorDisplay<'_, Default, Self>

Change the background color to the terminal default
§

fn bright_black(&self) -> FgColorDisplay<'_, BrightBlack, Self>

Change the foreground color to bright black
§

fn on_bright_black(&self) -> BgColorDisplay<'_, BrightBlack, Self>

Change the background color to bright black
§

fn bright_red(&self) -> FgColorDisplay<'_, BrightRed, Self>

Change the foreground color to bright red
§

fn on_bright_red(&self) -> BgColorDisplay<'_, BrightRed, Self>

Change the background color to bright red
§

fn bright_green(&self) -> FgColorDisplay<'_, BrightGreen, Self>

Change the foreground color to bright green
§

fn on_bright_green(&self) -> BgColorDisplay<'_, BrightGreen, Self>

Change the background color to bright green
§

fn bright_yellow(&self) -> FgColorDisplay<'_, BrightYellow, Self>

Change the foreground color to bright yellow
§

fn on_bright_yellow(&self) -> BgColorDisplay<'_, BrightYellow, Self>

Change the background color to bright yellow
§

fn bright_blue(&self) -> FgColorDisplay<'_, BrightBlue, Self>

Change the foreground color to bright blue
§

fn on_bright_blue(&self) -> BgColorDisplay<'_, BrightBlue, Self>

Change the background color to bright blue
§

fn bright_magenta(&self) -> FgColorDisplay<'_, BrightMagenta, Self>

Change the foreground color to bright magenta
§

fn on_bright_magenta(&self) -> BgColorDisplay<'_, BrightMagenta, Self>

Change the background color to bright magenta
§

fn bright_purple(&self) -> FgColorDisplay<'_, BrightMagenta, Self>

Change the foreground color to bright purple
§

fn on_bright_purple(&self) -> BgColorDisplay<'_, BrightMagenta, Self>

Change the background color to bright purple
§

fn bright_cyan(&self) -> FgColorDisplay<'_, BrightCyan, Self>

Change the foreground color to bright cyan
§

fn on_bright_cyan(&self) -> BgColorDisplay<'_, BrightCyan, Self>

Change the background color to bright cyan
§

fn bright_white(&self) -> FgColorDisplay<'_, BrightWhite, Self>

Change the foreground color to bright white
§

fn on_bright_white(&self) -> BgColorDisplay<'_, BrightWhite, Self>

Change the background color to bright white
§

fn bold(&self) -> BoldDisplay<'_, Self>

Make the text bold
§

fn dimmed(&self) -> DimDisplay<'_, Self>

Make the text dim
§

fn italic(&self) -> ItalicDisplay<'_, Self>

Make the text italicized
§

fn underline(&self) -> UnderlineDisplay<'_, Self>

Make the text underlined
Make the text blink
Make the text blink (but fast!)
§

fn reversed(&self) -> ReversedDisplay<'_, Self>

Swap the foreground and background colors
§

fn hidden(&self) -> HiddenDisplay<'_, Self>

Hide the text
§

fn strikethrough(&self) -> StrikeThroughDisplay<'_, Self>

Cross out the text
§

fn color<Color>(&self, color: Color) -> FgDynColorDisplay<'_, Color, Self>
where Color: DynColor,

Set the foreground color at runtime. Only use if you do not know which color will be used at compile-time. If the color is constant, use either [OwoColorize::fg] or a color-specific method, such as [OwoColorize::green], Read more
§

fn on_color<Color>(&self, color: Color) -> BgDynColorDisplay<'_, Color, Self>
where Color: DynColor,

Set the background color at runtime. Only use if you do not know what color to use at compile-time. If the color is constant, use either [OwoColorize::bg] or a color-specific method, such as [OwoColorize::on_yellow], Read more
§

fn fg_rgb<const R: u8, const G: u8, const B: u8>( &self, ) -> FgColorDisplay<'_, CustomColor<R, G, B>, Self>

Set the foreground color to a specific RGB value.
§

fn bg_rgb<const R: u8, const G: u8, const B: u8>( &self, ) -> BgColorDisplay<'_, CustomColor<R, G, B>, Self>

Set the background color to a specific RGB value.
§

fn truecolor(&self, r: u8, g: u8, b: u8) -> FgDynColorDisplay<'_, Rgb, Self>

Sets the foreground color to an RGB value.
§

fn on_truecolor(&self, r: u8, g: u8, b: u8) -> BgDynColorDisplay<'_, Rgb, Self>

Sets the background color to an RGB value.
§

fn style(&self, style: Style) -> Styled<&Self>

Apply a runtime-determined style
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more