C语言文件权限/数学函数总结

文件权限函数整体概述

• access()：判断是否具有存取文件的权限
• alphasort()：依字母顺序排序目录结构
• chdir()：改变当前的工作目录
• chmod()：修改文件权限
• chown()：改变文件所有者
• chroot()：改变文件根目录
• closedir()：关闭目录
• fchdir()：改变当前工作目录
• fchmod()：修改文件的权限
• fchown()：改变文件的所有者
• fstat()：由文件描述词取得文件状态
• ftruncate()：改变文件大小
• getcwd()：取得当前的工作目录
• link()：建立文件连接
• lstat()：由文件描述词取得文件状态
• opendir()：打开目录函数
• readdir()：读取目录函数
• readlink()：取得符号连接所指的文件
• rewinddir()：重设读取目录的位置为开头位置
• seekdir()：设置读下回读取目录的位置
• stat()：获取文件状态
• symlink()：建立文件符号连接
• telldir()：取得目录流的读取位置
• truncate()：改变文件大小
• umask()：设置建立新文件时的权限遮罩
• unlink()：删除文件
• utime()：修改文件的存取时间和更改时间
• utimes()：修改文件的存取时间和更改时间

文件权限函数详细介绍

• access()函数

  int access(const char *pathname, int mode);

  函数说明：access()会检查是否可以读/写某一已存在的文件。

  参数mode有以下几种组合情况：
  1）R_OK，W_OK，X_OK和F_OK。R_OK，W_OK与X_OK用来检查文件是否具有读取写入和执行的权限。
  2）F_OK用来判断该文件是否存在。由于access()只作权限的核查，并不理会文件形态或文件内容，因此，如果一目录表示为“可写入”，表示可以在该目录中建立新文件等操作，而非意味此目录可以被当做文件处理。如可能会出现DOS的文件都具有“可执行”权限，但execve()执行时则会失败。

  返回值：若所有欲核查的权限都通过了检查则返回0，表示成功，只要有一个权限被禁止，则返回-1。

  错误代码如下：
  1）EACCESS 参数pathname所指定的文件不符合所要求测试的权限。
  2）EROFS 欲测试写入权限的文件存在于只读文件系统内。
  3）EFAULT 参数pathname指针超出可存取内存空间。
  4）EINVAL 参数mode不正确。
  5）ENAMETOOLONG 参数pathname太长。
  6）ENOTDIR 参数pathname为一目录。
  7）ENOMEM 核心内存不足。
  8）ELOOP 参数pathname有过多符合连接问题。
  9）EIO IO 存取错误。

  注意：使用access()作用户认证方面的判断要特别小心，如在access()后再做open()的空文件可能会造成系统安全上的问题。

• alphasort()函数

  int alphasort(const struct dirent **a, const struct dirent **b);

  函数说明：alphasort()为scandir()最后调用qsort()作为判断的函数。

• chdir()函数

  int chdir(const char *path);

  函数说明：chdir()用来将当前的工作目录改变成以参数path所指的目录。

  返回值：执行成功则返回0，失败则返回-1，errno为错误代码。

• chmod()函数

  int chmod(const char *path, mode_t mode);

  函数说明：chmod()会依参数mode权限来更改参数path指定文件的权限。

  参数mode的组合如下：
  1）S_ISUID 04000 文件的（set user-id on execution）位
  2）S_ISGID 02000 文件的（set group-id on execution）位
  3）S_ISVTX 01000 文件的sticky位
  4）S_IRUSR（S_IREAD） 00400 文件所有者具有可读取权限
  5）S_IWUSR（S_IWRITE） 00200 文件所有这具有可写入权限
  6）S_IXUSR（S_IEXEC） 00100 文件所有者具有可执行权限
  7）S_IRGRP 00040 用户组具有可读取权限
  8）S_IWGRP 00020 用户组具有可写入权限
  9）S_IXGRP 00010 用户组具有可执行权限
  10）S_IROTH 00004 其他用户具有可读取权限
  11）S_IWOTH 00002 其他用户具有可写入权限
  12）S_IXOTH 00001 其他用户具有可执行权限

  注意：只有该文件的所有者或有效用户识别码为0，才可以执行修改文件权限。基于系统安全，如果欲将数据写入一执行文件，而执行行文件具有S_ISUID或S_ISGID权限，则这两个位会被清除。如果一目录具有S_ISUID位权限，表示在此目录下只有该文件的所有者或root可删除该文件。

  返回值：权限改变成功赶回0，失败返回-1，错误原因存于errno。

  错误代码：
  1）EACCESS 参数path所指定的文件无法存取。
  2）EROFS 欲测试写入权限的文件存在于只读文件系统内。
  3）EFAULT 参数pathname指针超出可存取内存空间。
  4）EINVAL 参数mode不正确。
  5）ENAMETOOLONG 参数pathname太长。
  6）ENOTDIR 参数pathname为一目录。
  7）ENOMEM 核心内存不足。
  8）ELOOP 参数pathname有过多符合连接问题。
  9）EIO IO 存取错误。
  10）ENOENT 指定的文件不存在
  11）EPERM 进程的有效用户识别码与欲修改权限的文件拥有者不同，而且也不具root权限。

• chown()函数

  int chown(const char *path, uid_t owner, gid_t group);

  函数说明：chown()会将参数path指定文件的所有者变更为参数owner代表的用户，而将该文件的组变更为参数group组。如果参数owner或group为-1，对应的所有者或组不会有所改变。root与文件所有者皆可改变文件组，但所有者必须是参数group组的成员。当root用chown()改变文件所有者或组时，该文件若具有S_ISUID或S_ISGID权限，则会清除此权限位，此外，如果具有S_ISGID权限但不具S_IXGRP位，则该文件会被强制锁定，文件模式会保留。

  返回值：成功则返回0，失败返回-1，错误原因存于errno中。

• chroot()函数

  int chroot(const char *path);

  函数说明：chroot()用来改变根目录为参数path所指定的目录。只有超级用户才允许改变根目录，子进程将继承新的根目录。

  返回值：调用成功返回0，失败返回-1，错误代码存于errno中。

• closedir()函数

  int closedir(DIR *dir);

  函数说明：closedir()关闭参数dir所指的目录流。

  返回值：关闭成功则返回0，失败返回-1，错误原因存于errno中。

  错误代码：EBADF参数dir为无效的目录流。

• fchdir()函数

  int fchdir(int fd);

  函数说明：fchdir()用来将当前的工作目录改变成参数fd所指的文件描述词。

  返回值：执行成功则返回0，失败返回-1，errno为错误代码。

• fchmod()函数

  int fchmod(int fildes, mode_t mode);

  函数说明：fchmod()会依参数mode权限来更改fildes所指文件的权限。参数fildes为已打开文件的描述词。

  返回值：权限改变成功返回0，失败返回-1，错误原因存于errno中。

  错误代码：
  1）EBADF 参数fildes为无效的文件描述词
  2）EPERM 进程的有效用户识别码与欲修改权限的文件所有者不同，而且也不具root权限
  3）EROFS 欲写入权限的文件存在于只读文件系统内
  4）EIO I/O存取错误。

• fchown()函数

  int fchown(int fd, uid_t owner, gid_t group);

  函数说明：fchown()会将参数fd指定文件的所有者变更为参数owner代表的用户，而将该文件的组变更为group组。如果参数owner或group为-1，对应的所有者或组有所改变。参数fd为已打开的文件描述词。当root用fchown()改变文件所有者或组时，该文件若具S_ISUID或S_ISGID权限，则会清除此权限位。

  返回值：成功则返回0，失败则返回-1，错误原因存于errno。

• fstat()函数

  int fstat(int fildes, struct stat *buf);

  函数说明：fstat()用来将参数fildes所指的文件状态，复制到参数buf所指的结构中（struct stat)。fstat()与stat()作用完全相同，不同处在于传入参数为已打开的文件描述词。

  返回值：执行成功则返回0，失败返回-1，错误代码存于errno。

• ftruncate()函数

  int ftruncate(int fd, off_t length);

  函数说明：ftruncate()会将参数fd指定的文件改为参数length指定的大小。参数fd为已打开的文件描述词，而且必须是以写入模式打开的文件。如果原来的文件大小比参数length大，则超过的部分会被删除。

  返回值：执行成功则返回0，失败返回-1，错误原因存于errno中。

  错误代码：
  1）EBADF 参数fd文件描述词为无效的或该文件已关闭。
  2）EINVAL 参数fd为socket并非文件，或是该文件并非以写入模式打开。

• getcwd()函数

  char *getcwd(char *buf, size_t size);

  函数说明：getcwd()会将当前的工作目录绝对路径复制到参数buf所指的内存空间，参数size为buf的空间大小。

  注意：在调用此函数时，buf所指的内存空间要足够大。若工作目录绝对路径的字符串长度超过参数size大小，则返回NULL，errno的值为ERANGE；倘若参数buf为NULL，getcwd()会依参数size的大小自动配置内存（使用malloc()），如果参数size也为0，则getcwd()会依工作目录绝对路径的字符串程度来决定所配置的内存到小，进程可以在使用完此字符串后利用free()来释放此空间。

  返回值：执行成功则将结果复制到参数buf所指的内存空间，或是返回自动配置的字符串指针。失败返回NULL，错误代码存于errno。

• link()函数

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

  函数说明：link()以参数newpath指定的名称来建立一个新的连接（硬链接）到参数oldpath所指定的已存在文件。如果参数newpath指定的名称为一已存在的文件则不会建立连接。

  返回值：link()所建立的硬链接无法跨越不同文件系统，如果需要可改用symlink()。

• lstat()函数

  int lstat(const char *file_name, struct stat *buf);

  函数说明：lstat()与stat()作用完全相同，都是参数file_name所指的文件状态，其差别在于当文件为符号链接时，lstat()会返回该link本身的状态。

  返回值：执行成功则返回0，失败则返回-1，错误代码存于errno。

• opendir()函数

  DIR *opendir(const char *name);

  函数说明：opendir()用来打开参数name指定的目录，并返回DIR *形态的目录流，和open()类似，接下来对目录的读取和搜索都要使用此返回值。

  返回值：成功返回DIR *形态的目录流，打开失败则返回NULL。

• readdir()函数

  struct dirent* readdir(DIR *dir);

  函数说明：readdir()返回参数dir目录流的下个目录进入点。

  返回值：成功则返回下个目录进入点，有错误发生或读取到目录文件尾则返回NULL。

• readlink()函数

  int readlink(const char *path, char *buf, size_t bufsize);

  函数说明：readlink()会将参数path的符号连接内容存到参数buf所指的内存空间，返回的内容不是以NULL作字符串结尾，但会将字符串的字符数返回。若参数bufsize小于符号连接的内容长度，过长的内容会被截断。

  返回值：执行成功则传符号连接所指的文件路径字符串，失败则返回-1，错误代码存于errno。

• rewinddir()函数

  void rewinddir(DIR *dir);

  函数说明：rewinddir()用来设置参数dir目录流目前的读取位置为原来开头的读取位置。

  错误代码：EBADF dir为无效的目录流。

• seekdir()函数

  void seekdir(DIR *dir, off_t offset);

  函数说明：seekdir()用来设置参数dir目录流目前的读取位置，在调用readdir()时便从此新位置开始读取。参数offset代表距离目录文件开头的偏移量。

  错误代码：EBADF 参数dir为无效的目录流。

• stat()函数

  int stat(const char *file_name, struct stat *buf);

  函数说明：stat()用来将参数file_name所指的文件状态复制到参数buf所指的结构中。

  返回值：执行成功返回0，失败返回-1，错误代码存于errno中。

• symlink()函数

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

  函数说明：symlink()以参数newpath指定的名称建立一个新的连接（符号连接）到参数oldpath所指定的已存在文件。oldpath指定的文件不一定存在，如果参数newpath指定的名称为一已存在的文件则不会建立连接。

  返回值：成功则返回0，失败返回-1，错误原因存于errno。

• telldir()函数

  off_t telldir(DIR *dir);

  函数说明：telldir()返回参数dir目录流目前读取位置。此返回值代表距离目录文件开头的偏移量返回值返回下一个读取位置，有错误发生时返回-1。

  错误代码：EBADF 参数dir为无效的目录流。

• truncate()函数

  int truncate(const char *path, off_t length);

  函数说明：truncate()会将参数path指定的文件大小改为参数length指定的大小。如果原来的文件大小比参数length大，则超过的部分会被删去。

  返回值：执行成功则返回0，失败返回-1，错误原因存于errno。

• umask()函数

  mode_t umask(mode_t mask);

  函数说明：umask()会将系统umask值设成参数mask&0777后的值，然后将先前的umask值返回。在使用open()建立新文件时，该参数mode并非真正建立文件的权限，而是（mode&~umask）的权限值。

• unlink()函数

  int unlink(const char *pathname);

  函数说明：unlink()会删除参数pathname指定的文件。如果该文件名为最后连接点，但有其他进程打开了此文件，则在所有关于此文件的文件描述词皆关闭后才会删除。如果参数pathname为一符号连接，则此连接会被删除。

  返回值：成功则返回0，失败返回-1，错误原因存于errno中。

• utime()函数

  int utime(const char * filename, struct utimbuf * buf);

  函数说明：utime()用来修改参数filename 文件所属的inode 存取时间。

  返回值：如果参数buf 为空指针(NULL), 则该文件的存取时间和更改时间全部会设为目前时间.。执行成功则返回0，失败返回-1，错误代码存于errno。

  错误代码：EACCESS 存取文件时被拒绝, 权限不足；ENOENT 指定的文件不存在。

• utimes()函数

  int utimes(char * filename, struct timeval *tvp);

  函数说明：utimes()用来修改参数filename 文件所属的inode 存取时间和修改时间。

  返回值：参数tvp指向两个timeval结构空间,和utime()使用的utimebuf结构比较,tvp[0].tc_sec则为utimbuf.actime,tvp[1].tv_sec为utimbuf.modtime.执行成功则返回0.失败返回-1。错误代码存于errno.

  错误代码：EACCESS 存取文件时被拒绝, 权限不足；ENOENT 指定的文件不存在。

数学函数整体概述

• abs()：求绝对值（整数）
• atan()：求反正切的值（以弧度表示）
• atan2()：求反正切的值（以弧度表示）
• ceil()：向上取整

数学函数详细介绍

• abs()函数

  int abs(int j);

  函数说明：abs()用来计算参数j的绝对值，然后将结果返回。

  返回值：返回参数j的绝对值结果。

• asin()函数

  double asin(double x);

  函数说明：asin()用来计算参数x的反正弦值，然后将结果返回。参数x的范围为-1至1之间，超过此范围则会失败。

  返回值：返回-PI/2~PI/2之间的计算结果。

  错误代码：EDOM参数x超出范围。注意：使用GCC编译时需加入-lm。

• atan()函数

  double atan(double x);

  函数说明：atan()用来计算参数x的反正切值，然后将结果返回。

  返回值：返回-PI/2~PI/2之间的计算结果。注意：使用GCC编译时需加入-lm。

• atan2()函数

  double atan2(double y, double x);

  函数说明：atan2()用来计算参数y/x的反正切值，然后将结果返回。

  返回值：返回-PI/2~PI/2之间的计算结果。注意：使用GCC编译时需加入-lm。

• 参考文献

  http://c.biancheng.net/cpp/u/hs8/
  http://c.biancheng.net/cpp/u/hs5/