printf 系列函数

怎甘沉沦 提交于 2019-12-11 01:03:57
#include <stdio.h>

// 将格式化输出写到 stdout
int printf(const char *format, ...);

// 将格式化输出写到指定的 stdio 流 stream
int fprintf(FILE *stream, const char *format, ...);

// 将格式化输出写到文件描述符 fd 引用的文件
int dprintf(int fd, const char *format, ...);

// 将格式化输出写到字符串 str
int sprintf(char *str, const char *format, ...);

// 同 sprintf,但最多写入 size 个字节(包括末尾的空字符)
int snprintf(char *str, size_t size, const char *format, ...);


// 上述的对应版本,但是使用 va_list 而不是变参。
#include <stdarg.h>

int vprintf(const char *format, va_list ap);
int vfprintf(FILE *stream, const char *format, va_list ap);
int vdprintf(int fd, const char *format, va_list ap);
int vsprintf(char *str, const char *format, va_list ap);
int vsnprintf(char *str, size_t size, const char *format, va_list ap);

// 成功时返回输出的字节数;出错时返回负数。
// 对于 snprintf 和 vsnprintf,如果出现截断,则返回没有被截断时理应被写入的字节数。

format 参数的格式:%[flags][width][.precision][length]specifier

specifier(格式字符) 意义
d 以十进制形式输出带符号整数(正数不输出符号)
o 以八进制形式输出无符号整数(不输出前缀0)
x,X 以十六进制形式输出无符号整数(不输出前缀0x)
u 以十进制形式输出无符号整数
f 以小数形式输出单、双精度实数
e,E 以指数形式输出单、双精度实数
g,G 以%f或%e中较短的输出宽度输出单、双精度实数
c 输出单个字符
s 输出字符串
p 输出指针地址
% 输出一个百分号
flags(标识) 描述
- 在给定的字段宽度内左对齐,默认是右对齐。
+ 强制在结果之前显示加号或减号(+ 或 -),即正数前面会显示 + 号。默认情况下,只有负数前面会显示一个 - 号。
空格 如果没有写入任何符号,则在该值前面插入一个空格。
# 与 o、x 或 X 说明符一起使用时,非零值前面会分别显示 0、0x 或 0X。 与 e、E 和 f 一起使用时,会强制输出包含一个小数点,即使后边没有数字时也会显示小数点。默认情况下,如果后边没有数字时候,不会显示显示小数点。 与 g 或 G 一起使用时,结果与使用 e 或 E 时相同,但是尾部的零不会被移除。
0 在指定填充 padding 的数字左边放置零(0),而不是空格。
width(宽度) 描述
数字 要输出的字符的最小数目。如果输出的值短于该数,结果会用空格填充。如果输出的值长于该数,结果不会被截断。
* 宽度在 format 字符串中未指定,但是会作为附加整数值参数放置于要被格式化的参数之前。
.precision(精度) 描述
.number 对于整数说明符(d、i、o、u、x、X):precision 指定了要写入的数字的最小位数。如果写入的值短于该数,结果会用前导零来填充。如果写入的值长于该数,结果不会被截断。精度为 0 意味着不写入任何字符。 对于 e、E 和 f 说明符:要在小数点后输出的小数位数。 对于 g 和 G 说明符:要输出的最大有效位数。 对于 s: 要输出的最大字符数。默认情况下,所有字符都会被输出,直到遇到末尾的空字符。 对于 c 类型:没有任何影响。 当未指定任何精度时,默认为 1。如果指定时不带有一个显式值,则假定为 0。
.* 精度在 format 字符串中未指定,但是会作为附加整数值参数放置于要被格式化的参数之前。
length(长度) 描述
h 参数被解释为短整型或无符号短整型(仅适用于整数说明符:i、d、o、u、x 和 X)。
l 参数被解释为长整型或无符号长整型,适用于整数说明符(i、d、o、u、x 和 X)及说明符 c(表示一个宽字符)和 s(表示宽字符字符串)。
ll 参数被解释为 long long int 或 unsigned long long int 类型(仅适用于整数说明符)。
L 参数被解释为长双精度型(仅适用于浮点数说明符:e、E、f、g 和 G)。
z 参数被解释为 ssize_t 或 size_t 类(仅适用于整数说明符)。
t 参数被解释为 ptrdiff_t 类(仅适用于整数说明符)。

例子

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

char* make_message(const char *fmt, ...) {
   int size = 0;
   char *p = NULL;
   va_list ap;

   // 利用截断,确定所需空间的大小
   va_start(ap, fmt);
   size = vsnprintf(p, size, fmt, ap);
   va_end(ap);

   if (size < 0)
       return NULL;

   size++;             /* For '\0' */
   p = (char*)malloc(size);
   if (p == NULL)
       return NULL;

   va_start(ap, fmt);
   size = vsnprintf(p, size, fmt, ap);
   if (size < 0) {
       free(p);
       return NULL;
   }
   va_end(ap);

   return p;
}

int main() {
  char *p;
  p = make_message("name=%s, age=%d\n", "ming", 1000);
  
  printf("%s\n", p);
  free(p);
}

参考:
https://www.runoob.com/cprogramming/c-function-printf.html

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!