Enum jni::JvmError

#[non_exhaustive]
pub enum JvmError {
    NullOptString(String),
    OptStringTooLong {
        opt_string: String,
    },
    OptStringNotRepresentable {
        opt_string: String,
    },
    OptStringTranscodeFailure {
        opt_string: String,
        error: Error,
    },
}

Errors that can occur when invoking a JavaVM with the Invocation API.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NullOptString(String)

InitArgsBuilder::option or InitArgsBuilder::try_option was used, but the supplied string contains a U+0000 code point (except at the end).

This error is not raised if the string has a single U+0000 code point at the end.

InitArgsBuilder::option_encoded never raises this error.

OptStringTooLong

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

opt_string: String

The option string.

InitArgsBuilder::option or InitArgsBuilder::try_option was used, but the option string is too long.

Currently, this error only occurs on Windows, where string length is limited to 1MB to avoid overflow in WideCharToMultiByte (see discussion). String length is not currently limited (other than by available memory) on other platforms.

InitArgsBuilder::option_encoded never raises this error, regardless of platform.

OptStringNotRepresentable

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

opt_string: String

The option string.

InitArgsBuilder::option or InitArgsBuilder::try_option was used, but the option string is not representable in the platform default character encoding.

InitArgsBuilder::option_encoded never raises this error.

OptStringTranscodeFailure

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

opt_string: String

The option string.

error: Error

The error reported by the platform’s character encoding conversion routine.

InitArgsBuilder::option or InitArgsBuilder::try_option was used, but the platform reported an error converting it to its default character encoding.

InitArgsBuilder::option_encoded never raises this error.

Implementations

impl JvmError

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

Returns the JVM option that caused the error, if it was caused by one.

Trait Implementations

impl Debug for JvmError

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

Formats the value using the given formatter.

impl Display for JvmError

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

Formats the value using the given formatter.

impl Error for JvmError

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

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, demand: &mut Demand<'a>)

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

Provides type based access to context intended for error reports.