学习笔记第二十二天

1. time 函数

time_t time(time_t *t);

功能：获取当前时间（自1970年1月1日00:00:00 UTC以来的秒数）。

参数：t 是一个指向 time_t 类型的指针，用于存放返回的时间值。如果传递 NULL，函数将不

        会使用此参数，但仍会返回当前时间。

返回值：成功时返回当前时间（自1970年以来的秒数），失败时返回 (time_t)-1。注意，在

        大多数现代系统上，time 函数几乎不会失败，除非发生了一些极端情况（如系统时间被设置

为未来的某个点，而系统无法处理这种情况）。

 

2. localtime 函数

struct tm *localtime(const time_t *timep);

功能：将 time_t 类型的时间（秒数）转换为本地时间的 struct tm 结构体表示。

参数：timep 指向包含秒数的 time_t 类型的指针。

返回值：返回一个指向填充好的 struct tm 结构体的指针。如果发生错误（虽然非常罕见），则返

回 NULL。

struct tm 结构体

 struct tm 
 {
int tm_sec;         /* seconds */
int tm_min;         /* minutes */
int tm_hour;        /* hours */
int tm_mday;        /* day of the month */
int tm_mon;         /* month */
int tm_year;        /* year */
int tm_wday;        /* day of the week */
int tm_yday;        /* day in the year */
int tm_isdst;       /* daylight saving time */
};

注意：返回的指针通常指向一个静态分配的内存区域，这意味着连续调用 localtime 可能会覆盖之

        前的结果。

3. ctime 函数

char *ctime(const time_t *timep);

功能：将 time_t 类型的时间（秒数）转换为一个可读的字符串形式。

参数：timep 指向包含秒数的 time_t 类型的指针。

返回值：返回一个指向静态分配的可读时间字符串的指针。连续调用可能会覆盖之前的字符串。如

        果发生错误（理论上不太可能），返回 NULL。

4.getpwuid函数

struct passwd *getpwuid(uid_t uid);

功能：根据用户ID（UID）获取用户信息。

参数：uid_t uid：要查询的用户ID（UID）。

返回值：成功时，返回一个指向passwd结构体的指针，该结构体包含了对应的用户信息。

              失败时，返回NULL。

5.getpwnam函数

功能：根据用户名获取用户信息。

函数构造：struct passwd *getpwnam(const char *name);

参数：const char *name：要查询的用户名。

返回值：成功时，返回一个指向passwd结构体的指针，该结构体包含了对应的用户信息。

              失败时返回NULL。

6.getgrgid函数

struct group *getgrgid(gid_t gid);

功能：根据组ID（GID）获取组信息。

参数：gid_t gid：要查询的组ID（GID）。

返回值：成功时，返回一个指向group结构体的指针，该结构体包含了对应的组信息。失败时，返

        回NULL。

7.getgrnam函数

struct group *getgrnam(const char *name);

功能：根据组名获取组信息。

参数：const char *name：要查询的组名。

返回值：成功时，返回一个指向group结构体的指针，该结构体包含了对应的组信息。失败时，返

        回NULL。

8.symlink函数

int symlink(const char *oldpath, const char *newpath);

功能：创建一个指向oldpath的符号链接newpath。

参数：const char *oldpath：原始文件的路径。const char *newpath：新创建的符号链接的路

        径。

返回值：成功时，返回0。失败时，返回-1，并设置errno以指示错误。

9.remov函数

int remove(const char *pathname);

功能：删除一个文件。

参数：const char *pathname：要删除的文件或目录的路径（注意：某些系统可能不允许使用

        remove删除目录）。

返回值：成功时，返回0。失败时，返回-1，并设置errno以指示错误。

10.rename函数

int rename(const char *oldpath, const char *newpath);

功能：重命名文件或目录，即将oldpath指向的文件或目录重命名为newpath。

参数：const char *oldpath：原始文件或目录的路径。const char *newpath：新名称的路径。

返回值：成功时，返回0。失败时，返回-1，并设置errno以指示错误。

11.link函数

int link(const char *oldpath, const char *newpath);

功能：为oldpath指定的文件创建一个新的硬链接newpath。

参数：const char *oldpath：原始文件的路径。const char *newpath：新硬链接的路径。

返回值：成功时，返回0。失败时，返回-1，并设置errno以指示错误。

12.truncate 函数

int truncate(const char *path, off_t length)

功能：将指定文件的大小截断到指定的长度。如果文件当前的大小大于指定长度，则文件内容会被

        截断；如果小于指定长度，则文件大小保持不变（。

参数：path：指向要截断的文件的路径的字符串。length：指定文件截断后的长度。

返回值：成功时返回 0。失败时返回 -1，并设置 errno 以指示错误类型。

13.perror 函数

void perror(const char *s);

功能：打印出由 errno 指示的最后一次系统或库函数调用遇到的错误的描述性消息。

参数：s：一个指向字符串的指针，该字符串会在错误消息前打印出来，通常用来提供上下文信

        息。

返回值：无返回值（void）。

14.strerror 函数

const char *strerror(int errnum);

功能：将错误码（errno 值）转换为可读的错误信息字符串。

参数：errnum：错误码，通常是 errno 的值。

返回值：返回一个指向静态分配的错误信息字符串的指针。注意，这个字符串是静态的，因此每次

        调用 strerror 时都可能会覆盖上一次调用的结果。

15.error 宏（非标准）

void error(int status, int errnum, const char *fmt, ...);

功能：打印错误信息和退出程序。这是一个非标准的宏，通常在某些特定的库（如 GNU C Library

        的 libgen.h 或其他第三方库）中提供。

参数：status：程序的退出状态码。errnum：错误码，通常是 errno 的值。fmt：一个格式字符

        串，用于构造错误信息。...：可变数量的参数，用于与 fmt 中的格式说明符匹配。

返回值：无返回值（void），但会导致程序退出。