Struct PositionEncodings 

pub struct PositionEncodings(/* private fields */);

A non-empty position-encoding preference order, offered to each spawned server as capabilities.general.positionEncodings during initialize.

Deserializes from a list of "utf-8", "utf-16" or "utf-32" strings and rejects an empty list or any other value at load time.

Examples

use mcpls_core::bridge::PositionEncoding;
use mcpls_core::config::PositionEncodings;

assert!(PositionEncodings::new(vec![]).is_err());
let encodings = PositionEncodings::new(vec![PositionEncoding::Utf32]).unwrap();
assert_eq!(encodings.as_slice(), [PositionEncoding::Utf32]);
assert_eq!(
    PositionEncodings::DEFAULT.as_slice(),
    [PositionEncoding::Utf8, PositionEncoding::Utf16]
);

Implementations

impl PositionEncodings

pub const DEFAULT: Self

utf-8 first, then utf-16.

utf-8 is listed first deliberately: rust-analyzer and clangd both negotiate down to it, so the non-UTF-16 conversion path in bridge/encoding.rs is the common case, not an edge case.

pub fn new( encodings: Vec<PositionEncoding>, ) -> Result<Self, InvalidPositionEncodings>

Builds a preference order from encodings.

Errors

Returns InvalidPositionEncodings::Empty for an empty list.

pub fn as_slice(&self) -> &[PositionEncoding]

The encodings in preference order; never empty.

Trait Implementations

impl Clone for PositionEncodings

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 PositionEncodings

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

Formats the value using the given formatter.

impl Default for PositionEncodings

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PositionEncodings

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PositionEncodings

impl From<PositionEncodings> for Vec<PositionEncoding>

fn from(encodings: PositionEncodings) -> Self

Converts to this type from the input type.

impl PartialEq for PositionEncodings

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for PositionEncodings

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PositionEncodings

impl TryFrom<Vec<PositionEncoding>> for PositionEncodings

type Error = InvalidPositionEncodings

The type returned in the event of a conversion error.

fn try_from(encodings: Vec<PositionEncoding>) -> Result<Self, Self::Error>

Performs the conversion.