nios_ii_cfunction.txt

汇总了nios II中的常用C函数

输入参数：void
函数说明：启动中断
返回值：  禁止中断返回0，反之为非0

函数原型：int alt_irq_register (alt_u32 id, void* context, void (*isr)(void*, alt_u32))
输入参数：id,32位无符号数，中断使能；context和id是isr的两个输入参数；中断激活时调用isr
函数说明：寄存一个isr
返回值：  成功返回0，反之为非0


函数原型：int alt_write_flash(alt_flash_fd* fd, int offset, const void* src_addr, 
int length)
输入参数：src_addr源地址；fd，flash设备；offset 偏移量；length字节长度
函数说明：写数据到flsah中，要写的数据在源地址src_addr中
返回值：  成功返回0，反之为非0

函数原型：int alt_write_flash_block(alt_flash_fd* fd, int block_offset, int data_offset,
const void *data, int length)
输入参数：fd；data_offset起始写数据的偏移量；length为要写数据的长度
函数说明：写入到一个已擦除的flash模块
返回值：  成功返回0，反之为非0

函数原型：int close (int filedes)
输入参数：filedes，描述符
函数说明：标准的UNIX函数close()，关闭文件描述符filedes
返回值：  成功返回0，反之为－1

函数原型：int open (const char* pathname, int flags, mode_t mode)
输入参数：pathname, 路径名；flags,O_RDONLY或O_WRONLY 或O_RDWR,分别对应着只读，只写，或读写操作；mode，使用许可说明
函数说明：打开文件或设备，返回一个文件描述符（读写中使用的非负整数）
返回值：  成功返回文件描述符，反之返回－1

函数原型：int read(int file,  void *ptr,  size_t  len)
输入参数：file文件描述符；ptr为读数据的位置指针，len读数据的长度，单位为字节
函数说明：从文件或设备中读取数据块
返回值：  成功返回读取的字节数，反之返回－1

函数原型：clock_t times (struct tms *buf)
输入参数：buf结构体指针
函数说明：兼容newlib，tms的结构体指针如下：
          type struct
{clock_t  tms_utime;
clock_t  tms_stime;
clock_t  tms_cutime;
clock_t  tms_sutime;
};
tms_utime： CPU索取用户指令的执行时间
tms_stime： CPU索取由系统表示的过程的执行时间
tms_cutime：所有子进程tms_utime和tms_cutime的时间之和
tms_sutime：所有子进程tms_stime和tms_sutime的时间之和
返回值：  返回时钟数，没有时钟则返回0

函数原型：int usleep (int us)
输入参数：us,单位为微秒
函数说明：直到us微秒后才解除阻塞，即其功能相当于延时us微秒
返回值：  成功返回0，反之为－1，有错误发生显示错误发生原因

函数原型：int wait(int *status)
输入参数： status 进程状态指针
函数说明：功能是等候所有子进程退出，由于HAL不支持分散子进程，函数立即返回
返回值：  status内容清0，表明没有子进程；返回值为－1，且errno置为ECHILD，            表明没有子进程等候

函数原型：int write(int file, const void *ptr, size_t len)
输入参数：file文件描述符；ptr为读数据的位置指针，len读数据的长度，单位为字节
函数说明：往文件或设备写入数据块，
返回值：  成功返回写入的字节数，也可能少于请求的长度；反之返回－1，万一有错误发生，errno被设置为发生的原因

数据的标准类型
类型 说明
alt_8 符号8位整数
alt_u8 无符号8位整数
alt_16 符号16位整数
alt_u16 无符号16位整数
alt_32 符号32位整数
alt_u32 无符号32位整数

下面为自己整理
函数原型：int  fopen (char * file_name, way_use);
输入参数：file_name文件名，way_use使用文件方式，比如r，w分别对应着读写
函数说明：打开文件，对其进行某种文件操作
返回值：  打不开则出错，返回一个空指针NULL

函数原型：int  fclose (fp)
输入参数：fp的定义为：FILE *fp
函数说明：关闭文件fp
返回值：  成功返回0，反之为－1（EOF）


函数原型：int  fread(void *ptr, int size, int count, FILE * fp);
输入参数：buffer为指针；是读入数据地存放地址；size读字节数；count读字节数地数目；fp文件型指针
函数说明：从一个流中读取数据
返回值：  成功返回值为count
 
函数原型：int  fwrite(void *ptr, int size, int count, FILE *fp)
输入参数：buffer为指针；是读入数据地存放地址；size读字节数；count读字节数地数目；fp文件型指针，
函数说明：写内容到流中
返回值：  成功返回值为count


函数原型：int  fprintf(FILE *fp, char *format[, argument,...]);
输入参数：fp文件型指针；format格式字符串；[, argument,...]输出列表,如：
          fprintf(fp,“%d,%f”,i,t)
函数说明：传送格式化输出到一个流中
返回值：  －

函数原型：int  fscanf(FILE * fp, char *format[,argument...])
输入参数：fp文件型指针；format格式字符串；[, argument,...]输入列表，如：
          fscanf(fp,“%d,%f”,i,t)
函数说明：从一个流中执行格式化输入 
返回值：  －

函数原型：int  fputc(int ch, FILE *fp)
输入参数：ch字符；fp：文件型指针
函数说明：送一个字符到一个流中
返回值：  成功返回字符，反之返回－1（EOF）

函数原型：int  fgetc(FILE *fp);
输入参数：fp：文件型指针
函数说明：从流中读取字符
返回值：  遇到文件结束返回－1（EOF）

函数原型：int  putw(int w, FILE *fp)
输入参数：w: 字符或字; fp：文件型指针
函数说明：把一字符或字送到流中
返回值：  －

函数原型：int  getw(FILE *fp)
输入参数：fp：文件型指针
函数说明：从流中取一整数
返回值：  －

函数原型：int rewind(FILE *fp)
输入参数：fp：文件型指针
函数说明：将文件指针重新指向一个流的开头
返回值：  －
 
函数原型：int fseek(FILE *fp, long offset, int fromwhere); 
输入参数：fp：文件型指针；offset：long型偏移量；fromwhere：起始点
          起始点为0，1，2分别代表文件开始，当前位置，文件末尾
函数说明：重定位流上的文件指针
返回值：  －
 
函数原型：int ferror(FILE *fp)
输入参数：fp：文件型指针
函数说明：检测流上的错误 
返回值：  未出错返回值为0，反之为非0

函数原型：long ftell(FILE *fp)
输入参数：fp：文件型指针
函数说明：返回当前文件指针，得到当前位置
返回值：  返回值为－1表示出错，反之为非0
 
函数原型：void clearerr(FILE *fp)
输入参数：fp：文件型指针
函数说明：复位错误标志
返回值：  出错为非0，反之为0

函数原型：char *fgets(char *string, int n, FILE *fp)
输入参数：string：字符串指针；fp：文件型指针
函数说明：从流中读取一字符串，但只从文件输入n－1个字符，后一个为‘\0’结束标志位
返回值：  －

函数原型：nt fputs(char *string, FILE *fp)
输入参数：string：字符串指针；fp：文件型指针
函数说明：送一个字符串到一个流中 
返回值：  －

函数原型：int feof(FILE *fp)
输入参数：fp：文件型指针
函数说明：检测流上的文件结束符
返回值：  －