Enum PositionEncoding 

pub enum PositionEncoding {
    Utf8,
    Utf16,
}

LSP position-encoding negotiated with the client at initialization.

Per LSP 3.17, a client advertises which encodings it accepts via InitializeParams.capabilities.general.positionEncodings. The server replies with the encoding it will use; clients that don’t negotiate get the default (UTF-16). Modern editors (VS Code, neovim, helix, zed) negotiate UTF-8 because that’s cheaper than re-encoding every diagnostic position.

All position emission paths in the LSP layer should consult this type — emitting LSP positions in a different encoding than the negotiated one will misalign on non-ASCII content. Today most handlers in this crate emit byte (UTF-8) offsets via LineIndex::offset_to_position; that works under UTF-8 negotiation but is wrong for UTF-16-only clients. See server.rs::run for the negotiation site and MainLoopState for the storage.

Variants

Utf8

UTF-8 byte offsets. The native unit of the underlying source representation; preferred by modern editors.

Utf16

UTF-16 code units. The LSP 3.17 default for clients that don’t negotiate.

Implementations

impl PositionEncoding

pub fn from_negotiated(negotiated: Option<&PositionEncodingKind>) -> Self

Decide the negotiated encoding from a ServerCapabilities- shaped value. Some(UTF8) → UTF-8; None → UTF-16 (the LSP default).

Trait Implementations

impl Clone for PositionEncoding

fn clone(&self) -> PositionEncoding

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PositionEncoding

impl Debug for PositionEncoding

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

Formats the value using the given formatter.

impl Eq for PositionEncoding

impl PartialEq for PositionEncoding

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PositionEncoding