Base_file-Aet

Bingliaolong 2021-05-27 11:50 Aet | 隐藏边栏 | 抢沙发 | 3 0

文章评分 1 次，平均分 5.0 ：

file

操作类型

class BASE_EXPORT File {

enum Flags {

FLAG_OPEN = 1 << 0, // Opens a file, only if it exists.

FLAG_CREATE = 1 << 1, // Creates a new file, only if it does not

// already exist.

FLAG_OPEN_ALWAYS = 1 << 2, // May create a new file.

FLAG_CREATE_ALWAYS = 1 << 3, // May overwrite an old file.

FLAG_OPEN_TRUNCATED = 1 << 4, // Opens a file and truncates it, only if it

// exists.

FLAG_READ = 1 << 5,

FLAG_WRITE = 1 << 6,

FLAG_APPEND = 1 << 7,

FLAG_EXCLUSIVE_READ = 1 << 8, // EXCLUSIVE is opposite of Windows SHARE.

FLAG_EXCLUSIVE_WRITE = 1 << 9,

FLAG_ASYNC = 1 << 10,

FLAG_TEMPORARY = 1 << 11, // Used on Windows only.

FLAG_HIDDEN = 1 << 12, // Used on Windows only.

FLAG_DELETE_ON_CLOSE = 1 << 13,

FLAG_WRITE_ATTRIBUTES = 1 << 14, // Used on Windows only.

FLAG_SHARE_DELETE = 1 << 15, // Used on Windows only.

FLAG_TERMINAL_DEVICE = 1 << 16, // Serial port flags.

FLAG_BACKUP_SEMANTICS = 1 << 17, // Used on Windows only.

FLAG_EXECUTE = 1 << 18, // Used on Windows only.

FLAG_SEQUENTIAL_SCAN = 1 << 19, // Used on Windows only.

FLAG_CAN_DELETE_ON_CLOSE = 1 << 20, // Requests permission to delete a file

// via DeleteOnClose() (Windows only).

// See DeleteOnClose() for details.

};

enum Whence {

FROM_BEGIN = 0,

FROM_CURRENT = 1,

FROM_END = 2

};

Info

struct BASE_EXPORT Info {

Info();

~Info();

#if defined(OS_POSIX) || defined(OS_FUCHSIA)

// Fills this struct with values from |stat_info|.

void FromStat(const stat_wrapper_t& stat_info);

#endif

// 文件字节大小

int64_t size;

// 如果文件对应于目录，则为true

bool is_dictionary;

// 文件的上次修改时间

Time last_modified;

// 文件最后一次访问时间

Time last_accessed;

// 文件的创建时间

Time creation_time;

};

构造

File();

File(const FilePath& path, uint32_t flags);

explicit File(PlatformFile platform_file);

File(PlatformFile platform_file, bool async);

explicit File(Error error_details);

File(File&& other);

函数

创建或打开给定的文件

1	void Initialize(const FilePath& path, uint32_t flags);

返回| true | 如果此对象包装的handle / fd有效。这
方法不与文件系统交互（可以安全地从中调用
ThreadRestrictions :: SetIOAllowed（false）线程）。

1	bool IsValid() const;

如果创建了新文件（或旧文件被截断为零），则返回true
模拟新文件的长度，可能会发生以下情况：
FLAG_CREATE_ALWAYS），否则为false。

1	bool created() const { return created_; }

销毁该对象会自动关闭文件。

1	void Close();

将文件中的当前位置更改为相对于由| whence |定义的原点的| offset | 。
返回结果在文件中的当前位置（相对于开始）或-1（如果出现错误）。

1	int64_t Seek(Whence whence, int64_t offset);

读写相关

bool ReadAndCheck(int64_t offset, span<uint8_t> data);

bool ReadAtCurrentPosAndCheck(span<uint8_t> data);

bool WriteAndCheck(int64_t offset, span<const uint8_t> data);

bool WriteAtCurrentPosAndCheck(span<const uint8_t> data);

// 从指定的位置开始读取给定数字的字节数（或直到达到EOF为止）。

// 返回读取的字节数，如果错误则返回-1。注意

// 此功能将尽最大努力读取所有平台上的所有数据，因此它

// 不适用于面向流的文件，而适用于以下情况：

// 正常的期望是实际上| size | 除非有字节，否则读取字节

// 一个错误。

int Read(int64_t offset, char* data, int size);

// 和上面一个功能一样，但是不具备查找

int ReadAtCurrentPos(char* data, int size);

// 从指定的字节数开始读取给定的字节数（或直到达到EOF为止）。

// 给定偏移量，但不做任何努力来读取所有数据

// 平台。返回读取的字节数，如果错误则返回-1。

int ReadNoBestEffort(int64_t offset, char* data, int size);

//和上面一个功能一样，但是不具备查找

int ReadAtCurrentPosNoBestEffort(char* data, int size);

int Write(int64_t offset, const char* data, int size);

int WriteAtCurrentPos(const char* data, int size);

int WriteAtCurrentPosNoBestEffort(const char* data, int size);

文件长度

1 2	int64_t GetLength(); bool SetLength(int64_t length);

// 指示文件系统将文件刷新到磁盘上

bool Flush();

// 修改上次访问时间

bool SetTimes(Time last_access_time, Time last_modified_time);

// 返回给定文件的一些基础信息

bool GetInfo(Info* info);

文件锁

// 尝试对文件进行排他写入锁定。立即返回

// （即不等待其他进程解锁文件）。如果锁

// 已获得，结果将为FILE_OK。锁只保证

// 其他进程也可能不会使用

// 相同的API-仍然可以打开，重命名，取消链接等。

Error Lock(LockMode mode = LockMode::kExclusive);

// 解锁

Error Unlock();

file_enumerator

用于枚举提供的路径中的文件的类。结果顺序不能保证。

构造

FileEnumerator(const FilePath& root_path,

bool recursive,

int file_type);

FileEnumerator(const FilePath& root_path,

bool recursive,

int file_type,

const FilePath::StringType& pattern);

FileEnumerator(const FilePath& root_path,

bool recursive,

int file_type,

const FilePath::StringType& pattern,

FolderSearchPolicy folder_search_policy);

函数

// 返回下一个文件或如果没有更多结果的话返回字符串

FilePath Next();

// 把文件信息写道info里面

FileInfo GetInfo() const;

file_path

构造

FilePath();

FilePath(const FilePath& that);

explicit FilePath(StringPieceType path);

FilePath(FilePath&& that) noexcept;

函数

基本

const StringType& value() const { return path_; }

bool empty() const { return path_.empty(); }

void clear() { path_.clear(); }

返回路径的所有组件的容器

// eg.

// Posix: "/foo/bar" -> [ "/", "foo", "bar" ]

// Windows: "C:\foo\bar" -> [ "C:", "\\", "foo", "bar" ]

void GetComponents(std::vector<FilePath::StringType>* components) const;

判断父级

1	bool IsParent(const FilePath& child) const;

路径

// 返回与包含路径的目录相对应的FilePath

// 由该对象命名，剥离文件组件。如果这个对象

// 只包含一个组件，返回一个FilePath标识

// kCurrentDirectory。如果此对象已经引用根目录，

// 返回标识根目录的FilePath。请注意，

// 无法解析目录导航，例如 “ ../a”的结果为“ ..”。

FilePath DirName() const WARN_UNUSED_RESULT;

FilePath BaseName() const WARN_UNUSED_RESULT;

StringType Extension() const WARN_UNUSED_RESULT;

StringType FinalExtension() const WARN_UNUSED_RESULT;

FilePath RemoveExtension() const WARN_UNUSED_RESULT;

FilePath RemoveFinalExtension() const WARN_UNUSED_RESULT;

FilePath InsertBeforeExtension(

StringPieceType suffix) const WARN_UNUSED_RESULT;

FilePath InsertBeforeExtensionASCII(

StringPiece suffix) const WARN_UNUSED_RESULT;

FilePath AddExtension(StringPieceType extension) const WARN_UNUSED_RESULT;

FilePath AddExtensionASCII(StringPiece extension) const WARN_UNUSED_RESULT;

FilePath ReplaceExtension(StringPieceType extension) const WARN_UNUSED_RESULT;

bool MatchesExtension(StringPieceType extension) const;

FilePath Append(StringPieceType component) const WARN_UNUSED_RESULT;

FilePath Append(const FilePath& component) const WARN_UNUSED_RESULT;

FilePath AppendASCII(StringPiece component) const WARN_UNUSED_RESULT;

bool IsAbsolute() const;

bool EndsWithSeparator() const WARN_UNUSED_RESULT;

FilePath AsEndingWithSeparator() const WARN_UNUSED_RESULT;

FilePath StripTrailingSeparators() const WARN_UNUSED_RESULT;

bool ReferencesParent() const;

string16 LossyDisplayName() const;

std::string MaybeAsASCII() const;

std::string AsUTF8Unsafe() const;

string16 AsUTF16Unsafe() const;

static FilePath FromUTF8Unsafe(StringPiece utf8);

static FilePath FromUTF16Unsafe(StringPiece16 utf16);

void WriteToPickle(Pickle* pickle) const;

bool ReadFromPickle(PickleIterator* iter);

FilePath NormalizePathSeparators() const;

FilePath NormalizePathSeparatorsTo(CharType separator) const;

static int CompareIgnoreCase(StringPieceType string1,

StringPieceType string2);

static bool CompareEqualIgnoreCase(StringPieceType string1,

StringPieceType string2) {

return CompareIgnoreCase(string1, string2) == 0;

}

static bool CompareLessIgnoreCase(StringPieceType string1,

StringPieceType string2) {

return CompareIgnoreCase(string1, string2) < 0;

}

file_util

函数

返回相对路径的绝对版本

1	BASE_EXPORT FilePath MakeAbsoluteFilePath(const FilePath& input);

返回| root_path |下所有文件使用的字节总数。
如果该路径不存在，则该函数返回0。

1	BASE_EXPORT int64_t ComputeDirectorySize(const FilePath& root_path);

删除文件

BASE_EXPORT bool DeleteFile(const FilePath& path, bool recursive);

BASE_EXPORT bool DeleteFileRecursively(const FilePath& path);

#if defined(OS_WIN)

// Schedules to delete the given path, whether it's a file or a directory, until

// the operating system is restarted.

// Note:

// 1) The file/directory to be deleted should exist in a temp folder.

// 2) The directory to be deleted must be empty.

BASE_EXPORT bool DeleteFileAfterReboot(const FilePath& path);

#endif

移文件

1	BASE_EXPORT bool Move(const FilePath& from_path, const FilePath& to_path);

重命名文件| from_path | 到| to_path |。两条路径必须在同一条上，否则功能将失败。
目标文件如果不存在将被创建。处理时，此功能优先于移动临时文件。
在Windows上，它保留目标文件的属性。成功返回true，使 error保持不变。
如果失败，则返回false，并适当地设置 error（如果非NULL）。

BASE_EXPORT bool ReplaceFile(const FilePath& from_path,

const FilePath& to_path,

File::Error* error);

拷贝文件

1	BASE_EXPORT bool CopyFile(const FilePath& from_path, const FilePath& to_path);

BASE_EXPORT bool CopyDirectory(const FilePath& from_path,

const FilePath& to_path,

bool recursive);

BASE_EXPORT bool CopyDirectory(const FilePath& from_path,

const FilePath& to_path,

bool recursive);

BASE_EXPORT bool CopyDirectoryExcl(const FilePath& from_path,

const FilePath& to_path,

bool recursive);

验证路径文件是否存在

1	BASE_EXPORT bool PathExists(const FilePath& path);

验证路径是否是用户可写的

1	BASE_EXPORT bool PathIsWritable(const FilePath& path);

1	BASE_EXPORT bool DirectoryExists(const FilePath& path);

验证两个文件内容是否相同

1 2	BASE_EXPORT bool ContentsEqual(const FilePath& filename1, const FilePath& filename2);

验证文本文件内容：如果给定的两个文本文件的内容相等，则返回true，否则返回false
除此以外。此例程将“ \ r \ n”和“ \ n”视为等效。

1 2	BASE_EXPORT bool TextContentsEqual(const FilePath& filename1, const FilePath& filename2);

把文件读到string里面

BASE_EXPORT bool ReadFileToString(const FilePath& path, std::string* contents);

BASE_EXPORT bool ReadFileToStringWithMaxSize(const FilePath& path,

std::string* contents,

size_t max_size);

1	BASE_EXPORT bool IsDirectoryEmpty(const FilePath& dir_path);

1	BASE_EXPORT bool GetTempDir(FilePath* path);

1	BASE_EXPORT FilePath GetHomeDir();

创建临时文件

BASE_EXPORT bool CreateTemporaryFile(FilePath* path);

// Same as CreateTemporaryFile but the file is created in |dir|.

BASE_EXPORT bool CreateTemporaryFileInDir(const FilePath& dir,

FilePath* temp_file);

BASE_EXPORT FILE* CreateAndOpenTemporaryFile(FilePath* path);

// Similar to CreateAndOpenTemporaryFile, but the file is created in |dir|.

BASE_EXPORT FILE* CreateAndOpenTemporaryFileInDir(const FilePath& dir,

FilePath* path);

BASE_EXPORT bool CreateNewTempDirectory(const FilePath::StringType& prefix,

FilePath* new_temp_path);

BASE_EXPORT bool CreateTemporaryDirInDir(const FilePath& base_dir,

const FilePath::StringType& prefix,

FilePath* new_dir);

BASE_EXPORT bool CreateDirectoryAndGetError(const FilePath& full_path,

File::Error* error);

// Backward-compatible convenience method for the above.

BASE_EXPORT bool CreateDirectory(const FilePath& full_path);

获取文件大小

1	BASE_EXPORT bool GetFileSize(const FilePath& file_path, int64_t* file_size);

判断是否为符号链接

1	BASE_EXPORT bool IsLink(const FilePath& file_path);

获取给定路径文件的文件信息

1	BASE_EXPORT bool GetFileInfo(const FilePath& file_path, File::Info* info);

设置上次访问的时间和上次修改的时间

BASE_EXPORT bool TouchFile(const FilePath& path,

const Time& last_accessed,

const Time& last_modified);

包装类似fopen的调用。成功返回非NULL FILE *

1	BASE_EXPORT FILE* OpenFile(const FilePath& filename, const char* mode);

file操作

// Closes file opened by OpenFile. Returns true on success.

BASE_EXPORT bool CloseFile(FILE* file);

// Associates a standard FILE stream with an existing File. Note that this

// functions take ownership of the existing File.

BASE_EXPORT FILE* FileToFILE(File file, const char* mode);

// Truncates an open file to end at the location of the current file pointer.

// This is a cross-platform analog to Windows' SetEndOfFile() function.

BASE_EXPORT bool TruncateFile(FILE* file);

// Reads at most the given number of bytes from the file into the buffer.

// Returns the number of read bytes, or -1 on error.

BASE_EXPORT int ReadFile(const FilePath& filename, char* data, int max_size);

// Writes the given buffer into the file, overwriting any data that was

// previously there. Returns the number of bytes written, or -1 on error.

BASE_EXPORT int WriteFile(const FilePath& filename, const char* data,

int size);

BASE_EXPORT bool AppendToFile(const FilePath& filename,

const char* data,

int size);

// Gets the current working directory for the process.

BASE_EXPORT bool GetCurrentDirectory(FilePath* path);

// Sets the current working directory for the process.

BASE_EXPORT bool SetCurrentDirectory(const FilePath& path);

file
操作类型
Info
构造
函数
file_enumerator
构造
函数
file_path
构造
函数
file_util
函数

本文为原创文章，版权归Aet所有，欢迎分享本文，转载请保留出处！

Bingliaolong 关注：0 粉丝：0 最后编辑于：2021-11-20

Everything will be better.

一	二	三	四	五	六	日
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

file

操作类型

Info

构造

函数

file_enumerator

构造

函数

file_path

构造

函数

file_util

函数

你可能也喜欢

热评文章

发表评论

标签云集