2024-06-06 C语言结构体成员变量位域(bit-field)的使用，它允许我们有效地利用数据存储空间，将多个逻辑上相关的小数据放在同一个字节中

一、看下面C语言的结构体

struct lcd_data
{
    char abc[8];
	int  w;
	int  h;
    unsigned char   api;
    unsigned char   mipi:1;
    unsigned char   type:3;
	unsigned char   usb:1;

	unsigned int ret;
	unsigned int v;

}__attribute__((packed));

二、在这个结构体定义中，unsigned char type:3;定义了一个位域成员 type，其类型为 unsigned char，占用 3 个位(bit)。

type 的宽度为 3 位，因为它后面紧跟着冒号和数字 3，这表示该成员变量只占用 3 个位。这种语法被称为位域(bit-field)，它允许我们有效地利用数据存储空间，将多个逻辑上相关的小数据放在同一个字节中。

在这个结构体中，type 的位域宽度为 3，意味着它可以存储的数值范围是 0 到 7（2^3 - 1）。根据具体的应用场景，这 3 位可以用来表示不同的状态、类型或者标志位等信息。

三、运行下面的测试代码，   可以发现mipi 和 type是共用在一个字节里面。

#include <stdlib.h>
#include <stddef.h>
#include <stdio.h>
#include <string.h>


void printStructHex(const void *ptr, size_t size) {
    const unsigned char *byte = (const unsigned char *)ptr;
    for (size_t i = 0; i < size; i++) {
        printf("%02x ", byte[i]);
        if ((i + 1) % 16 == 0) { // 每16字节换行，更易读
            printf("\n");
        }
    }
    printf("\n");
}

struct lcd_data
{
    char abc[8];
	int  w;
	int  h;
    unsigned char   api;
    unsigned char   mipi:1;
    unsigned char   type:3;
	unsigned char   usb:1;

	unsigned int ret;
	unsigned int v;

}__attribute__((packed));
 
int main()
{
    struct lcd_data m_lcd_data;
	
    memset(&m_lcd_data,0,sizeof(struct lcd_data));
	printf("********* m_lcd_data.api = 0xE9 m_lcd_data.type=0x03*********\n");
	m_lcd_data.api = 0xE9;
    m_lcd_data.type = 0x03;

    printStructHex(&m_lcd_data, sizeof(m_lcd_data));

    printf("*********m_lcd_data.api = 0xE9 m_lcd_data.type=0x03 m_lcd_data.mipi=1*********\n");
	m_lcd_data.mipi=1;
    printStructHex(&m_lcd_data, sizeof(m_lcd_data));
    
    return(0);
}

四、执行下面的测试代码，如果给3位域的type赋值0xFF编译的时候会报warning，实际也是只占3位，最大是等于7.

	memset(&m_lcd_data,0,sizeof(struct lcd_data));
    printf("m_lcd_data.type=%d\n",m_lcd_data.type);
    m_lcd_data.type=0xFF;
    printf("m_lcd_data.type=%d\n",m_lcd_data.type);
    printStructHex(&m_lcd_data, sizeof(m_lcd_data));