C API 翻译 【2013.10.12小记】

无聊把C API 翻译一遍

欢迎加入我们的QQ群，无论你是否工作，学生，只要有c / vc / c++ 编程经验，就来吧！158427611 

• abort           stdlib.h ， 无参数 ， 用于终止程序
• abs              stdlib.h  ，int abs( int num )，返回绝对值
• acos            math.h  ，double acos( double arg )，求反余弦 -1<arg<1
• asctime      time.h   ，char *asctime( const struct tm *ptr )，将ptr的时间结构转换成字符串【day month date hours:minutes:seconds year\n\0】
• asin             math.h ，double asin( double arg )，求反正弦 -1< arg <1
• assert         assert.h，void assert( int exp )，用于断言对错
• atan             math.h，double atan( double arg )，反正切 
• atan2           math.h，double atan2( double y, double x )，计算y/x的反正切值，按照参数的符号计算所在的象限
• atexit            stdlib.h，int atexit( void (*func)(void) )， 退出后执行的方法注册，程序退出时执行func方法。
• atof               stdlib.h， double atof( const char *str )，字符串转double【str 必须以有效数字开头,但是允许以“E”或“e”除外的任意非数字字符结尾】
• atoi               stdlib.h，  int atoi( const char *str )，字符串转整数，【参数str 以数字开头，当函数从str 中读到非数字字符则结束转换并将结果返回】
• atol               stdlib.h，  long atol( const char *str )，字符串转长整型数。【参数str会跳过前面的空格字符，直到数字或正负符号才开始，再遇非数字或结束时才结束】
• bsearch       stdlib.h， void *bsearch( const void *key, const void *buf, size_t num, size_t size, int (*compare)(const void *, const void *) )，折半查找法在从数组元素buf[0]到buf[num-1] 匹配参数key。如果函数compare 的第一个参数小于第二个参数，返回负值；如果等于返回零值；如果大于返回正值。数组buf 中的元素应以升序排列。函数bsearch()的返回值是指向匹配项，如果没有发现匹配项，返回NULL
• calloc            stdlib.h，  void *calloc( size_t num, size_t size )，申请num个size大小的空间。【如果失败，返回NULL】
• ceil                math.h，  double ceil( double num )，想num上取整数。。。
• clearerr        stdio.h，  void clearerr( FILE *stream ) ，重置错误标记和给出的流的EOF指针。
• clock             time.h，  clock_t clock( void )，返回自程序开始运行的处理器时间。【如果无可用信息，返回-1。 转换返回值以秒记, 可除以CLOCKS_PER_SECOND】
• cos                math.h，  double cos( double arg )，求arg的余弦值。【arg以弧度表示给出】
• cosh              math.h，  double cosh( double arg )，求双曲余弦值。
• ctime             time.h，  char *ctime( const time_t *time )，转换参数time为本地时间。【day month date hours:minutes:seconds year\n\0】
• difftime          time.h，  double difftime( time_t time2, time_t time1 )，求时间差。
• div                  stdlib.h，  div_t div( int numerator, int denominator )，求商和余数。【div_t.quot 为 商 div_t.rem;为 余数】
• exit                 stdlib.h，  void exit( int exit_code )，终止程序。【exit_code 传递给返回值，通常零值表示正常结束，非零值表示应错误返回】
• exp                 math.h，  double exp( double arg )，求数学中e的arg次幂。【e = 2.7182818 】
• fabs               math.h，  double fabs( double arg )，求绝对值。
• fclose            stdio.h，  int fclose( FILE *stream )，关闭文件。【成功时返回0,否则返回EOF】
• feof                 stdio.h，  int feof( FILE *stream )，到达给出的文件流的文件尾时返回一个非零值。
• ferror              stdio.h，  int ferror( FILE *stream )，检查文件流中的错误。【如果没发生错误返回0，否则返回非零，可用perror()检测发生什么错误】
• fflush             stdio.h，  int fflush( FILE *stream )，如果文件流是输出流,那么fflush()把输出到缓冲区的内容写入文件. 如果是输入类型的,那么fflush()会清除输入缓冲区】
• fgetc              stdio.h，  int fgetc( FILE *stream )，去文件流中的下一个字符。【如果到达文件尾或者发生错误时返回EOF】
• fgetpos         stdio.h，  int fgetpos( FILE *stream, fpos_t *position )，保存给出的文件流的位置指针到给出的位置变量(position)中。方便二次使用。
• fgets              stdio.h，  char *fgets( char *str, int num, FILE *stream )，保存文件中的num个字符到str中。
• floor               math.h，  double floor( double arg )，向下取整。
• fmod              math.h，  double fmod( double x, double y )，求余。【x/y】
• fopen             stdio.h，  FILE *fopen( const char *fname, const char *mode )，打开文件流，用mode模式。
• fprintf             stdio.h，  int fprintf( FILE *stream, const char *format, ... )，格式化写入文件。
• fputc              stdio.h，  int fputc( int ch, FILE *stream )，写入字符。
• fputs              stdio.h，  int fputc( const char *str, FILE *stream )，写入字符串。
• fread              stdio.h，  int fread( void *buffer, size_t size, size_t num, FILE *stream )，从stream读取num个每个大小为size的数据到buffer。
• free                stdlib.h，  void free( void *ptr )，释放ptr内存空间。
• freopen         stdio.h，  FILE *freopen( const char *fname, const char *mode, FILE *stream )，重新打开文件。
• frexp              math.h，  double frexp( double num, int *exp )，将num转换成 科学计数法，exp为返回次方。
• fscanf           stdio.h，  int fscanf( FILE *stream, const char *format, ... )，格式化文件读取字符串。
• fseek             stdio.h，  int fseek( FILE *stream, long offset, int origin )，返回文件流的设置位置数据。【SEEK_SET，SEEK_CUR，SEEK_END。开头，现在，结尾】
• fsetpos         stdio.h，  int fsetpos( FILE *stream, const fpos_t *position )，设置文件流位置。
• ftell                 stdio.h，  long ftell( FILE *stream )，返回当前文件流位置。
• fwrite             stdio.h，  int fwrite( const void *buffer, size_t size, size_t count, FILE *stream )，向stream写入count个大小为size的buffer数据。
• getc               stdio.h，  int getc( FILE *stream )，获取文件流下一个字符。【同fgetc】
• getchar         stdio.h，  int getchar( void )，从输入缓存区中读取一个字符。
• getenv           stdlib.h，  char *getenv( const char *name )，返回环境变量name的值。【如果无对应的环境变量name返回NULL】
• gets               stdio.h，  char *gets( char *str )，从输入缓存区读取字符串。
• gmtime         time.h，  struct tm *gmtime( const time_t *time )，转换时间格式。
• isalnum        ctype.h，  int isalnum( int ch )，判断ch是否是数字或者字母字符。
• isalpha         ctype.h，  int isalpha( int ch )，判断ch是否是字母字符。
• iscntrl            ctype.h，  int iscntrl( int ch )，判断ch是否是控制字符（0和0x1F之间的字符，或者等于0x7F）。
• isdigit            ctype.h，  int isdigit( int ch )，判断ch是否是 0 - 9 字符。
• isgraph         ctype.h，  int isgraph( int ch )，判断ch是否是 非空格字符。
• islower          ctype.h，  int islower( int ch )，判断ch是否是 小写字母字符。
• isprint            ctype.h，  int isprint( int ch )，判断ch是否是 可以打印字符。
• ispunct          ctype.h，  int ispunct( int ch )，判断ch是否是 除字母，数字，空格以外的可打印字符。
• isspace         ctype.h，  int isspace( int ch )，判断ch是否是 空格类字符。【单空格，制表符，垂直制表符，满页符，回车符，新行符】
• isupper          ctype.h，  int isupper( int ch )，判断ch是否是 大写字母字符。
• isxdigit           ctype.h，  int isxdigit( int ch )，判断ch是否是 十六进制字符。【0-9 a-f A-F】
• labs                stdlib.h，  long labs( long num )，求绝对值。
• ldexp               math.h，  double ldexp( double num, int exp )，【同frexp】
• ldiv                  stdlib.h，  ldiv_t ldiv( long numerator, long denominator )，求商和余数。【同div】
• localtime        time.h，  struct tm *localtime( const time_t *time )，求本地时间。
• log                   math.h，  double log( double num )，求log。
• log10              math.h，  double log10( double num )，求以10为底的对数(log)。
• longjmp         setjmp.h，  void longjmp( jmp_buf envbuf, int status )，跳转到前一次setjmp的地方执行。
• malloc            stdlib.h，  void *malloc( size_t size )，申请内存空间。
• memchr         string.h，  void *memchr( const void *buffer, int ch, size_t count )，在buffer的count长度内查找ch，找到就返回ch的位置指针。
• memcmp       string.h，  int memcmp( const void *buffer1, const void *buffer2, size_t count )，比较buffer1和buffer2的前count个的大小。【-1 ,0 ,1】
• memcpy         string.h，  void *memcpy( void *to, const void *from, size_t count )，复制from的count大小到to。如果to和from重叠会出现不定性问题
• memmove     string.h，  void *memmove( void *to, const void *from, size_t count )，同memcoy，但是重叠的情况依然正常工作。
• memset          string.h，  void *memset( void *buffer, int ch, size_t count )，设置bugger为count个ch。
• mktime           time.h，  time_t mktime( struct tm *time )，转换tm成time_t。
• modf                math.h，  double modf( double num, double *i )，将分数num格式化成整数和小数。【i为整数，返回值为小数】
• perror              stdio.h，  void perror( const char *str )，打印str(字符串)和一个相应的执行定义的错误消息到全局变量errno中。
• pow                 math.h，  double pow( double base, double exp )，求次幂。【base的exp次幂】
• printf                stdio.h，  int printf( const char *format, ... )，格式化输出缓存区。
• putc                 stdio.h，  int putc( int ch, FILE *stream )，写入ch到stream文件流。
• putchar           stdio.h，  int putchar( int ch )，将ch输出到输出缓存区。
• puts                 stdio.h，  int puts( char *str )，将str字符串输出到输出缓存区。
• qsort                stdlib.h，  void qsort( void *buf, size_t num, size_t size, int (*compare)(const void *, const void *) )，用compare规则快速排序。
• raise                signal.h，  int raise( int signal )，对程序发送指定的信号。【SIGABRT终止错误    SIGFPE  浮点错误 ....】
• rand                 stdlib.h，  int rand( void )，随机生成为随机数。
• realloc             stdlib.h，  void *realloc( void *ptr, size_t size )，给ptr重新申请空间。
• remove            stdio.h，  int remove( const char *fname )，删除文件。
• rename           stdio.h，  int rename( const char *oldfname, const char *newfname )，重命名文件。
• rewind             stdio.h，  void rewind( FILE *stream )，文件指针移到由stream(流)指定的开始处, 同时清除和流相关的错误和EOF标记。
• scanf               stdio.h，  int scanf( const char *format, ... )，从输入缓存区内格式化取输入数据。
• setbuf              stdio.h，  void setbuf( FILE *stream, char *buffer )，设置stream(流)使用buffer(缓冲区),如果buffer(缓冲区)是null,关闭缓冲。
• setjmp             setjmp.h，  int setjmp( jmp_buf envbuf )，设置跳转入口。
• setvbuf            stdio.h，  int setvbuf( FILE *stream, char *buffer, int mode, size_t size )，设置用于stream(流)的缓冲区到buffer(缓冲区),其大小为size(大小).mode(方式)可以是 _IOFBF，_IOLBF，_IONBF，完全缓冲 线缓冲 无缓存。
• signal              signal.h，  void ( *signal( int signal, void (* func) (int)) ) (int)，注册信号处理方法。
• sin                    math.h，  double sin( double arg )，求正弦。
• sinh                  math.h，  double sinh( double arg )，求双曲正弦。
• sprintf              stdio.h，  int sprintf( char *buffer, const char *format, ... )，格式化到buffer。
• sqrt                  math.h，  double sqrt( double num )，求num的平方根。
• srand              stdlib.h，  void srand( unsigned seed )，求随机数。
• sscanf            stdio.h，  int sscanf( const char *buffer, const char *format, ... )，从buffer格式化输入。【类似scanf】
• strcat               string.h，  char *strcat( char *str1, const char *str2 )，连接str2到str1。
• strchr               string.h，  char *strchr( const char *str, int ch )，查找str内第一次出现ch的位置指针。
• strcmp             string.h，  int strcmp( const char *str1, const char *str2 )，比较str1和str2 。【-1 0 1】
• strcoll              string.h，  int strcoll( const char *str1, const char *str2 )，类似strcmp。
• strcpy              string.h，  char *strcpy( char *to, const char *from )，复制字符串从from到to。
• strcspn           string.h，  size_t strcspn( const char *str1, const char *str2 )，返回第一次在str1内查找到str2的位置。
• strerror           string.h，  char *strerror( int num )，返回一个被定义的与某错误代码相关的错误信息。
• strftime           time.h，  size_t strftime( char *str, size_t maxsize, const char *fmt, struct tm *time )，格式化为日期时间信息。
• strlen               string.h，  size_t strlen( char *str )，返回字符串长度。
• strncat             string.h，  char *strncat( char *str1, const char *str2, size_t count )，连接str2的count个字符到str1。
• strncmp          string.h，  int strncmp( const char *str1, const char *str2, size_t count )，比较str1和str2的count个字符。
• strncpy            string.h，  char *strncpy( char *to, const char *from, size_t count )，复制from的count个字符到to中。
• strpbrk             string.h，  char *strpbrk( const char *str1, const char *str2 )，查找str1中第一次出现str2中包含的任意字符时候的位置指针。
• strrchr              string.h，  char *strrchr( const char *str, int ch )，查找str中最后一次出现ch的位置指针。
• strspn              string.h，  size_t strspn( const char *str1, const char *str2 )，类似strcspn。
• strstr                string.h，  char *strstr( const char *str1, const char *str2 )，查找str1中第一次出现str2的位置指针。
• strtod               stdlib.h，  double strtod( const char *start, char **end )，返回带符号的字符串start所表示的浮点型数。字符串end 指向所表示的浮点型数之后的部分。
• strtok               string.h，  char *strtok( char *str1, const char *str2 )，返回str中各个用str2分割的字符串。【和while配合循环使用，用于分割字符串】
• strtol                stdlib.h，  long strtol( const char *start, char **end, int base )，返回带符号的字符串start所表示的长整型数。参数base代表采用的进制方式。指针end 指向start所表示的整型数之后的部分。
• strtoul              stdlib.h，  unsigned long strtoul( const char *start, char **end, int base )，同strol。【它不仅可以返回长整型数，而且可以返回无符号的长整型数】
• strxfrm             string.h，  size_t strxfrm( char *str1, const char *str2, size_t num )，将字符串str2 的前num 个字符存储到字符串str1中。
• system            stdlib.h，  int system( const char *command )，执行DOS命令。
• tan                    math.h，  double tan( double arg )，求正切。
• tanh                  math.h，  double tanh( double arg )，求双曲正切。
• time                  time.h，  time_t time( time_t *time )，获取当前时间，如果time != NULL 则存在time中。
• tmpfile             stdio.h，  FILE *tmpfile( void )，用独特文件名打开文件一个临时文件。【可用于临时文件使用】
• tmpnam          stdio.h，  char *tmpnam( char *name )，创建一个独特的文件名存在name中。【最多可以调用TMP_MAX指定的次数】
• tolower            ctype.h，  int tolower( int ch )，转小写字符。
• toupper           ctype.h，  int toupper( int ch )，转大写字符。
• ungetc             stdio.h，  int ungetc( int ch, FILE *stream )，把字符ch放回到stream(流)中。【难道是用与回滚？】
• va_arg             stdarg.h，  
•                           type va_arg( va_list argptr, type ); 
•                           void va_end( va_list argptr );  
•                           void va_start( va_list argptr, last_parm )
•                           用于可变长参数方法中。
• vprintf, vfprintf  stdarg.h和stdio.h，

               int vprintf( char *format, va_list arg_ptr );
               int vfprintf( FILE *stream, const char *format, va_list arg_ptr );
               int vsprintf( char *buffer, char *format, va_list arg_ptr );
  

               类似格式化字符串，可以被va_arg使用。