C 库宏 - ERANGE
C 标准库 - <errno.h>描述
C 库宏 ERANGE 表示一个范围错误，它在输入参数超出数学函数定义的范围时发生，errno 被设置为 ERANGE。
ERANGE 是 C 标准库中的一个宏，定义在 <errno.h> 头文件中。它用于表示结果超出函数定义范围的错误，通常发生在数学函数和转换函数的计算结果超出可表示的范围时。
声明
下面是 ERANGE 宏的声明。
#define ERANGE some_value
参数
- NA
返回值
- NA
实例
以下是几个使用 ERANGE 的示例，演示如何处理结果超出范围的错误。
数学函数
在数学计算中，如 exp 或 log 函数，可能会发生 ERANGE 错误。例如，计算非常大的指数时，结果可能超出浮点数的表示范围。
实例
#include <stdio.h>
#include <math.h>
#include <errno.h>
int main() {
double x = 1000.0;
double result;
// 清除之前的错误
errno = 0;
// 调用 exp 函数，可能导致结果超出范围
result = exp(x);
if (errno == ERANGE) {
printf("Error: exp() result out of range for input value %f\n", x);
} else {
printf("The exp of %f is %f\n", x, result);
}
return 0;
}
#include <math.h>
#include <errno.h>
int main() {
double x = 1000.0;
double result;
// 清除之前的错误
errno = 0;
// 调用 exp 函数，可能导致结果超出范围
result = exp(x);
if (errno == ERANGE) {
printf("Error: exp() result out of range for input value %f\n", x);
} else {
printf("The exp of %f is %f\n", x, result);
}
return 0;
}
在这个示例中，计算 exp(1000.0) 可能导致结果超出范围，此时 errno 会被设置为 ERANGE。
让我们编译并运行上面的程序，这将产生以下结果：
The exp of 1000.000000 is inf
转换函数
在数值转换中，如 strtol 或 strtod 函数，如果转换结果超出目标类型的范围，errno 也会被设置为 ERANGE。
实例
#include <stdio.h>
#include <stdlib.h>
#include <errno.h>
#include <limits.h>
int main() {
const char *str = "99999999999999999999999999";
long result;
// 清除之前的错误
errno = 0;
// 调用 strtol 函数，可能导致结果超出范围
result = strtol(str, NULL, 10);
if (errno == ERANGE) {
printf("Error: strtol() result out of range for input string %s\n", str);
} else {
printf("The converted long value is %ld\n", result);
}
return 0;
}
#include <stdlib.h>
#include <errno.h>
#include <limits.h>
int main() {
const char *str = "99999999999999999999999999";
long result;
// 清除之前的错误
errno = 0;
// 调用 strtol 函数，可能导致结果超出范围
result = strtol(str, NULL, 10);
if (errno == ERANGE) {
printf("Error: strtol() result out of range for input string %s\n", str);
} else {
printf("The converted long value is %ld\n", result);
}
return 0;
}
在这个示例中，字符串 "99999999999999999999999999" 转换为 long 型数值时，结果超出 long 的表示范围，errno 会被设置为 ERANGE。
让我们编译并运行上面的程序，这将产生以下结果：
Error: strtol() result out of range for input string 99999999999999999999999999
使用注意事项
- 检查返回值：在调用可能产生范围错误的函数后，应检查返回值，通常这些函数在发生错误时返回特殊值（如
HUGE_VAL、HUGE_VALF、HUGE_VALL或0）。 - 初始化
errno：在调用函数前应将errno设置为 0，以确保错误码是由本次调用产生的，而不是之前的调用遗留的。 - 处理范围错误：当检测到
ERANGE错误时，应该根据上下文适当处理，例如打印错误消息、使用替代值或重新尝试计算。
相关函数和错误码
- 数学函数：如
exp,log,pow,sin,cos,tan，它们在计算结果超出表示范围时，可能会设置errno为ERANGE。 - 转换函数：如
strtol,strtoll,strtoul,strtoull,strtof,strtod,strtold，它们在转换结果超出表示范围时，可能会设置errno为ERANGE。
其他相关错误码
EDOM：表示数学函数的参数域错误，即参数超出了定义域。EILSEQ：表示非法字节序列错误，通常在处理多字节字符或宽字符时发生。
通过合理使用 errno、ERANGE 及其相关函数，可以编写出更为健壮和可靠的代码，确保在各种异常情况下程序仍能正常处理和响应。