> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/misc/fpgetround.3.md).

# fpgetround.3

`fpgetround` — IEEE 浮点接口

## 名称

`fpgetround`, `fpsetround`, `fpsetprec`, `fpgetprec`, `fpgetmask`, `fpsetmask`, `fpgetsticky`, `fpresetsticky`

## 概要

`#include <ieeefp.h>`

```c
typedef enum {
	FP_RN,		/* 就近舍入 */
	FP_RM,		/* 向负无穷向下舍入 */
	FP_RP,		/* 向正无穷向上舍入 */
	FP_RZ		/* 截断 */
} fp_rnd_t;
```

```c
fp_rnd_t fpgetround(void);
fp_rnd_t fpsetround(fp_rnd_t direction);
```

```c
typedef enum {
	FP_PS,		/* 24 位（单精度） */
	FP_PRS,		/* 保留 */
	FP_PD,		/* 53 位（双精度） */
	FP_PE		/* 64 位（扩展精度） */
} fp_prec_t;
```

```c
fp_prec_t fpgetprec(void);
fp_prec_t fpsetprec(fp_prec_t precision);
```

```c
#define fp_except_t	int
#define FP_X_INV	0x01	/* 无效操作 */
#define FP_X_DNML	0x02	/* 非规范 */
#define FP_X_DZ		0x04	/* 除零 */
#define FP_X_OFL	0x08	/* 溢出 */
#define FP_X_UFL	0x10	/* 下溢 */
#define FP_X_IMP	0x20	/* （不）精确 */
#define FP_X_STK	0x40	/* 栈故障 */
```

```c
fp_except_t fpgetmask(void);
fp_except_t fpsetmask(fp_except_t mask);
fp_except_t fpgetsticky(void);
fp_except_t fpresetsticky(fp_except_t sticky);
```

## 描述

此处描述的例程已弃用。新代码应使用 fenv(3) 提供的功能。

当检测到浮点异常时，会设置异常粘滞标志并测试异常掩码。如果掩码已设置，则发生陷阱。这些例程允许设置浮点异常掩码，并在检测到异常后重置异常粘滞标志。此外，它们还允许设置浮点舍入模式和精度。

`fpgetround` 函数返回当前的浮点舍入模式。

`fpsetround` 函数设置浮点舍入模式，并返回先前的模式。

`fpgetprec` 函数返回当前的浮点精度。

`fpsetprec` 函数设置浮点精度，并返回先前的精度。

`fpgetmask` 函数返回当前的浮点异常掩码。

`fpsetmask` 函数设置浮点异常掩码，并返回先前的掩码。

`fpgetsticky` 函数返回当前的浮点粘滞标志。

`fpresetsticky` 函数清除浮点粘滞标志，并返回先前的标志。

防止除零触发陷阱的示例代码：

```c
fpsetmask(~FP_X_DZ);
a = 1.0;
b = 0;
c = a / b;
fpresetsticky(FP_X_DZ);
fpsetmask(FP_X_DZ);
```

## 实现说明

`fpgetprec` 和 `fpsetprec` 函数提供了许多平台上不可用的功能。目前仅在 i386 和 amd64 平台上实现。更改精度不是受支持的功能：当代码编译为利用 SSE 时可能无效，并且许多库函数和编译器优化依赖于默认精度才能正确运行。

## 参见

fenv(3), isnan(3)

## 历史

这些例程基于 SysV/386 上同名例程。

## 注意事项

发生浮点异常后、设置掩码之前，必须重置粘滞标志。如果在粘滞标志重置之前又发生另一个异常，则可能发出错误的异常类型。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/man/misc/fpgetround.3.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.