Struct Error 

pub struct Error { /* private fields */ }

Implementations

impl Error

pub fn new(state: SqlState, message: impl Into<String>) -> Error

An error with a SQLSTATE and a primary message.

pub fn corrupted(message: impl Into<String>) -> Error

An XX001 error. A check found damaged data.

pub fn internal(message: impl Into<String>) -> Error

An XX000 error. rupg found a state that its own rules do not allow.

pub fn with_detail(self, detail: impl Into<String>) -> Error

Adds the detail line.

pub fn with_hint(self, hint: impl Into<String>) -> Error

Adds the hint line.

pub fn at(self, location: usize) -> Error

Adds the place in the query text where the error starts, as a byte offset. The session gives it to the client as a character position in the field P. An error that has a place keeps it.

pub fn with_position(self, location: Option<usize>) -> Error

Sets the place in the query text and drops the place that the error has, as parser_errposition in an error context callback does. None drops the place.

pub fn with_context(self, line: impl Into<String>) -> Error

Adds a line to the context, as errcontext does in an error context callback. The lines go from the inner place to the outer place.

pub fn as_notice(self) -> Error

Marks a message for the client as a NOTICE, as ereport(NOTICE) with a SQLSTATE such as 54000 makes it. A message without the mark is a NOTICE only for a SQLSTATE of class 00.

pub fn is_notice(&self) -> bool

True for a message that Error::as_notice marked.

pub fn with_level(self, level: Level) -> Error

Sets the level of a message that is not an error, as ereport with a level such as INFO gives it.

pub fn level(&self) -> Option<Level>

The level that Error::with_level set, if any.

pub fn with_internal( self, query: impl Into<String>, position: Option<usize>, ) -> Error

Sets the internal query and the byte offset in it where the error starts, as internalerrquery and internalerrposition do. The session gives them to the client in the fields q and p.

pub fn internal_query(&self) -> Option<(&str, Option<usize>)>

The internal query and the byte offset in it, if any.

pub fn with_object(self, object: Object, name: impl Into<String>) -> Error

Sets a name of the object of the error, such as the table of a constraint that the error violates.

pub fn object(&self, object: Object) -> Option<&str>

The name that Error::with_object set, if any.

pub fn state(&self) -> SqlState

The SQLSTATE.

pub fn message(&self) -> &str

The primary message.

pub fn detail(&self) -> Option<&str>

The detail, if any.

pub fn hint(&self) -> Option<&str>

The hint, if any.

pub fn position(&self) -> Option<usize>

The byte offset in the query text where the error starts, if any.

pub fn context(&self) -> Option<&str>

The context lines, if any.

pub fn place(&self) -> &'static Location<'static>

The place in the source of rupg where the error was made.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Eq for Error

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for Error

Two errors are equal when they give the same fields to the client. The place in the source is not compared.

fn eq(&self, other: &Error) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.