函数说明

在gcc编程中,我们常用到的字符格式化输出函数是printf的,实际上gcc继承了C语言处理字符具有强大功能的风格,它提供了一系列的格式化输出函数,主要存在两个库函数文件stdio.h/ stdarg.h中,具体函数如下:

#include <stdio.h>
printf, int printf(const char *format, ...);
fprintf, int fprintf(FILE *stream, const char *format, ...);
sprintf, int sprintf(char *str, const char *format, ...);
snprintf, int snprintf(char *str, size_t size, const char *format, ...);

#include <stdarg.h>
vprintf, vprintf(const char *format, va_list ap);
vfprintf, vfprintf(FILE *stream, const char *format, va_list ap);
vsprintf, int vsprintf(char *str, const char *format, va_list ap);

其中:
  printf和vprintf函数主要是向一个标准输出设备或标准的字符流输出格式化后的字符。
  fprintf和vfprintf 函数主要是向一个给定的字符流设备输出格式化后的字符。
  而sprintf, snprintf, vsprintf 和vsnprintf函数则是将格式化后的结果赋值给一个字符串。

参数说明
%d  十进制有符号整数
%i  十进制有符号整数
注:上面这两个函数在格式化输出时用途是相同的,但在输入时却是不一样的,%i可以接受任何形式的整数,而%d却不能。
%u  十进制无符号整数
%f  输出浮点数
%s  输出字符串
%c  输出单个字符
%p  输出指针的值
%e %E  指数形式的浮点数 ,其中:%e是以小写形式输出的 %E是以大写形式输出的
%x, %X  无符号以十六进制表示的整数,其中:%x是以小写形式输出的 %X是以大写形式输出的
%g, %G 根据输出数据的大小需要决定用普通形式还是指数形式的输出方式,其中: %g是以小写形式输出的 %G是以大写形式输出的
%o  无符号以八进制表示的整数
%n  得到输出字符的个数,但是本参数不产生任何的输出效果。
%m输出错误时的相应的字符串提示。
%% 输出正文字符中的“%”字符
一些解释

'%m’是输出error信息的。如下例子: 

fprintf (stderr, "can't open '%s': %m", filename);

等于如下的输出命令:

fprintf (stderr, "can't open '%s': %s", filename, strerror (errno));

“%p”是输出指针类型参数的,显然被格式化的输入参数必须是指针,可以用“-”来表示左对齐的。 
“%n”是比较特殊的参数,它不对格式化输出影响,而是得到输出结果的字符长度,可以用类型指定参数'h' 和 'l'来分别指定输出的参数分别是short int *和 long int *类型的。如下面的例子:

int nchar;
printf ("%d %s %n", 3, "bears", &nchar);


输出结果:
3 bears


同时将7的值赋给变量nchar。


'%%'是输出“%”的字符。


sprintf() 函数
  sprintf(string, fmt, ...)传回的是string的类型的数组,并以空字符结尾。不过,该函数有可能超过为字符分配的长度。比较危险。常用于将其他类型的值转为字符串类型。


Snprintf()函数
  Snprintf()函数与Sprintf()函数极为相似,但是该函数多了size参数来表示最大的字符数目,该函数返回一个整数值表示被存储的字符的数目,如果返回-1则表示输出的字符空间不够。如下例子:

make_message (char *name, char *value)
{
    int size = 100;
    char *buffer = (char *) xmalloc (size);
    while (1)
    {
        int nchars = snprintf (buffer, size,"value of %s is %s",name, value);
        if (nchars < size)
        return buffer;
        size *= 2;
        buffer = (char *) xrealloc (size, buffer);
    }
}

asprintf()函数
  int asprintf (char **ptr, const char *template, ...)
  本函数跟sprintf()函数很类似,只是它将字符串的分配改成动态分配的形式,参数ptr是指一个char *对象的地址函数返回指向一个新建的指针。如下例子:

make_message (char *name, char *value)
{
    char *result;
    asprintf (&result, "value of %s is %s", name, value);
    return result;
 }

Vprintf()函数
  int vprintf (const char *template, va_list ap)
Vfprintf()函数
  int vfprintf (FILE *stream, const char *template, va_list ap)
vsprintf()函数
  int vsprintf (char *s, const char *template, va_list ap)
vsnprintf()函数
  int vsnprintf (char *s, size_t size, const char *template, va_list ap)
vasprintf()函数
  int vasprintf (char **ptr, const char *template, va_list ap)

参考:http://www.chinaunix.net/jh/23/24825.html


V打头的函数的进一步说明


例子:

char buffer[80];

int vspf(char *fmt, ...)
{
    va_list argptr;
    int cnt;
    va_start(argptr, fmt);
    cnt = vsprintf(buffer, fmt, argptr);
    va_end(argptr);
    return(cnt);
}
int main(void)
{
    int inumber = 30;
    float fnumber = 90.0;
    char string[4] = "abc";
    vspf("%d %f %s", inumber, fnumber, string);
    printf("%s\n", buffer);
    return 0;
}

其中:

va_list 是指C/C++ 中 函数的可变参数列表

va_start  va_end  va_arg的用法,例子如下:

◎用法:

func( Type para1, Type para2, Type para3, ... )
{
    va_list ap;
    va_start( ap, para3 ); //一定要“...”之前的那个参数
    //此时ap指向第一个可变参数
    //调用va_arg取得里面的值
    Type xx = va_arg( ap, Type );
    //Type一定要相同,如:
    //char *p = va_arg( ap, char *);
    //int i = va_arg( ap, int );
    //如果有多个参数继续调用va_arg
    va_end(ap); //For robust!
}


附:

标志

     左对齐:"-"  e.g.   "%-20s"

     右对齐:"+"e.g.   "%+20s"

     空格:若符号为正,则显示空格,负则显示"-"  e.g.   "% 6.2f"    

     #:对c,s,d,u类无影响;对o类,在输出时加前缀o;对x类,在输出时加前缀0x;

          对e,g,f类当结果有小数时才给出小数点。


格式字符串(格式)

     [标志][输出最少宽度][.精度][长度]类型

    "%-md":左对齐,若m比实际少时,按实际输出。

    "%m.ns":输出m位,取字符串(左起)n位,左补空格,当n>mor m省略时m=n

                     e.g.    "%7.2s"  输入CHINA

                                           输出"    CH"

    "%m.nf":输出浮点数,m为宽度,n为小数点右边数位

                     e.g.    "%3.1f"   输入3852.99

                                              输出3853.0

      长度:为h短×××量,l为长×××量


printf的格式控制的完整格式:

%- 0 m.n l或h格式字符


下面对组成格式说明的各项加以说明:

①%:表示格式说明的起始符号,不可缺少。

②-:有-表示左对齐输出,如省略表示右对齐输出。

③0:有0表示指定空位填0,如省略表示指定空位不填。

④m.n:m指域宽,即对应的输出项在输出设备上所占的字符数。N指精度。用于说明输出的实型数的小数位数。为指定n时,隐含的精度为n=6位。

⑤l或h:l对整型指long型,对实型指double型。h用于将整型的格式字符修正为short型。


---------------------------------------

格式字符

格式字符用以指定输出项的数据类型和输出格式。

①d格式:用来输出十进制整数。有以下几种用法:

%d:按整型数据的实际长度输出。

%md:m为指定的输出字段的宽度。如果数据的位数小于m,则左端补以空格,若大于m,则按实际位数输出。

%ld:输出长整型数据。

②o格式:以无符号八进制形式输出整数。对长整型可以用"%lo"格式输出。同样也可以指定字段宽度用“%mo”格式输出。

例:

main()
{ 
int a = -1;
    printf("%d, %o", a, a);
}

运行结果:-1,177777

程序解析:-1在内存单元中(以补码形式存放)为(1111111111111111)2,转换为八进制数为(177777)8。

③x格式:以无符号十六进制形式输出整数。对长整型可以用"%lx"格式输出。同样也可以指定字段宽度用"%mx"格式输出。

④u格式:以无符号十进制形式输出整数。对长整型可以用"%lu"格式输出。同样也可以指定字段宽度用“%mu”格式输出。

⑤c格式:输出一个字符。

⑥s格式:用来输出一个串。有几中用法

%s:例如:printf("%s","CHINA")输出"CHINA"字符串(不包括双引号)。

%ms:输出的字符串占m列,如字符串本身长度大于m,则突破获m的限制,将字符串全部输出。若串长小于m,则左补空格。

%-ms:如果串长小于m,则在m列范围内,字符串向左靠,右补空格。

%m.ns:输出占m列,但只取字符串中左端n个字符。这n个字符输出在m列的右侧,左补空格。

%-m.ns:其中m、n含义同上,n个字符输出在m列范围的左侧,右补空格。如果n>m,则自动取n值,即保证n个字符正常输出。

⑦f格式:用来输出实数(包括单、双精度),以小数形式输出。有以下几种用法:

%f:不指定宽度,整数部分全部输出并输出6位小数。

%m.nf:输出共占m列,其中有n位小数,如数值宽度小于m左端补空格。

%-m.nf:输出共占n列,其中有n位小数,如数值宽度小于m右端补空格。

⑧e格式:以指数形式输出实数。可用以下形式:

%e:数字部分(又称尾数)输出6位小数,指数部分占5位或4位。

%m.ne和%-m.ne:m、n和”-”字符含义与前相同。此处n指数据的数字部分的小数位数,m表示整个输出数据所占的宽度。

⑨g格式:自动选f格式或e格式中较短的一种输出,且不输出无意义的零。


---------------------------------------

关于printf函数的进一步说明:

如果想输出字符"%",则应该在“格式控制”字符串中用连续两个%表示,如:

printf("%f%%",1.0/3);

输出0.333333%。


---------------------------------------

对于单精度数,使用%f格式符输出时,仅前7位是有效数字,小数6位.

对于双精度数,使用%lf格式符输出时,前16位是有效数字,小数6位.



对于m.n的格式还可以用如下方法表示(例)

charch[20];
printf("%*.*s\n",m,n,ch);

前边的*定义的是总的宽度,后边的定义的是输出的个数。分别对应外面的参数m和n。我想这种方法的好处是可以在语句之外对参数m和n赋值,从而控制输出格式。