目录

结构体

struct FileDescriptor

public struct FileDescriptor

功能:用于获取文件句柄信息。

文件句柄(File Handle)是操作系统为了跟踪文件而分配的一种数据结构,用于标识一个打开文件的实例。文件句柄包含了文件的元数据信息(如文件名、路径、大小、修改时间等)以及文件数据在磁盘上的物理位置等信息。

在不同的操作系统中,文件句柄的形式可能会有所不同。在 Unix 和 Linux 系统中,文件句柄通常是一个非负整数,由操作系统内核分配,并在打开文件时返回给应用程序。在 Windows 系统中,文件句柄通常是一个指向文件对象的指针,由操作系统内核分配,并在打开文件时返回给应用程序。无论文件句柄的形式是什么,应用程序都可以使用它来执行文件的读取、写入、修改等操作。

[h2]prop fileHandle

public prop fileHandle: CPointer<Unit>

功能:Windows 下获取文件句柄信息。

类型:CPointer<Unit>

[h2]prop fileHandle

public prop fileHandle: Int32

功能:Linux 下获取文件句柄信息。

类型:Int32

struct FileInfo

public struct FileInfo <: Equatable<FileInfo> {
    public init(path: Path)
    public init(path: String)
}

功能:对应文件系统中的文件元数据。

文件元数据是指文件系统中与文件相关的信息,包括文件名、文件大小、创建时间、修改时间、访问时间、文件权限、文件所有者等。

FileInfo 的底层实现是没有直接缓存文件属性的,每次通过 FileInfo 的 API 都是现场获取的最新的文件属性。

因此这里有需要注意的情况,对于创建的同一 FileInfo 实例,如果在两次获取其文件属性操作期间,对应的文件实体可能会被其他用户或进程做了修改或者替换等不期望的操作,就会导致后一次获取的可能不是期望的文件属性。

如果有特殊文件操作需求需要避免上述情况的产生,可以采用设置文件权限或者给关键文件操作加锁的方式来保证。

[h2]prop creationTime

public prop creationTime: DateTime

功能:获取创建时间。

类型:DateTime

异常:

[h2]prop lastAccessTime

public prop lastAccessTime: DateTime

功能:获取最后访问时间。

类型:DateTime

异常:

[h2]prop lastModificationTime

public prop lastModificationTime: DateTime

功能:获取最后修改时间。

类型:DateTime

异常:

[h2]prop length

public prop length: Int64

功能:返回当前文件大小。

类型:Int64

异常:

[h2]prop parentDirectory

public prop parentDirectory: Option<FileInfo>

功能:获得父级目录元数据,以 Option<FileInfo> 形式返回,有父级返回 Option<FileInfo>.Some(v);否则返回 Option<FileInfo>.None。

类型:Option<FileInfo>

[h2]prop path

public prop path: Path

功能:获得当前文件路径,以 Path 形式返回。

类型:Path

[h2]prop symbolicLinkTarget

public prop symbolicLinkTarget: Option<Path>

功能:获得链接目标路径,以 Option<Path> 形式返回,当前是符号链接返回 Option<Path>.Some(v);否则返回 Option<Path>.None。

类型:Option<Path>

[h2]init(Path)

public init(path: Path)

功能:创建 FileInfo 实例。

参数:

异常:

[h2]init(String)

public init(path: String)

功能:创建 FileInfo 实例。

参数:

异常:

[h2]func canExecute()

public func canExecute(): Bool

功能:判断当前用户是否有权限执行该实例对应的文件。

返回值:

异常:

[h2]func canRead()

public func canRead(): Bool

功能:判断当前用户是否有权限读取该实例对应的文件。

返回值:

异常:

[h2]func canWrite()

public func canWrite(): Bool

功能:判断当前用户是否有权限写入该实例对应的文件。

返回值:

异常:

[h2]func isDirectory()

public func isDirectory(): Bool

功能:判断当前文件是否是目录。

返回值:

异常:

[h2]func isFile()

public func isFile(): Bool

功能:判断当前文件是否是普通文件。

返回值:

异常:

[h2]func isHidden()

public func isHidden(): Bool

功能:判断当前文件是否隐藏。

返回值:

[h2]func isReadOnly()

public func isReadOnly(): Bool

功能:判断当前文件是否只读。

返回值:

异常:

[h2]func setExecutable(Bool)

public func setExecutable(executable: Bool): Bool

功能:对当前实例对应的文件设置当前用户是否可执行的权限,当前用户没有权限修改抛异常。

参数:

返回值:

[h2]func setReadable(Bool)

public func setReadable(readable: Bool): Bool

功能:对当前实例对应的文件设置当前用户是否可读取的权限,当前用户没有权限修改抛异常。

参数:

返回值:

[h2]func setWritable(Bool)

public func setWritable(writable: Bool): Bool

功能:对当前实例对应的文件设置当前用户是否可写入的权限,当前用户没有权限修改抛异常。

参数:

返回值:

[h2]operator func !=(FileInfo)

public operator func !=(that: FileInfo): Bool

功能:判断当前 FileInfo 和另一个 FileInfo 是否对应非同一文件。

参数:

返回值:

[h2]operator func ==(FileInfo)

public operator func ==(that: FileInfo): Bool

功能:判断当前 FileInfo 和另一个 FileInfo 是否对应同一文件。

参数:

返回值:

struct Path

public struct Path <: Equatable<Path> & Hashable & ToString {
    public init(rawPath: String)
}

功能:提供路径相关的函数。

Path 用来表示本地路径(Windows 平台已支持 DOS 设备路径和 UNC 路径,长度限制跟随系统)。 路径的字符串最大支持 4096 个字节(包括结束符 \0)。

非法路径指的是以下情况之一:

  • 路径中包含非法字符,例如空格、制表符、换行符等;
  • 路径中包含不合法的字符,例如特殊字符、控制字符等;
  • 路径中包含不存在的目录或文件;
  • 路径中包含无法访问的目录或文件,例如权限不足或被锁定等。

在输入路径时,应该避免使用非法字符,确保路径的合法性,以便正确地访问目标文件或目录。

[h2]prop directoryName

public prop directoryName: Option<Path>

功能:获得 Path 的目录部分,以 Option<Path> 形式返回。

返回值:返回构造时传入的路径中的目录部分,构造时传入的路径中无目录部分时返回 None。

类型:Option<Path>

异常:

[h2]prop extensionName

public prop extensionName: Option<String>

功能:获得 Path 的文件扩展名部分,以 Option<String> 形式返回。

返回值:返回构造时传入的路径中的文件扩展名部分,构造时传入的路径中无文件扩展名部分时返回 None。

类型:Option<String>

异常:

[h2]prop fileName

public prop fileName: Option<String>

功能:获得 Path 的文件名(含扩展名)部分,以 Option<String> 形式返回。

返回值:返回构造时传入的路径中的文件名(含扩展名)部分,构造时传入的路径中无文件名(含扩展名)部分时返回 None。

类型:Option<String>

异常:

[h2]prop fileNameWithoutExtension

public prop fileNameWithoutExtension: Option<String>

功能:获得 Path 的文件名(不含扩展名)部分,以 Option<String> 形式返回。

返回值:返回构造时传入的路径中的文件名(不含扩展名)部分,构造时传入的路径中无文件名(不含扩展名)部分时返回 None。

类型:Option<String>

异常:

[h2]init(String)

public init(rawPath: String)

功能:创建 Path 实例时不检查路径字符串是否合法,支持绝对路径和相对路径。

参数:

[h2]func hashCode()

public func hashCode(): Int64

功能:获得 Path 的哈希值。

返回值:

[h2]func isAbsolute()

public func isAbsolute(): Bool

功能:判断 Path 是否是绝对路径。在 Unix 中,以 / 开头的路径为绝对路径。

返回值:

异常:

[h2]func isDirectory()

public func isDirectory(): Bool

功能:判断 Path 是否是目录,与 isFile, isSymbolicLink 互斥。

返回值:

异常:

[h2]func isFile()

public func isFile(): Bool

功能:判断 Path 是否是文件,与 isSymbolicLink, isDirectory 互斥。

返回值:

异常:

[h2]func isRelative()

public func isRelative(): Bool

功能:判断 Path 是否是相对路径, 其结果与函数 isAbsolute 结果相反。

返回值:

异常:

[h2]func join(Path)

public func join(path: Path): Path

功能:在当前路径后拼接另一个路径字符串形成新路径。

返回值:

异常:

[h2]func join(String)

public func join(path: String): Path

功能:在当前路径后拼接另一个路径字符串形成新路径。

返回值:

异常:

[h2]func split()

public func split(): (Option<Path>, Option<String>)

功能:将 Path 分割成目录和文件名两部分以元组形式返回分割结果 (directoryName, fileName) 。

返回值:

异常:

[h2]func toCanonical()

public func toCanonical(): Path

功能:将 Path 规范化返回绝对路径形式的规范化路径。

所有的中间引用和软链接都会处理 (UNC 路径下的软链接无法被规范化),例如,对于路径 "/foo/test/../test/bar.txt",该函数会返回 "/foo/test/bar.txt"。

返回值:

异常:

[h2]func toString()

public func toString(): String

功能:获得 Path 的路径字符串。

返回值:

[h2]operator func !=(Path)

public operator func !=(that: Path): Bool

功能:判断 Path 是否不是同一路径。

参数:

返回值:

[h2]operator func ==(Path)

public operator func ==(that: Path): Bool

功能:判断 Path 是否是同一路径。

参数:

返回值: