C 语言函数风格-我们为什么需要Posix

C 语言函数风格-我们为什么需要 Posix

引言

函数在众多变成语言中都是重要的概念。通过函数可以将一些列独立的功能封装为独立的模块，应用程序通过调用这些功能各异的函数来完成复杂的功能。
既然要调用函数，就一定要考虑函数的参数和返回值的问题。而根据定义函数时指定参数和返回值的方式，衍生出了一些常见的编程风格：

posix 风格

posix（Portable Operating System Interface of UNIX） 是一种API 编程标准的概称。这套标准为了解决日渐混乱的编程风格而生，目标是提高程序的兼容性和可移植性。其内容涉及 Unix 系统调用接口，shell 程序、文件、线程和网络编程等方面。

目前，linux\unix\Mac OS 都支持 Posix 标准，在 unix 上跑到程序可以很方便地在 MacOS 上运行起来，目前 Win10 也逐渐支持 Posix 标准。

该标准的定义可参考：http://www.unix.org/version3/online.html

典型的 posix 风格的函数是 linux 系统的文件 I/O 函数：

ssize_t read(int fd, void *buf, size_t count);
返回值：
1）成功：返回读到的字节数
2）0：到达文件末尾
3）-1：出错

再比如，大部分类 unix 系统中都使用 command -help 显示对应命令的说明帮助文档。

遵循 posix 风格的函数，其返回值通常标识该函数执行的结果，并且通常使用：0 表示成功或结束，非 0 表示失败或结果(GAI 风格与之类似)。其他的输出结果均使用函数参数来传递。函数向外传递参数的方法总结可参考如何获取函数内成员的值：

示例：

// 一个 posix 风格的函数
int32_t add(uint8_t a, uint8_t b, uint8_t *sum) {
	if (sum == NULL) {
		return -1；
	}
	uint16_t temp_sum = a + b;
	if(temp_sum > 0xff) {
		return -2;
	}
	*sum = temp_sum;
	return 0;
}

Uinx 风格

函数返回值包括错误原因，也包括要传递出函数的值。

// 一个 unix 风格的函数
int32_t add(uint8_t a, uint8_t b) {
	int32_t temp_sum = a + b;
	if(temp_sum > 0xff) {
		return -1;
	}
	return temp_sum;
}

为什么 posix 比较流行

posix 的流行是大家“投票”的结果，为了使程序设计风格一致，以及兼容性良好，大家都尽量地使用该标准，所以就流行起来了。
调用 posix 风格的 add 函数, 还可以方便地写出简洁的函数：

uint8_t a = 1, b =2, sum;
if（add(a, b, &sum)）{	// 相当于 if（add(a, b, &sum) == 0）
	printf("return error\r\n");
}

调用 unix 风格的 add 函数则不得不写的啰嗦一点：

uint8_t a = 1, b =2；
int32_t sum = 0;
sum = add (a, b);
if（sum < 0）{	
	printf("return error\r\n");
}

总结

posix 风格：为了兼容性而生，其返回值通常标识该函数执行的结果，并且通常使用：0 表示成功或结束，非 0 表示失败或结果。