__HAL_UART_GET_FLAG()

### STM32 HAL UART GET FLAG函数用法及示例

#### 函数概述
`__HAL_UART_GET_FLAG` 是用于获取指定UART标志位状态的宏定义。此宏通过读取特定寄存器中的相应位来判断当前UART的状态，例如传输完成、接收数据寄存器非空等。

该宏接受两个参数：一个是指向 `UART_HandleTypeDef` 结构体类型的指针；另一个是指定要检查的标志位枚举值。返回的结果是一个布尔值，表示所选标志位是否被置位[^1]。

#### 宏定义位置
通常情况下，在文件 `stm32f1xx_hal_uart.h` 或者对应系列的头文件中可以找到这个宏的具体实现方式。对于不同型号的MCU可能会有细微差别，因此建议查阅具体设备的手册或参考手册获得最准确的信息。

#### 使用示例
下面给出一段简单的代码片段展示如何利用 `__HAL_UART_GET_FLAG` 来监测USART1的数据接收情况：

#include "stm32f1xx_hal.h"

// 假设已经初始化好了一个名为 huart1 的 UART 句柄对象

if (__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXNE)) {
    // 当前存在可读取的新字符
    uint8_t receivedChar;
    HAL_UART_Receive(&huart1, &receivedChar, 1, HAL_MAX_DELAY);
}

在此例子中，程序会周期性地调用 `__HAL_UART_GET_FLAG` 检查是否有新的字节到达（即RXNE标志）。如果有新数据到来，则进一步执行实际的数据读取操作[^2]。