2. 传入参数与传出参数
如果函数接口有指针参数，既可以把指针所指向的数据传给函数使用（称为传入参数），也可以由函数填充指针所指的内存空间，传回给调用者使用（称为传出参数），例如 strcpy 的 src 参数是传入参数， dest 参数是传出参数。有些函数的指针参数同时担当了这两种角色，如 select(2) 的 fd_set * 参数，既是传入参数又是传出参数，这称为 Value-result 参数。
**表 24.1. 传入参数示例： void func(const unit_t *p); **
| 调用者 | 实现者 |
|---|---|
| 分配 p 所指的内存空间在 p 所指的内存空间中保存数据调用函数由于有 const 限定符，调用者可以确信 p 所指的内存空间不会被改变 | 规定指针参数的类型 unit_t *读取 p 所指的内存空间 |
想一想，如果有函数接口 void func(const int p); 这里的 const 有意义吗？
**表 24.2. 传出参数示例： void func(unit_t *p); **
| 调用者 | 实现者 |
|---|---|
| 分配 p 所指的内存空间调用函数读取 p 所指的内存空间 | 规定指针参数的类型 unit_t *在 p 所指的内存空间中保存数据 |
**表 24.3. Value-result 参数示例： void func(unit_t *p); **
| 调用者 | 实现者 |
|---|---|
| 分配 p 所指的内存空间在 p 所指的内存空间保存数据调用函数读取 p 所指的内存空间 | 规定指针参数的类型 unit_t *读取 p 所指的内存空间改写 p 所指的内存空间 |
由于传出参数和 Value-result 参数的函数接口完全相同，应该在文档中说明是哪种参数。
以下是一个传出参数的完整例子：
例 24.2. 传出参数
/* populator.h */
#ifndef POPULATOR_H
#define POPULATOR_H
typedef struct {
int number;
char msg[20];
} unit_t;
extern void set_unit(unit_t *);
#endif
/* populator.c */
#include <string.h>
#include "populator.h"
void set_unit(unit_t *p)
{
if (p == NULL)
return; /* ignore NULL parameter */
p->number = 3;
strcpy(p->msg, "Hello World!");
}
/* main.c */
#include <stdio.h>
#include "populator.h"
int main(void)
{
unit_t u;
set_unit(&u);
printf("number: %d\nmsg: %s\n", u.number, u.msg);
return 0;
}
很多系统函数对于指针参数是 NULL 的情况有特殊规定：如果传入参数是 NULL 表示取缺省值，例如 pthread_create(3) 的 pthread_attr_t * 参数，也可能表示不做特别处理，例如 free 的参数；如果传出参数是 NULL 表示调用者不需要传出值，例如 time(2) 的参数。这些特殊规定应该在文档中写清楚。