跟涛哥一起学嵌入式 29：为什么很多人编程喜欢用 typedef？

雨点打透心脏的1/2处 2023-07-11 06:22 10阅读 0赞

# 1. typedef 的基本使用 #

# #

## 1.1 typedef与结构体的结合使用 ##

typedef 是 C 语言的一个关键字，用来给某个类型起个别名，也就是给C语言中已经存在的一个类型起一个新名字。大家在阅读代码的过程中，会经常见到 typedef 与结构体、联合体、枚举、函数指针声明结合使用。比如下面结构体类型的声明和使用：

struct student
    {
        char name[20];
        int  age;
        float score;
    };
    struct student stu = {"wit", 20, 99};

在C语言中定义一个结构体变量，我们通常的写法是：

struct 结构体名 变量名;

前面必须有一个struct关键字打前缀，编译器才会理解你要定义的对象是一个结构体变量。而在C++语言中，则不需要这么做，直接使用：结构体名 变量名就可以了

struct student 
    {
        char name[20];
        int age;
        float score; 
    };
    int main (void)
    {
        student stu = {"wit", 20, 99};
        return 0;
    }

如果我们使用typedef，就可以给student声明一个别名student\_t和一个结构体指针类型student\_ptr，然后就可以直接使用student\_t类型去定义一个结构体变量，不用再写struct，这样会显得代码更加简洁。

#include <stdio.h>
    typedef struct student
    {
        char name[20];
        int  age;
        float score;
    }student_t, *student_ptr;
    
    int main (void)
    {
        student_t   stu = {"wit", 20, 99};
        student_t  *p1 = &stu;
        student_ptr p2 = &stu;
        printf ("name: %s\n", p1->name);
        printf ("name: %s\n", p2->name); 
        return 0;
    }
    程序运行结果：
    wit
    wit

# #

## 1. 2 typedef 与数组的结合使用 ##

typedef除了与结构体结合使用外，还可以与数组结合使用。定义一个数组，通常我们使用int array\[10\];即可。我们也可以使用typedef先声明一个数组类型，然后再使用这个类型去定义一个数组。

typedef int array_t[10]; 
    array_t array;
    int main (void)
    {
        array[9] = 100;
        printf ("array[9] = %d\n", array[9]);
        return 0;
    }

在上面的demo程序中，我们声明了一个数组类型array\_t，然后再使用该类型定义一个数组array，这个array效果其实就相当于：int array\[10\]。

# #

## 1.3 typedef 与指针的结合使用 ##

typedef char * PCHAR;
    int main (void)
    {
        //char * str = "学嵌入式，到宅学部落";
        PCHAR str = "学嵌入式，到宅学部落";
        printf ("str: %s\n", str);
        return 0;
    }

在上面的demo程序中，PCHAR 的类型是 char \*，我们使用PCHAR类型去定义一个变量str，其实就是一个char \*类型的指针。

# #

## 1.4 typedef与函数指针的结合使用 ##

定义一个函数指针，我们通常采用下面的形式：

int (*func)(int a, int b);

我们同样可以使用typedef声明一个函数指针类型：func\_t

typedef int (*func_t)(int a, int b);
    func_t fp;  // 定义一个函数指针变量

写个简单的程序测试一下，运行OK：

typedef int (*func_t)(int a, int b);
    int sum (int a, int b)
    {
    	return a + b;
    } 
    int main (void)
    {
    	func_t fp = sum;
    	printf ("%d\n", fp(1,2));
    	return 0;
    }

为了增加程序的可读性，我们经常在代码中看到下面的声明形式：

typedef int (func_t)(int a, int b);
    func_t *fp = sum;

函数都是有类型的，我们使用typedef给函数类型声明一个新名称：func\_t。这样声明的好处是：即使你没有看到func\_t的定义，也能够清楚地知道fp是一个函数指针，代码的可读性比上面的好。

# #

## 1.5 typedef与枚举的结合使用 ##

typedef enum color
    {
    	red,
    	white,
    	black,
    	green,
    	color_num,
    } color_t;
    
    int main (void)
    {
    	enum color color1 = red;
    	color_t    color2 = red;
    	color_t color_number = color_num;
    	printf ("color1: %d\n", color1);
    	printf ("color2: %d\n", color2);
    	printf ("color num: %d\n", color_number);
    	return 0;
    }

枚举与typedef的结合使用方法跟结构体类似：可以使用typedef给枚举类型color声明一个新名称color\_t，然后使用这个类型就可以直接定义一个枚举变量。

# 2. 使用typedef的优势 #

不同的项目，有不同的代码风格，也有不同的代码“癖好”。看得代码多了，你会发现：有的代码喜欢用宏，有的代码喜欢使用typedef。那么，使用typedef到底有哪些好处呢？为什么很多人喜欢用它呢？

# #

## 2.1 可以让代码更加清晰简洁 ##

typedef struct student
    {
    	char name[20];
    	int  age;
    	float score;
    }student_t, *student_ptr;
    
    student_t   stu = {"wit", 20, 99};
    student_t  *p1 = &stu;
    student_ptr p2 = &stu;

如前面的示例代码所示，使用typedef，我们可以在定义一个结构体、联合、枚举变量时，省去关键字struct，让代码更加简洁。

# #

## 2.2 增加代码的可移植性 ##

C语言的int类型，我们知道，在不同的编译器和平台下，所分配的存储字长不一样：可能是2个字节，可能是4个字节，也有可能是8个字节。如果我们在代码中想定义一个固定长度的数据类型，此时使用int，在不同的平台环境下运行可能会出现问题。为了应付各种不同“脾气”的编译器，最好的办法就是使用自定义数据类型，而不是使用C语言的内置类型。

#ifdef PIC_16
    typedef  unsigned long U32
    #else
    typedef unsigned int U32  
    #endif

在16位的 PIC 单片机中，int一般占2个字节，long占4个字节，而在32位的ARM环境下，int和long一般都是占4个字节。如果我们在代码中想使用一个32位的固定长度的无符号类型，可以使用上面方式声明一个U32的数据类型，在代码中你可以放心大胆地使用U32。将代码移植到不同的平台时，直接修改这个声明就可以了。

在Linux内核、驱动、BSP 等跟底层架构平台密切相关的源码中，我们会经常看到这样的数据类型，如size\_t、U8、U16、U32。在一些网络协议、网卡驱动等对字节宽度、大小端比较关注的地方，也会经常看到typedef使用得很频繁。

# #

## 2.3 比宏定义更好用 ##

C语言的预处理指令\#define用来定义一个宏，而typedef则用来声明一种类型的别名。typedef跟宏相比，不仅仅是简单的字符串替换，可以使用该类型同时定义多个同类型对象。

typedef char* PCHAR1;
    #define PCHAR2 char *
    
    int main (void)
    {
    	PCHAR1 pch1, pch2;
    	PCHAR2 pch3, pch4;
    	printf ("sizeof pch1: %d\n", sizeof(pch1));
    	printf ("sizeof pch2: %d\n", sizeof(pch2));
    	printf ("sizeof pch3: %d\n", sizeof(pch3));
    	printf ("sizeof pch4: %d\n", sizeof(pch4));
    	return 0;
    }

在上面的示例代码中，我们想定义4个指向char类型的指针变量，然而运行结果却是：

sizeof pch1: 4
    sizeof pch2: 4
    sizeof pch3: 4
    sizeof pch4: 1

本来我们想定义4个指向char类型的指针，但是 pch4 经过预处理宏展开后，就变成成了一个字符型变量，而不是一个指针变量。而 PCHAR1 作为一种数据类型，在语法上其实就等价于相同类型的类型说明符关键字，因此可以在一行代码中同时定义多个变量。上面的代码其实就等价于：

char *pch1, *pch2;
    char *pch3, pch4;

# #

## 2.4 让复杂的指针声明更加简洁 ##

一些复杂的指针声明，如：函数指针、数组指针、指针数组的声明，往往很复杂，可读性差。比如下面函数指针数组的定义：

int *(*array[10])(int *p, int len, char name[]);

上面的指针数组定义，很多人一瞅估计就懵逼了。我们可以使用typedef优化一下：先声明一个函数指针类型func\_ptr\_t，接着再定义一个数组，就会更加清晰简洁，可读性就增加了不少：

typedef int *(*func_ptr_t)(int *p, int len, char name[]);
    func_ptr_t array[10];

# 3. 使用typedef需要注意的地方 #

通过上面的示例代码，我们可以看到，使用typedef可以让我们的代码更加简洁、可读性更强一些。但是typedef也有很多坑，稍微不注意就可能翻车。下面分享一些使用typedef需要注意的一些细节。

# #

## 3.1 typedef在语法上等价于关键字 ##

我们使用typedef给已知的类型声明一个别名，其在语法上其实就等价于该类型的类型说明符关键字，而不是像宏一样，仅仅是简单的字符串替换。举一个例子大家就明白了，比如const和类型的混合使用：当const和常见的类型(如：int、char) 一同修饰一个变量时，const和类型的位置可以互换。但是如果类型为指针，则const和指针类型不能互换，否则其修饰的变量类型就发生了变化，如常见的指针常量和常量指针：

char b = 10;
    char c = 20;
    int main (void)
    {	
    	char const *p1 = &b; //常量指针：*p1不可变，p1可变
    	char *const p2 = &b; //指针常量：*p2可变，p2不可变	
    	p1  = &c; //编译正常 
    	*p1 = 20; //error: assignment of read-only location	
    	p2  = &c; //error: assignment of read-only variable`p2'
    	*p2 = 20; //编译正常
    	return 0;
    }

当typedef 和 const一起去修饰一个指针类型时，与宏定义的指针类型进行比较：

typedef char* PCHAR2;
    #define PCHAR1 char * 
    char b = 10;
    char c = 20;
    int main (void)
    {	
    	const PCHAR1 p1 = &b;
    	const PCHAR2 p2 = &b;
    	p1  = &c; //编译正常 
    	*p1 = 20; //error: assignment of read-only location	
    	p2  = &c; //error: assignment of read-only variable`p2'
    	*p2 = 20; //编译正常
    	return 0;
    }

运行程序，你会发现跟上面的示例代码遇到相同的编译错误，原因在于宏展开仅仅是简单的字符串替换：

const PCHAR1 p1 = &b; //宏展开后是一个常量指针
    const char * p1 = &b; //其中const与类型char的位置可以互换

而在使用PCHAR2定义的变量p2中，PCHAR2作为一个类型，位置可与const互换，const修饰的是指针变量p2的值，p2的值不能改变，是一个指针常量，但是\*p2的值可以改变。

const PCHAR2 p2 = &b; //PCHAR2此时作为一个类型，与const可互换位置
    PCHAR2 const p2 = &b; //该语句等价于上条语句
    char * const p2 = &b; //const和PCHAR2一同修饰变量p2，const修饰的是p2！

# #

## 3.2 typedef是一个存储类关键字 ##

没想到吧，typedef在语法上是一个存储类关键字！跟常见的存储类关键字(如：auto、register、static、extern)一样，在修饰一个变量时，不能同时使用一个以上的存储类关键字，否则编译会报错：

typedef static char * PCHAR;
    //error: multiple storage classes in declaration of `PCHAR'

# #

## 3.3 typedef 的作用域 ##

跟宏的全局性相比，typedef作为一个存储类关键字，是有作用域的。使用typedef声明的类型跟普通变量一样遵循作用域规则：包括代码块作用域、文件作用域等。

typedef char CHAR;
    
    void func (void)
    {
    	#define PI 3.14
    	typedef short CHAR;
    	printf("sizeof CHAR in func: %d\n",sizeof(CHAR)); 
    }
    
    int main (void)
    {	
    	printf("sizeof CHAR in main: %d\n",sizeof(CHAR));
    	func();
    	typedef int CHAR;
    	printf("sizeof CHAR in main: %d\n",sizeof(CHAR));
    	printf("PI:%f\n", PI);	
    	return 0;
    }

宏定义在预处理阶段就已经替换完毕，是全局性的，只要保证引用它的地方在定义之后就可以了。而使用typedef声明的类型则跟普通变量一样遵循作用域规则。上面代码的运行结果为：

sizeof CHAR in main: 1
    sizeof CHAR in func: 2
    sizeof CHAR in main: 4
    PI:3.140000

# 4 如何避免typedef的滥用？ #

通过上面的学习我们可以看到：使用typedef可以让我们的代码更加简洁、可读性更好。在实际的编程中，越来越多的人也开始尝试使用typedef，甚至到了“过犹不及”的滥用地步：但凡遇到结构体、联合、枚举都要用个typedef封装一下，不用就显得你low、你菜、你的代码没水平。

其实typedef也有副作用，不一定非得处处都用它。比如上面我们封装的STUDENT类型，当你定义一个变量时：

STUDENT stu;

不看STUDENT的声明，你知道stu的含义吗？未必吧。而如果我们直接使用struct定义一个变量，则会更加清晰，让你一下子就知道stu是个结构体类型的变量：

struct  student stu;

一般来讲，当遇到以下情形时，使用typedef可能会有用，否则可能会适得其反：

*  创建一个新的数据类型
 *  跨平台的指定长度的类型：如U32/U16/U8
 *  跟操作系统、BSP、网络字宽相关的数据类型：如size\_t、pid\_t等
 *  不透明的数据类型：需要隐藏结构体细节，只能通过函数接口访问的数据类型

在阅读Linux内核源码过程中，你会发现大量使用了typedef，哪怕是简单的int、long都使用了typedef。这是因为：Linux内核源码发展到今天，已经支持了太多的平台和CPU架构，为了保证数据的跨平台性和可移植性，所以很多时候不得已使用了typedef，对一些数据指定固定长度：如U8/U16/U32等。但是内核也不是到处到滥用，什么时候该用，什么不该用，也是有一定的规则要遵循的，具体大家可以看kernel Document中的 CodingStyle 中关于typedef的使用建议。

专注嵌入式、Linux、C语言精品教程。

请关注公众号：宅学部落，嵌入式技术QQ群：宅学部落

加作者微信：brotau