Struct AsyncLineCache 

pub struct AsyncLineCache {
    pub lines: Cache<String, Arc<Vec<String>>>,
    pub contents: Cache<String, String>,
    /* private fields */
}

工业级异步行缓存核心结构体 Industrial-grade asynchronous line cache core structure

Fields

lines: Cache<String, Arc<Vec<String>>>

按文件路径缓存解析后的行向量（Arc<Vec>） Cache of parsed lines per file path (Arc<Vec>)

contents: Cache<String, String>

按文件路径缓存完整文件内容（用于兼容旧版 API） Cache of full file content (for legacy API compatibility)

Implementations

impl AsyncLineCache

pub fn new() -> Self

创建一个推荐用于生产环境的实例 Create a new instance with production-recommended configuration

• 总缓存大小限制为系统内存的 85%
• 行缓存与内容缓存各占一半
• 使用精确的内存权重计算，防止 OOM
• Total cache size limited to 85% of system memory
• Lines cache and contents cache each take half
• Precise memory weighting to prevent OOM

pub async fn get_line( &self, filename: &str, lineno: usize, ) -> Result<Option<String>>

获取指定文件的第 lineno 行（从 1 开始计数） Get the lineno-th line of the file (1-based indexing)

返回值：

• Ok(Some(line))：成功获取行
• Ok(None)：行号超出范围或空文件
• Err(io_error)：IO 错误 Return value:
• Ok(Some(line)): line retrieved successfully
• Ok(None): line number out of range or empty file
• Err(io_error): I/O error

pub async fn random_line(&self, filename: &str) -> Result<Option<String>>

随机返回文件中任意一行（零分配，极快） Randomly return any line from the file (zero allocation, extremely fast)

pub async fn random_sign_char(&self, filename: &str) -> Result<Option<char>>

随机返回文件中任意一个 Unicode 字符（正确按码点切分） Randomly return any Unicode character from the file (proper grapheme-aware)

pub async fn random_sign(&self, filename: &str) -> Result<Option<String>>

同 random_sign_char，但返回 String 类型 Same as random_sign_char, but returns String

pub async fn get_lines(&self, filename: &str) -> Result<Option<Vec<String>>>

获取文件全部行（完全兼容旧版 DashMap 实现） Get all lines of the file (fully compatible with legacy DashMap implementation)

• 空文件返回 None（与 Python linecache 行为一致）
• Empty file returns None (same as Python linecache)

pub async fn get_content(&self, filename: &str) -> Result<Option<String>>

获取文件完整内容（兼容旧版 API） Get full file content (compatible with legacy API)

• 文件不存在返回 None
• File not found returns None

pub async fn invalidate(&self, filename: &str)

手动使指定文件的所有缓存失效 Manually invalidate all caches for a specific file

pub async fn clear(&self)

清空全部缓存（三个缓存全部清除） Clear all caches completely

pub async fn clear_cache(&self)

👎Deprecated since 0.2.0: 请使用 clear() 替代 | use clear() instead

兼容旧版方法名（已废弃，仅为平滑升级保留） Legacy method name (deprecated, kept for smooth migration)

Trait Implementations

impl Clone for AsyncLineCache

fn clone(&self) -> AsyncLineCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AsyncLineCache

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

Formats the value using the given formatter.

impl Default for AsyncLineCache

为方便使用提供 Default 实现 Provide Default implementation for convenience

fn default() -> Self

Returns the “default value” for a type.