Function is_stub_function_removed

src/stubs.rs:85–110

Quick byte-level check whether a stub function has been `@removed` at or before the given PHP version. This scans the raw PHP source for the function's docblock without a full AST parse, so it is cheap enough to call during completion filtering. Only the docblock immediately preceding `function ` is examined. Returns `true` when the function's docblock contains `@removed X.Y` and `p

(
    source: &str,
    func_name: &str,
    php_version: crate::types::PhpVersion,
)

/// Returns `true` when the function's docblock contains `@removed X.Y`
/// and `php_version >= X.Y`.
pub fn is_stub_function_removed(
    source: &str,
    func_name: &str,
    php_version: crate::types::PhpVersion,
) -> bool {
    // Fast path: if the entire file doesn't contain `@removed`, no
    // function in it can be version-gated.  This skips ~92% of stub
    // files without any allocations or string searches.
    if !source.contains("@removed") {
        return false;
    }

    // Use the short (unqualified) name for the search pattern.
    let short = func_name.rsplit('\\').next().unwrap_or(func_name);

    let needle = format!("function {short}(");
    let Some(func_pos) = source.find(&needle).or_else(|| {
        // Some stubs have a space or newline before `(`.
        let needle2 = format!("function {short} ");
        source.find(&needle2)
    }) else {
        return false;
    };

    is_preceding_docblock_removed(source, func_pos, php_version)
}

/// Quick byte-level check whether a stub class/interface/trait has been
/// `@removed` at or before the given PHP version.