基本IO函数的使用（open,write,read）

基本IO函数的使用（open,write,read）(转) (2009-05-26 22:54)

分类： UNIX

摘要：本文简单介绍文件操作的三个函数（open，read，write）的基本用法。
 详细说明了open函数的用法。

    作者：zieckey （zieckey＠yahoo.com.cn）
    All Rights Reserved！

所需头文件：
 #include<sys/types.h>
 #include<sys/stat.h>
 #include<fcntl.h>

函数定义：
 int open( const char * pathname, int flags);
 int open( const char * pathname,int flags, mode_t mode);

函数说明：
 参数 pathname 指向欲打开的文件路径字符串。下列是参数 flags 所能使用的旗标:
 O_RDONLY 以只读方式打开文件
 O_WRONLY 以只写方式打开文件
 O_RDWR以可读写方式打开文件。
 上述三种旗标是互斥的,也就是不可同时使用,但可与下列的旗标利用 OR(|)运算符组合。

 O_CREAT 若欲打开的文件不存在则自动建立该文件。
 O_EXCL 如果 O_CREAT 也被设置,     此指令会去检查文件是否存在。文件若不存在则建立该文件,         
   否则将导致打开文件错误。 此外,若 O_CREAT 与 O_EXCL 同时设置,  并且欲打开的文件为符号连接,则会打开文件失败。
 O_NOCTTY 如果欲打开的文件为终端机设备时,则不会将该终端机当成进程控制终端机。
 O_TRUNC 若文件存在并且以可写的方式打开时,此旗标会令文件长度清为 0,而原来存于该文件的资料也会消失。
 O_APPEND 当读写文件时会从文件尾开始移动,        也就是所写入的数据会以附加的方式加入到文件后面。
 O_NONBLOCK 以不可阻断的方式打开文件,也就是无论有无数据读取或等待,都会立即返回进程之中。
 O_NDELAY 同 O_NONBLOCK。
 O_SYNC 以同步的方式打开文件。
 O_NOFOLLOW 如果参数 pathname 所指的文件为一符号连接,则会令打开文件失败。
 O_DIRECTORY 如果参数 pathname 所指的文件并非为一目录,  则
    会令打开文件失败。此为 Linux2.2 以后特有的旗标,以避免一些系
    统安全问题。参数 mode 则有下列数种组合,只有在建立新文件时
    才会生效,此外真正建文件时的权限会受到 umask 值所影响,因此
    该文件权限应该为(mode-umaks).
 S_IRWXU00700 权限, 代表该文件所有者具有可读、    可写及可执行的权限。
 S_IRUSR 或 S_IREAD,00400 权限,代表该文件所有者具有可读取的权限。
 S_IWUSR 或 S_IWRITE,00200 权限,代表该文件所有者具有可写入的权限。
 S_IXUSR 或 S_IEXEC,00100 权限,代表该文件所有者具有可执行的权限。
 S_IRWXG 00070 权限,代表该文件用户组具有可读、    可写及可执行的权限。
 S_IRGRP 00040 权限,代表该文件用户组具有可读的权限。
 S_IWGRP 00020 权限,代表该文件用户组具有可写入的权限。
 S_IXGRP 00010 权限,代表该文件用户组具有可执行的权限。
 S_IRWXO 00007 权限,代表其他用户具有可读、可写及可执行的权限。
 S_IROTH 00004 权限,代表其他用户具有可读的权限
 S_IWOTH 00002 权限,代表其他用户具有可写入的权限。
 S_IXOTH 00001 权限,代表其他用户具有可执行的权限。

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

错误代码：
 EEXIST 参数 pathname 所指的文件已存在,却使用了 O_CREAT和 O_EXCL 旗标
 EACCESS 参数 pathname 所指的文件不符合所要求测试的权限。
 EROFS 欲测试写入权限的文件存在于只读文件系统内。
 EFAULT 参数 pathname 指针超出可存取内存空间。
 EINVAL 参数 mode 不正确。
 ENAMETOOLONG 参数 pathname 太长。
 ENOTDIR 参数 pathname 不是目录。
 ENOMEM 核心内存不足。
 ELOOP 参数 pathname 有过多符号连接问题。
 EIO I/O 存取错误。

范例：

#include <unistd.h> #include <sys/types.h> #include <sys/stat.h> #include <fcntl.h> #include <stdio.h> int main(void) {     int fd,size;     char s[]="This program is used to show how to use open(),write(),read() function.\nHave fun!\n";     char buffer[80];          fd = open( "temp.log", O_WRONLY|O_CREAT );//以可读写的方式打开一个文件，如果不存在则创建该文件     if ( -1 == fd )     {         printf("Open or create file named \"temp.log\" failed.\n");         return -1;     }     write( fd, s, sizeof(s) );//向该文件中写入一个字符串     close( fd );          fd = open( "temp.log", O_RDONLY );     if ( -1 == fd )     {         printf("Open file named \"temp.log\" failed.\n");         return -1;     }     size = read( fd, buffer, sizeof(buffer) );//读取文件内容保存到buffer指定的字符串数组中，返回读取的字符个数     close( fd );     printf( "%s", buffer );          return 0; }

 

 

1. read

 #include <unistd.h>
 ssize_t read(int filedes, void *buf, size_t nbytes);

 返回值：读取到的字节数；0（读到 EOF）；-1（出错）

 read 函数从 filedes 指定的已打开文件中读取 nbytes 字节到 buf 中。以下几种情况会导致读取到的字节数小于 nbytes ：

 A. 读取普通文件时，读到文件末尾还不够 nbytes 字节。例如：如果文件只有 30 字节，而我们想读取 100 字节，那么实际读到的只有 30 字节，read 函数返回 30 。此时再使用 read 函数作用于这个文件会导致 read 返回 0 。

 B. 从终端设备（terminal device）读取时，一般情况下每次只能读取一行。

 C. 从网络读取时，网络缓存可能导致读取的字节数小于 nbytes 字节。

 D. 读取 pipe 或者 FIFO 时，pipe 或 FIFO 里的字节数可能小于 nbytes 。

 E. 从面向记录（record-oriented）的设备读取时，某些面向记录的设备（如磁带）每次最多只能返回一个记录。

 F. 在读取了部分数据时被信号中断。

 读操作始于 cfo 。在成功返回之前，cfo 增加，增量为实际读取到的字节数。

2. write

 #include <unistd.h>
 ssize_t write(int filedes, const void *buf, size_t nbytes);

 返回值：写入文件的字节数（成功）；-1（出错）

 write 函数向 filedes 中写入 nbytes 字节数据，数据来源为 buf 。返回值一般总是等于 nbytes，否则就是出错了。常见的出错原因是磁盘空间满了或者超过了文件大小限制。

 对于普通文件，写操作始于 cfo 。如果打开文件时使用了 O_APPEND，则每次写操作都将数据写入文件末尾。成功写入后，cfo 增加，增量为实际写入的字节数。

 

lseek(移动文件的读写位置) 
   
表头文件      
     #include<sys/types.h>
     #include<unistd.h>
定义函数: off_t lseek(int fildes,off_t offset ,int whence);
函数说明:
    每一个已打开的文件都有一个读写位置,当打开文件时通常其读写
    位置是指向文件开头,若是以附加的方式打开文件(如    O_APPEND)
    ,则读写位置会指向文件尾。当 read() 或 write()
    时,读写位置会随之增加,lseek()便是用来控制该文件的读写位
    置。参数 fildes 为已打开的文件描述词,参数 offset 为根据参数
    whence 来移动读写位置的位移数。参数 whence 为下列其中一种:
    SEEK_SET 参数 offset 即为新的读写位置。
    SEEK_CUR 以目前的读写位置往后增加 offset 个位移量。
    SEEK_END 将读写位置指向文件尾后再增加 offset 个位移量。
    当 whence 值为 SEEK_CUR 或 SEEK_END 时,参数 offet 允许负值
    的出现。
    下列是教特别的使用方式:
    1) 欲将读写位置移到文件开头时:lseek(int fildes,0,SEEK_SET)     ;
    2) 欲将读写位置移到文件尾时:lseek(int fildes,0,SEEK_END)      ;
    3) 想要取得目前文件位置时:lseek(int fildes,0,SEEK_CUR)      ;
   
 返回值     
     当调用成功时则返回目前的读写位置,也就是距离文件开头多少个
     字节。若有错误则返回-1,errno 会存放错误代码。

附加说明
    Linux 系统不允许 lseek()对 tty 装置作用,此项动作会令 lseek()
     返回 ESPIPE。

示例程序：
运行结果：
[root@localhost src]# gcc lseek.c
[root@localhost src]# ./a.out
[root@localhost src]# cat temp.log
Hello woHello woHello woHello woHello woHello woHello woHello woHello woHello world!

/******************************************************************************************* ** Name:lseek.c **        This program is used to show the usage of lseek() . ** Author:zieckey ** Date:2007/9/29 ** All rights reserved! *******************************************************************************************/ #include <unistd.h> #include <sys/types.h> #include <sys/stat.h> #include <fcntl.h> #include <stdio.h> int main(void) {     int fd, i, rev;     char buf[] = "Hello world!";     fd = open( "temp.log", O_WRONLY|O_CREAT );//以可读写的方式打开一个文件，如果不存在则创建该文件          for( i=0; i<10; i++ )     {         write( fd, buf, sizeof(buf) );         lseek( fd, -5, SEEK_CUR);     }          close( fd );     return 0; }

 

mkstemp(建立唯一的临时文件)
表头文件 #include<stdlib.h>
定义函数 int mkstemp(char * template);
函数说明:
     mkstemp()用来建立唯一的临时文件。参数 template 所指的文件
     名称字符串中最后六个字符必须是 XXXXXX。mkstemp()会以可
     读写模式和 0600 权限来打开该文件,如果该文件不存在则会建立
     该文件。打开该文件后其文件描述词会返回。
     文件顺利打开后返回可读写的文件描述词。若果文件打开失败则返
     回 NULL,并把错误代码存在 errno 中。

错误代码
     EINVAL 参数 template 字符串最后六个字符非 XXXXXX。
     EEXIST 无法建立临时文件。
    
附加说明
    参数 template 所指的文件名称字符串必须声明为数组,如:
        char template[ ] =”template-XXXXXX”;
         千万不可以使用下列的表达方式
        char *template = “template-XXXXXX”;

#include <stdlib.h>
#include <stdio.h>

int main(void)
{
    char temp[] = "tempfile_XXXXXX";
    char content[] = "This is written by the program.";
    int fd;
    fd = mkstemp( temp );
    write( fd, content, sizeof(content) );
    printf( "The template file name is %s\n", temp );
    close( fd );
    return 0;    
}