Struct TdsVersion 

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

TDS protocol version.

Represents the version of the TDS protocol used for communication with SQL Server.

Implementations

impl TdsVersion

pub const V7_0: TdsVersion

TDS 7.0 (SQL Server 7.0)

pub const V7_1: TdsVersion

TDS 7.1 (SQL Server 2000)

pub const V7_1_REV1: TdsVersion

TDS 7.1 Revision 1 (SQL Server 2000 SP1)

pub const V7_2: TdsVersion

TDS 7.2 (SQL Server 2005)

pub const V7_3A: TdsVersion

TDS 7.3A (SQL Server 2008)

pub const V7_3B: TdsVersion

TDS 7.3B (SQL Server 2008 R2)

pub const V7_4: TdsVersion

TDS 7.4 (SQL Server 2012+)

pub const V8_0: TdsVersion

TDS 8.0 (SQL Server 2022+ strict encryption mode)

pub const fn new(version: u32) -> TdsVersion

Create a new TDS version from raw bytes.

pub const fn raw(self) -> u32

Get the raw version value.

pub const fn is_tds_8(self) -> bool

Check if this version supports TDS 8.0 strict encryption.

pub const fn requires_prelogin_encryption_negotiation(self) -> bool

Check if this version requires pre-login encryption negotiation.

TDS 7.x versions negotiate encryption during pre-login. TDS 8.0 requires TLS before any TDS traffic.

pub const fn is_tds_7_3(self) -> bool

Check if this version is TDS 7.3 (SQL Server 2008/2008 R2).

Returns true for both TDS 7.3A (SQL Server 2008) and TDS 7.3B (SQL Server 2008 R2).

pub const fn is_tds_7_4(self) -> bool

Check if this version is TDS 7.4 (SQL Server 2012+).

pub const fn supports_date_time_types(self) -> bool

Check if this version supports DATE, TIME, DATETIME2, and DATETIMEOFFSET types.

These types were introduced in TDS 7.3 (SQL Server 2008). Returns true for TDS 7.3+, TDS 7.4, and TDS 8.0.

pub const fn supports_session_recovery(self) -> bool

Check if this version supports session recovery (connection resiliency).

Session recovery was introduced in TDS 7.4 (SQL Server 2012).

pub const fn supports_column_encryption(self) -> bool

Check if this version supports column encryption (Always Encrypted).

Column encryption was introduced in SQL Server 2016 (still TDS 7.4). This checks protocol capability, not SQL Server version.

pub const fn supports_utf8(self) -> bool

Check if this version supports UTF-8 (introduced in SQL Server 2019).

pub const fn is_legacy(self) -> bool

Check if this is a legacy version (TDS 7.2 or earlier).

Legacy versions (SQL Server 2005 and earlier) have different behaviors for some protocol aspects. This driver’s minimum supported version is TDS 7.3 for full functionality.

pub const fn min(self, other: TdsVersion) -> TdsVersion

Get the minimum version between this version and another.

Useful for version negotiation where the client and server agree on the lowest common version.

Note: TDS 8.0 uses a different encoding (0x08000000) which is numerically lower than TDS 7.x versions, but semantically higher. This method handles that special case correctly.

pub const fn sql_server_version_name(&self) -> &'static str

Get the SQL Server version name for this TDS version.

Returns a human-readable string describing the SQL Server version that corresponds to this TDS protocol version.

pub fn parse(s: &str) -> Option<TdsVersion>

Parse a TDS version from a string representation.

Accepts formats like:

• “7.3”, “7.3A”, “7.3a”, “7.3B”, “7.3b” for TDS 7.3
• “7.4” for TDS 7.4
• “8.0”, “8” for TDS 8.0

Returns None if the string cannot be parsed.

pub const fn major(self) -> u8

Get the major version number.

Returns 7 for TDS 7.x versions, 8 for TDS 8.0.

Note: This extracts the major version from the wire format. All TDS 7.x versions return 7, and TDS 8.0 returns 8.

pub const fn minor(self) -> u8

Get the minor version number.

Returns the TDS sub-version: 0, 1, 2, 3, or 4 for TDS 7.x, and 0 for TDS 8.0.

Note: The wire format uses different encoding for different versions. This method extracts the logical minor version (e.g., 3 for TDS 7.3).

pub const fn revision_suffix(self) -> Option<char>

Get the revision suffix for TDS 7.3 versions.

Returns Some(‘A’) for TDS 7.3A (SQL Server 2008), Some(‘B’) for TDS 7.3B (SQL Server 2008 R2), and None for all other versions.

Trait Implementations

impl Clone for TdsVersion

fn clone(&self) -> TdsVersion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TdsVersion

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

Formats the value using the given formatter.

impl Default for TdsVersion

fn default() -> TdsVersion

Returns the “default value” for a type.

impl Display for TdsVersion

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

Formats the value using the given formatter.

impl From<u32> for TdsVersion

fn from(value: u32) -> TdsVersion

Converts to this type from the input type.

impl Hash for TdsVersion

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

where __H: Hasher,

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 Ord for TdsVersion

fn cmp(&self, other: &TdsVersion) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for TdsVersion

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for TdsVersion

fn partial_cmp(&self, other: &TdsVersion) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for TdsVersion

impl Eq for TdsVersion

impl StructuralPartialEq for TdsVersion