晋太元中,武陵人捕鱼为业。缘溪行,忘路之远近。忽逢桃花林,夹岸数百步,中无杂树,芳草鲜美,落英缤纷。渔人甚异之,复前行,欲穷其林。 林尽水源,便得一山,山有小口,仿佛若有光。便舍船,从口入。初极狭,才通人。复行数十步,豁然开朗。土地平旷,屋舍俨然,有良田、美池、桑竹之属。阡陌交通,鸡犬相闻。其中往来种作,男女衣着,悉如外人。黄发垂髫,并怡然自乐。 见渔人,乃大惊,问所从来。具答之。便要还家,设酒杀鸡作食。村中闻有此人,咸来问讯。自云先世避秦时乱,率妻子邑人来此绝境,不复出焉,遂与外人间隔。问今是何世,乃不知有汉,无论魏晋。此人一一为具言所闻,皆叹惋。余人各复延至其家,皆出酒食。停数日,辞去。此中人语云:“不足为外人道也。”(间隔 一作:隔绝) 既出,得其船,便扶向路,处处志之。及郡下,诣太守,说如此。太守即遣人随其往,寻向所志,遂迷,不复得路。 南阳刘子骥,高尚士也,闻之,欣然规往。未果,寻病终。后遂无问津者。
| DIR:/opt/cloudlinux/alt-php84/root/usr/include/php/ext/swoole/include/ |
| Current File : //opt/cloudlinux/alt-php84/root/usr/include/php/ext/swoole/include/swoole_file.h |
/*
+----------------------------------------------------------------------+
| Swoole |
+----------------------------------------------------------------------+
| This source file is subject to version 2.0 of the Apache license, |
| that is bundled with this package in the file LICENSE, and is |
| available through the world-wide-web at the following url: |
| http://www.apache.org/licenses/LICENSE-2.0.html |
| If you did not receive a copy of the Apache2.0 license and are unable|
| to obtain it through the world-wide-web, please send a note to |
| license@swoole.com so we can mail you a copy immediately. |
+----------------------------------------------------------------------+
| Author: Tianfeng Han <rango@swoole.com> |
+----------------------------------------------------------------------+
*/
#pragma once
#include "swoole_string.h"
#include <sys/file.h>
#include <sys/stat.h>
#include <fcntl.h>
namespace swoole {
ssize_t file_get_size(FILE *fp);
ssize_t file_get_size(int fd);
ssize_t file_get_size(const std::string &filename);
std::shared_ptr<String> file_get_contents(const std::string &filename);
bool file_put_contents(const std::string &filename, const char *content, size_t length);
bool file_exists(const std::string &filename);
typedef struct stat FileStatus;
class File {
int fd_;
int flags_;
std::string path_;
public:
enum Flag {
READ = O_RDONLY,
WRITE = O_WRONLY,
RW = O_RDWR,
CREATE = O_CREAT,
EXCL = O_EXCL,
APPEND = O_APPEND,
};
explicit File(const int fd) {
fd_ = fd;
flags_ = 0;
}
File(int fd, const std::string &path) {
fd_ = fd;
path_ = path;
flags_ = 0;
}
File(const std::string &path, int oflags);
File(const std::string &path, int oflags, int mode);
~File();
bool open(const std::string &path, int oflags, int mode = 0);
bool close();
bool stat(FileStatus *_stat) const;
bool ready() const {
return fd_ != -1;
}
ssize_t write(const void *_buf, size_t _n) const {
return ::write(fd_, _buf, _n);
}
ssize_t write(const std::string &str) const {
return ::write(fd_, str.c_str(), str.length());
}
ssize_t read(void *_buf, const size_t _n) const {
return ::read(fd_, _buf, _n);
}
ssize_t pwrite(const void *_buf, size_t _n, off_t _offset) const {
return ::pwrite(fd_, _buf, _n, _offset);
}
ssize_t pread(void *_buf, const size_t _n, off_t _offset) const {
return ::pread(fd_, _buf, _n, _offset);
}
size_t write_all(const void *data, size_t len) const;
size_t read_all(void *buf, size_t len) const;
/**
* Read one line of file, reading ends when __n - 1 bytes have been read,
* or a newline (which is included in the return value),
* or an EOF (read bytes less than __n)
* Returns length of line on success, -1 otherwise.
* NOTE: `buf` must be ended with zero.
*/
ssize_t read_line(void *_buf, size_t _n) const;
std::shared_ptr<String> read_content() const;
bool sync() const {
return ::fsync(fd_) == 0;
}
bool truncate(off_t length) const {
return ::ftruncate(fd_, length) == 0;
}
off_t set_offset(off_t offset) const {
return lseek(fd_, offset, SEEK_SET);
}
off_t get_offset() const {
return lseek(fd_, 0, SEEK_CUR);
}
bool lock(int operation) const {
return ::flock(fd_, operation) == 0;
}
bool unlock() const {
return ::flock(fd_, LOCK_UN) == 0;
}
ssize_t get_size() const {
return file_get_size(fd_);
}
void release() {
fd_ = -1;
}
int get_fd() const {
return fd_;
}
const std::string &get_path() const {
return path_;
}
static bool exists(const std::string &file) {
return ::access(file.c_str(), R_OK) == 0;
}
static bool remove(const std::string &file) {
return ::remove(file.c_str()) == 0;
}
};
File make_tmpfile();
class AsyncFile {
private:
int fd = -1;
int flags_ = 0;
mode_t mode_ = 0;
std::string path_;
public:
AsyncFile(const std::string &path, int flags, int mode);
~AsyncFile();
bool open(const std::string &path, int flags, mode_t mode);
bool close() const;
ssize_t read(void *buf, size_t count) const;
ssize_t write(const void *buf, size_t count) const;
ssize_t write(const String *buf) const {
return write(SW_STRINGL(buf));
}
bool sync() const;
bool truncate(off_t length) const;
bool stat(FileStatus *statbuf) const;
off_t get_offset() const;
off_t set_offset(off_t offset) const;
bool ready() const {
return fd != -1;
}
};
} // namespace swoole
|