Enum ForClause 

pub enum ForClause {
    Xml {
        mode: ForXmlMode,
        elements: Option<ForXmlElements>,
        binary_base64: bool,
        typed: bool,
        root: Option<ForRoot>,
        meta: Meta,
    },
    Json {
        mode: ForJsonMode,
        root: Option<ForRoot>,
        include_null_values: bool,
        without_array_wrapper: bool,
        meta: Meta,
    },
}

MSSQL FOR XML / FOR JSON result-shaping tail on a Query (Query::for_clause): SELECT … FOR XML {RAW|AUTO|EXPLICIT|PATH} [, …] and SELECT … FOR JSON {AUTO|PATH} [, …], which serialize the result set as XML or JSON instead of a rowset.

Parity with sqlparser-rs ForClause

Mirrors sqlparser-rs’s ForClause enum (its Xml { for_xml, elements, binary_base64, root, r#type } / Json { for_json, root, include_null_values, without_array_wrapper } variants), with three deliberate reshapings:

• The RAW/AUTO/EXPLICIT/PATH and AUTO/PATH selectors are their own ForXmlMode / ForJsonMode axes carrying the optional ('name') element name on the arms that take one (RAW/PATH), rather than sqlparser-rs’s flatter ForXml/ForJson with a separate name — the name is a property of the mode, so it rides the mode arm (the canonical-shape doctrine, ADR-0011).
• ELEMENTS is Option<ForXmlElements> — None for the attribute-centric default, Some carrying the XSINIL/ABSENT null-handling refinement — where sqlparser-rs drops the refinement onto a bare elements: bool.
• ROOT ['name'] is Option<ForRoot> (presence = the ROOT keyword; the inner name is optional) shared by both variants, where sqlparser-rs models it per-variant as root: Option<String> — losing the bare-ROOT vs no-ROOT distinction our shape keeps.

sqlparser-rs’s ForClause::Browse (FOR BROWSE) is out of scope: this ticket covers only the FOR XML/FOR JSON result-shaping tails.

Gating and FOR disambiguation

Gated by QueryTailSyntax::for_xml_json_clause — on for MSSQL and the permissive Lenient union, off elsewhere; with the gate off the FOR keyword in this position is left unconsumed and surfaces as a clean parse error. FOR also introduces the row-locking clauses (Query::locking, gated by QueryTailSyntax::locking_clauses); the two share the FOR lead but partition on the follow token — XML/JSON here versus UPDATE/SHARE/NO/KEY for locking — so the dispatch is unambiguous under every preset combination, including Lenient (the one preset that enables both), and needs no GrammarConflict registry entry.

There is no MSSQL oracle, so the accepted grammar is the recorded acceptance bound (self-consistent round-trip tests plus the MSSQL FOR XML/FOR JSON docs cited on the gating flag). Options are accepted order-independently and rendered in the canonical MSSQL directive order. Carries only mode tags and quoted-name Literals (no Expr), so it is not generic over the extension parameter.

Variants

Xml

FOR XML {RAW|AUTO|EXPLICIT|PATH} [, BINARY BASE64] [, TYPE] [, ROOT ['name']] [, ELEMENTS [XSINIL|ABSENT]].

Fields

mode: ForXmlMode

Mode selected by this syntax.

elements: Option<ForXmlElements>

The ELEMENTS [XSINIL|ABSENT] element-centric directive; None for the attribute-centric default.

binary_base64: bool

BINARY BASE64 — encode binary columns as Base64 rather than a URL reference.

typed: bool

TYPE — return the result as an xml-typed value rather than text.

root: Option<ForRoot>

ROOT ['name'] wrapper element; None when no ROOT directive is written.

meta: Meta

Source location and node identity.

Json

FOR JSON {AUTO|PATH} [, ROOT ['name']] [, INCLUDE_NULL_VALUES] [, WITHOUT_ARRAY_WRAPPER].

Fields

mode: ForJsonMode

Mode selected by this syntax.

root: Option<ForRoot>

ROOT ['name'] wrapper property; None when no ROOT directive is written.

include_null_values: bool

INCLUDE_NULL_VALUES — emit null-valued properties instead of omitting them.

without_array_wrapper: bool

WITHOUT_ARRAY_WRAPPER — emit a single object rather than a JSON array.

meta: Meta

Source location and node identity.

Trait Implementations

impl Clone for ForClause

fn clone(&self) -> ForClause

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ForClause

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ForClause

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ForClause

impl Hash for ForClause

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ForClause

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

Equality operator ==.

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

Inequality operator !=.

impl Render for ForClause

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

Renders the MSSQL FOR XML/FOR JSON tail with the directives in the canonical MSSQL order (parse accepts them order-independently). Callers write the leading space.

fn operand_binding_power(&self) -> Option<BindingPower>

The binding power this node contributes when it appears as an operand, or None (the default) for a self-delimiting node — an atom, call, or constructor — that never needs parentheses.

impl Serialize for ForClause

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Spanned for ForClause

fn span(&self) -> Span

Return the span for this value.

impl StructuralPartialEq for ForClause