v_escape-base 0.1.0

Base runtime for v_escape: SIMD-accelerated string escaping primitives.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

use core::arch::x86_64::__m128i;

use crate::{Escapes, EscapesBuilder, Vector, generic::Generic, writer::Writer};

/// Returns true if SSE2 is available in the current environment.
pub fn is_available() -> bool {
    #[cfg(target_feature = "sse2")]
    {
        true
    }
    #[cfg(not(target_feature = "sse2"))]
    {
        false
    }
}

type SseVector = __m128i;

/// A function that performs escape operations using SSE vectorization.
///
/// # Parameters
/// - `haystack`: The input string to be escaped.
/// - `writer`: The writer function.
///
/// # Returns
/// A result indicating success or failure of the escape operation.
#[inline(always)]
pub fn escape<E: EscapesBuilder, R>(haystack: &str, writer: impl Writer<R>) -> Result<(), R> {
    let len = haystack.len();
    if len < SseVector::BYTES {
        return <E::Escapes<()> as Escapes>::byte_byte_escape(haystack, writer);
    }

    Generic::new(E::new::<SseVector>()).escape(haystack, writer)
}