简介：C库函数手册是C语言编程学习与实践中的关键工具，提供了对C标准库所有函数的详细解释。它覆盖了多个领域，包括输入输出、字符串处理、内存管理、数学运算、时间日期等，并针对每个函数提供用法说明、参数细节、返回值以及错误处理。此外，手册还包括对常见函数的使用示例，帮助开发者解决编程中的问题，提高编程效率和程序质量。 
1. C标准库函数概述
C标准库是C语言编程中不可或缺的一部分，它提供了一系列的函数来简化开发流程。本章节将概述C标准库的构成和功能，为之后深入讨论具体函数的使用与说明打下基础。
1.1 C标准库的结构
C标准库被分为多个头文件，每个头文件包含了一系列相关的函数。例如， stdio.h 包含了输入输出函数， string.h 包含了处理字符串的函数，等等。程序员可以根据需要包含相应的头文件来使用不同的功能。
1.2 标准库的功能与优势
C标准库提供了丰富的功能，如输入输出、内存管理、字符串处理等，极大地提高了编程效率和程序的可靠性。它还具有高度的可移植性，因为标准库函数在不同的平台上都有相同的接口和行为。
1.3 如何利用标准库
利用标准库进行开发时，需要熟悉各个函数的用法和参数，合理选择合适的函数以满足编程需求。在实践中，通过阅读官方文档、查看示例代码、编写测试程序来加深理解是非常重要的。
2. 输入输出函数使用与说明（stdio.h）
2.1 标准输入输出函数
2.1.1 printf和scanf的使用
在C语言中， printf 和 scanf 是标准输入输出库（stdio.h）中最常用的函数。它们分别用于格式化输出和输入数据。
printf 函数的基本语法为：
printf("格式化字符串", 参数1, 参数2, ...);
格式化字符串中包含了文本和格式说明符，这些说明符由一个 % 符号开始，如 %d 代表整数， %f 代表浮点数， %s 代表字符串等。参数紧跟在格式化字符串之后，每个参数对应格式化字符串中的一个格式说明符。
下面是一个简单的使用 printf 函数的例子：
#include <stdio.h>
int main() {
int num = 10;
double pi = 3.14159;
char* greeting = "Hello, World!";
printf("整数: %d\n", num);
printf("浮点数: %.2f\n", pi);
printf("字符串: %s\n", greeting);
return 0;
}
scanf 函数的基本语法为：
scanf("格式化字符串", 参数地址列表);
格式化字符串与 printf 类似，用于指定输入数据的格式。然而，重要区别在于 scanf 需要变量的地址（即指针）作为参数。这是因为 scanf 将输入的数据存储到这些地址所指向的变量中。
下面是使用 scanf 的一个简单例子：
#include <stdio.h>
int main() {
int num;
double pi;
char greeting[50];
printf("请输入一个整数: ");
scanf("%d", &num);
printf("您输入的整数是: %d\n", num);
printf("请输入一个浮点数: ");
scanf("%lf", &pi);
printf("您输入的浮点数是: %.2f\n", pi);
printf("请输入一个字符串: ");
scanf("%49s", greeting); // 限制输入长度防止溢出
printf("您输入的字符串是: %s\n", greeting);
return 0;
}
在使用 scanf 时特别需要注意防止缓冲区溢出。在上面的例子中，字符串的输入使用了 %49s ，这确保了最多只读取49个字符（加上字符串结束符 \0 ，共50个字符），避免了输入超过数组容量的风险。
2.1.2 文件读写函数
在C标准库中，文件的读写通过一系列的函数来完成，这些函数包括但不限于 fopen , fclose , fread , fwrite , fscanf , fprintf , fseek , ftell , 和 rewind 。这些函数允许程序创建、打开、读取、写入、移动以及关闭文件。
下面是一个使用文件读写函数的基本例子：
#include <stdio.h>
int main() {
FILE *fp;
int data = 12345;
char text[] = "Hello, File!";
// 打开文件用于写入，如果文件不存在则创建它
fp = fopen("example.txt", "w");
if (fp == NULL) {
printf("文件打开失败！\n");
return -1;
}
// 写入数据到文件
fprintf(fp, "%d\n", data);
fputs(text, fp);
// 关闭文件
fclose(fp);
// 重新打开文件用于读取
fp = fopen("example.txt", "r");
if (fp == NULL) {
printf("文件打开失败！\n");
return -1;
}
// 从文件读取数据
int number;
char buffer[50];
fscanf(fp, "%d", &number);
fgets(buffer, sizeof(buffer), fp);
printf("从文件读取的整数是: %d\n", number);
printf("从文件读取的字符串是: %s", buffer);
// 关闭文件
fclose(fp);
return 0;
}
在这个例子中，首先打开一个文件用于写入（ "w" 模式），如果文件不存在则创建它。然后写入一个整数和一个字符串到文件中。接着，文件被关闭，并重新以读取模式（ "r" 模式）打开。从文件中读取之前写入的整数和字符串，最后关闭文件。
文件操作是许多程序中必不可少的功能，对数据持久化提供了极大的便利。正确地打开、读取、写入和关闭文件是文件操作的基本步骤，也是保证数据完整性和安全性的关键。
2.2 高级文件操作
2.2.1 文件定位与随机访问
在文件操作中，有时候我们需要对文件指针进行定位，以便进行随机访问。 fseek 函数能够改变文件指针的位置， ftell 函数可以获取当前文件指针的位置，而 rewind 函数则可以将文件指针位置重置到文件的开头。
-
fseek函数的基本语法为：
fseek(FILE *stream, long int offset, int whence);
offset 指定从 whence 指定的位置偏移的字节数。 whence 可以取三个值： SEEK_SET （从文件开始处）， SEEK_CUR （从当前位置）， SEEK_END （从文件末尾）。
-
ftell函数的基本语法为：
long int ftell(FILE *stream);
它返回当前文件指针的位置。
-
rewind函数的基本语法为：
void rewind(FILE *stream);
它将文件指针移动到文件的开始位置。
下面是使用这些函数进行文件定位与随机访问的一个例子：
#include <stdio.h>
int main() {
FILE *fp;
long position;
// 打开文件用于读取和写入
fp = fopen("example.txt", "r+");
if (fp == NULL) {
printf("文件打开失败！\n");
return -1;
}
// 移动到文件末尾
fseek(fp, 0, SEEK_END);
position = ftell(fp);
printf("文件末尾的位置是: %ld\n", position);
// 移动到文件开头
rewind(fp);
// 读取并输出文件内容
char buffer[100];
while (fgets(buffer, sizeof(buffer), fp) != NULL) {
printf("%s", buffer);
}
// 移动到文件中某个特定位置
fseek(fp, 10, SEEK_SET); // 移动到文件的第10个字节位置
// 输出从当前位置到文件末尾的内容
position = ftell(fp);
printf("当前位置到文件末尾的内容：\n");
while ((position + sizeof(buffer)) < ftell(fp)) {
fseek(fp, sizeof(buffer), SEEK_CUR);
fgets(buffer, sizeof(buffer), fp);
printf("%s", buffer);
position = ftell(fp);
}
// 关闭文件
fclose(fp);
return 0;
}
在这个例子中，文件被打开进行读写操作。首先移动到文件末尾，获取当前指针的位置；然后使用 rewind 回到文件开头，读取并打印出整个文件内容。接着移动到文件的第10个字节位置，之后读取从当前位置到文件末尾的内容，并输出到控制台。
随机访问功能允许程序高效地处理大型文件，进行特定位置的数据读取和修改，避免了从头到尾的线性读取，提高了程序的性能和效率。
2.2.2 格式化输入输出
格式化输入输出是通过格式说明符来控制输入输出的数据格式。格式化输入输出在实际程序设计中十分常见，可以指定数据的宽度、精度、对齐方式等。
对于 printf 函数，格式说明符是这样的： - %d ：有符号十进制整数 - %u ：无符号十进制整数 - %f ：浮点数 - %e 或 %E ：科学记数法表示的浮点数 - %g 或 %G ： %f 或 %e 中较短的一种表示方法 - %c ：单个字符 - %s ：字符串 - %p ：指针的地址（通常以十六进制形式表示）
对于 scanf 函数，格式说明符和 printf 类似，但需要注意的是 scanf 在读取数据时是通过变量的地址来进行的，因此格式说明符之后通常要加上 & 符号，表示变量的地址。
例如，使用 printf 进行格式化输出：
#include <stdio.h>
int main() {
int integerVar = 10;
double doubleVar = 3.14;
char charVar = 'A';
char* stringVar = "Hello";
printf("整数: %d\n", integerVar);
printf("浮点数: %.2f\n", doubleVar);
printf("字符: %c\n", charVar);
printf("字符串: %s\n", stringVar);
return 0;
}
而使用 scanf 进行格式化输入：
#include <stdio.h>
int main() {
int integerVar;
double doubleVar;
char charVar;
char stringVar[20];
printf("请输入一个整数: ");
scanf("%d", &integerVar);
printf("您输入的整数是: %d\n", integerVar);
printf("请输入一个浮点数: ");
scanf("%lf", &doubleVar);
printf("您输入的浮点数是: %.2f\n", doubleVar);
printf("请输入一个字符: ");
scanf(" %c", &charVar); // 注意空格用于忽略前面的换行符
printf("您输入的字符是: %c\n", charVar);
printf("请输入一个字符串: ");
scanf("%19s", stringVar); // 限制输入长度
printf("您输入的字符串是: %s\n", stringVar);
return 0;
}
格式化输入输出是数据交互的重要方式，它不仅可以清晰地表达数据的类型和格式，而且在调试程序时也非常有用，有助于开发者更直观地查看和分析程序中的变量值。
2.3 标准I/O的优化与调试
2.3.1 I/O缓冲机制
C标准库的I/O操作默认是有缓冲的。这意味着数据并不是直接写入文件或从文件读取，而是存储在一个内存缓冲区中，达到一定条件后，缓冲区的内容才会被实际写入或读取。缓冲区的大小和管理方式依赖于所使用的平台和具体实现。
缓冲分为几种类型： - 全缓冲：缓冲区满时自动刷新（例如 stdout ，当缓冲区满时或在遇到换行符时刷新） - 行缓冲：遇到换行符或缓冲区满时刷新（例如 stdin ，在某些系统中） - 无缓冲：数据被直接写入或读取，不使用缓冲区（如错误流 stderr ）
在C标准库中，提供了 setvbuf 和 setbuf 函数来控制I/O缓冲机制，允许程序员手动设置缓冲区大小和类型。
例如，使用 setvbuf 设置全缓冲：
#include <stdio.h>
int main() {
FILE *fp;
char buffer[BUFSIZ]; // BUFSIZ通常是缓冲区大小的一个宏定义
fp = fopen("example.txt", "w");
if (fp == NULL) {
printf("文件打开失败！\n");
return -1;
}
// 设置全缓冲，BUFSIZ是标准库中定义的缓冲区大小
setvbuf(fp, buffer, _IOFBF, BUFSIZ);
// 向文件写入内容，实际内容将暂存于buffer缓冲区中
fprintf(fp, "缓冲区例子\n");
// 关闭文件
fclose(fp);
return 0;
}
在某些情况下，如果需要即时输出到文件或终端，可以使用 fflush 函数来强制刷新缓冲区。
例如，使用 fflush 强制刷新缓冲区：
#include <stdio.h>
int main() {
printf("即时输出的例子\n");
fflush(stdout); // 强制刷新标准输出缓冲区，输出内容到终端
return 0;
}
正确使用I/O缓冲可以提高程序的性能，尤其是在频繁进行小量数据输入输出时。例如，在进行大量的字符输出时，如果每次 printf 都直接写入文件，将会非常耗时。使用缓冲可以先将数据存储在缓冲区，待缓冲区满了或者程序结束时一次性写入，这样效率会更高。
2.3.2 错误处理与调试技巧
错误处理在C语言程序中非常重要，尤其是在进行文件I/O操作时。错误处理通常包括对文件操作返回值的检查，以及合理使用错误处理函数。
- 使用
errno和perror进行错误处理：errno是全局变量，用于存储错误代码。当标准库函数遇到错误时，通常会设置errno为特定的值。perror函数可以输出一个包含错误描述信息的字符串，这个字符串由strerror函数根据当前errno的值生成。
例如，错误处理的使用示例：
#include <stdio.h>
#include <errno.h>
#include <string.h>
int main() {
FILE *fp;
fp = fopen("no_such_file.txt", "r");
if (fp == NULL) {
perror("文件打开失败"); // 输出错误信息到标准错误输出
return -1;
}
// ... 其他操作 ...
// 关闭文件，检查是否成功
if (fclose(fp) != 0) {
perror("文件关闭失败"); // 输出错误信息到标准错误输出
return -1;
}
return 0;
}
在上面的例子中，当 fopen 函数因文件不存在而失败时， perror 被用来输出一个错误信息，它会将 errno 的值转换为人类可读的描述，并将其打印到标准错误输出流 stderr 。
- 使用
feclearexcept和fexceptflag进行浮点异常处理： 在进行浮点数运算时，可能会发生一些特殊的异常，例如除以零或溢出。feclearexcept用于清除当前线程的浮点异常状态，而fexceptflag用于存储或恢复浮点异常标志。
#include <stdio.h>
#include <fenv.h>
int main() {
feclearexcept(FE_ALL_EXCEPT); // 清除所有的浮点异常标志
// 潜在的浮点运算异常代码
// 例如除以零等操作
fexceptflag flg, flg2;
if (fegetexceptflag(&flg, FE_ALL_EXCEPT) == 0) {
if (flg & FE_DIVBYZERO) {
printf("发生了除以零的浮点异常！\n");
}
}
return 0;
}
调试技巧对于发现和修复程序中的错误至关重要。除了常规的编译器警告和运行时错误信息，还可以使用调试器工具，例如GDB，进行断点调试，单步执行和变量检查等。此外，代码审查和单元测试也是有效的调试手段。
I/O操作是程序与外界交互的重要途径，因此优化和调试I/O操作对于提高程序的健壮性和性能至关重要。合理使用错误处理和调试技术可以显著提升程序的可维护性和可靠性。
3. 字符串处理函数使用与说明（string.h）
3.1 字符串操作基础
在C语言中，字符串操作是经常执行的任务，从简单的复制连接到复杂的搜索和比较操作。这些功能都包含在标准库头文件 string.h 中。通过利用这些函数，可以有效地实现字符串相关的操作，提高代码的可读性和可维护性。
3.1.1 字符串复制与连接
复制和连接字符串是最基本的操作之一。 strcpy 和 strncpy 函数用于复制字符串，而 strcat 和 strncat 则用于连接字符串。
strcpy和strncpy的使用
strcpy 函数原型如下：
char *strcpy(char *dest, const char *src);
此函数将 src 指向的字符串复制到 dest 指向的内存区域中。重要的是 dest 指向的内存区域必须足够大以容纳 src 字符串的内容以及结尾的空字符 \0 。
char src[] = "Hello";
char dest[20];
strcpy(dest, src);
// dest现在包含 "Hello"
strncpy 函数可以指定最大复制字符数：
char *strncpy(char *dest, const char *src, size_t n);
这个函数将 src 字符串最多复制 n 个字符到 dest 。如果 src 长度小于 n ， dest 将被填充剩余的 n 个字符。如果 src 大于 n ， strncpy 不会自动添加空字符终止符。因此，使用 strncpy 时，程序员必须确保目标缓冲区正确终止。
strcat和strncat的使用
strcat 函数原型如下：
char *strcat(char *dest, const char *src);
此函数将 src 字符串追加到 dest 字符串的末尾，前提是 dest 有足够的空间。 strncat 函数则提供了一个额外的参数 n ，它指定 dest 中可用于追加的最大字符数：
char *strncat(char *dest, const char *src, size_t n);
使用时，确保 dest 有足够的空间以避免溢出。
3.1.2 字符串比较与搜索
字符串比较和搜索同样常用。比较函数如 strcmp 和 strncmp 用于比较两个字符串，而 strstr 用于在一个字符串中搜索另一个字符串。
strcmp和strncmp的使用
strcmp 函数原型：
int strcmp(const char *s1, const char *s2);
该函数比较两个字符串 s1 和 s2 ，如果它们相等，则返回0；如果 s1 大于 s2 ，则返回正值；如果 s1 小于 s2 ，则返回负值。
int result = strcmp("Hello", "Hello");
// result 为 0，因为两个字符串相等
strncmp 函数比较字符串的前 n 个字符。
strstr的使用
strstr 函数原型：
char *strstr(const char *haystack, const char *needle);
此函数在字符串 haystack 中查找第一次出现的字符串 needle ，如果找到了，返回 needle 在 haystack 中的指针；如果没有找到，则返回NULL。
char *pos = strstr("Hello World", "World");
// pos 不为 NULL，且指向 "World"
3.2 字符串转换与格式化
3.2.1 字符串与数字的转换
字符串和数字之间的转换在数据处理中很常见。例如，将用户输入的字符串转换为数值，或者将数值格式化为字符串输出。
数字转字符串
函数 sprintf 可以将数值类型（如整数、浮点数）格式化为字符串：
int sprintf(char *str, const char *format, ...);
int value = 123;
char buffer[20];
sprintf(buffer, "%d", value);
// buffer 包含 "123"
字符串转数字
对于将字符串转换为数字，可以使用 atoi （字符串转整数）和 atof （字符串转浮点数）：
int atoi(const char *str);
double atof(const char *str);
char *str = "123";
int num = atoi(str);
// num 为 123
3.2.2 字符串格式化输入输出
格式化字符串允许程序员按照指定的格式读取和输出字符串。 scanf 和 printf 是常用的格式化输入输出函数，他们同样可以用来处理字符串。
使用 scanf 读取字符串时，通常用 %s 格式说明符：
char str[10];
scanf("%9s", str); // 限制最大读取9个字符
注意 scanf 使用时的缓冲区溢出风险，使用 %9s 是为了避免缓冲区溢出。
使用 printf 输出字符串：
char str[] = "Hello World!";
printf("%s", str);
3.3 字符串处理的高级应用
3.3.1 安全的字符串操作
为了避免溢出等安全问题，推荐使用 strncpy 代替 strcpy ，使用 strncat 代替 strcat ，并总是检查目标缓冲区大小。
对于更安全的字符串操作，可以使用 strlcpy 和 strlcat （在某些系统中提供）。这两个函数原生限制复制的字节数，并确保总是有空字符终止。
3.3.2 字符编码转换函数
随着多语言处理的需求增加，字符编码转换变得尤为重要。在C标准库中， mbstowcs 和 wcstombs 函数可以分别用于转换多字节字符到宽字符字符串和宽字符字符串到多字节字符。
size_t mbstowcs(wchar_t *dest, const char *src, size_t n);
size_t wcstombs(char *dest, const wchar_t *src, size_t n);
这些函数允许将一个字符串从当前使用的多字节字符编码转换为宽字符编码，反之亦然。
在处理字符串时，合理利用标准库提供的函数，不仅能够提升代码的安全性，还能提高开发效率。通过深入了解每个函数的细节和正确使用，可以有效地提高程序的健壮性和性能。
4. 内存管理函数使用与说明（stdlib.h）
内存管理是C语言编程中的重要组成部分，stdlib.h 头文件中的函数为我们提供了进行内存分配、环境控制、程序执行以及数值转换等功能。这些功能都是应用程序在进行资源管理时不可或缺的工具。本章将详细解释stdlib.h提供的内存管理函数，并通过实际的代码示例来加深理解。
4.1 动态内存分配与释放
动态内存分配允许程序在运行时从系统请求内存，并在使用完毕后释放内存。这为程序提供了更高的灵活性。stdlib.h 中的 malloc、calloc、realloc 和 free 函数正是用来实现这一功能的。
4.1.1 malloc、calloc、realloc 和 free 的使用
这四个函数提供了基本的内存管理操作。malloc 用于分配内存，calloc 用于分配并初始化内存，realloc 用于调整已分配内存的大小，free 用于释放不再使用的内存。
示例代码：
#include <stdio.h>
#include <stdlib.h>
int main() {
int *p, *q;
int n = 10;
// 分配内存
p = (int*) malloc(n * sizeof(int));
if (p == NULL) {
fprintf(stderr, "Failed to allocate memory!\n");
return 1;
}
printf("Memory allocated for %d elements\n", n);
// 初始化内存
q = (int*) calloc(n, sizeof(int));
if (q == NULL) {
fprintf(stderr, "Failed to allocate memory!\n");
free(p); // 释放先前分配的内存
return 1;
}
printf("Memory initialized for %d elements\n", n);
// 调整内存大小
q = (int*) realloc(q, n * 2 * sizeof(int));
if (q == NULL) {
fprintf(stderr, "Failed to reallocate memory!\n");
free(p); // 释放先前分配的内存
return 1;
}
printf("Memory size successfully increased\n");
// 释放内存
free(q);
return 0;
}
逻辑分析： - malloc 的参数是需要分配的字节数。函数成功时返回指向分配的内存的指针，失败时返回 NULL。 - calloc 与 malloc 类似，但它接受两个参数：元素的数量和每个元素的大小，并且它将内存初始化为零。 - realloc 函数用来改变之前通过 malloc 或 calloc 分配的内存块的大小。如果新内存大小大于原始大小，剩余的内存部分将被初始化为零。 - free 函数接受一个指针作为参数，该指针必须是先前调用 malloc 、 calloc 或 realloc 的返回值，用于释放相应的内存区域。
4.1.2 内存分配失败的处理
当使用动态内存分配函数时，有时会因为各种原因（如内存不足）导致分配失败。因此，检查这些函数返回的指针是否为 NULL 是一种好的做法。
代码示例：
int* p = malloc(size);
if (p == NULL) {
// 分配失败，可以进行错误处理
perror("Memory allocation failed");
// 例如，记录日志、退出程序或尝试再次分配
exit(EXIT_FAILURE);
}
4.2 环境与程序控制
stdlib.h 头文件中还包含了一些用于环境变量处理和程序执行控制的函数。
4.2.1 环境变量的操作
getenv 函数用于获取环境变量的值。它接受一个以 null 结尾的字符串，该字符串表示环境变量的名称，并返回一个指向相关联值的指针，若找不到该环境变量，则返回 NULL。
4.2.2 程序的执行控制
system 函数可以用来执行一个给定的字符串所代表的命令，该字符串通常是一个系统命令。 exit 函数用来结束程序的执行，其参数是程序的返回状态码。
4.3 数值转换与排序函数
stdlib.h 头文件中也包含了一些用于数值转换和排序的函数。
4.3.1 字符串与数值类型的转换
atoi 、 atol 、 atof 等函数可以将字符串转换成整数、长整数和浮点数。它们的参数是一个代表数字的字符串，返回值是转换后的数值。
4.3.2 排序与搜索算法的实现
stdlib.h 提供了快速排序算法 qsort 和线性搜索算法 bsearch ，它们都可以用于处理数组数据。
在本章节中，详细解释了stdlib.h 中的内存管理函数，通过示例代码展示了它们的使用方法，并对代码执行逻辑进行了逐行分析。这种理解将有助于开发者在实际编程中避免常见的内存管理错误，确保程序的稳定性和效率。接下来，让我们继续深入探索字符串处理函数以及如何有效地使用它们。
5. 数学运算函数使用与说明（math.h）
5.1 基本数学函数
5.1.1 指数、对数与幂运算
在C标准库中，处理数学运算的函数大多位于math.h头文件中。开发者可以利用这些函数来执行各种数学计算，比如基本的指数、对数和幂运算。其中，指数函数 exp(x) 用于计算 e （自然对数的底数）的x次幂；对数函数 log(x) 用于计算以 e 为底的x的对数；幂运算函数 pow(x, y) 用于计算x的y次幂。
例如，以下代码展示了如何计算 e 的 2.71 次幂以及 10 的 5 次幂：
#include <stdio.h>
#include <math.h>
int main() {
double base_e = exp(1); // 计算e的1次幂
double power_of_10 = pow(10, 5); // 计算10的5次幂
printf("e^1 = %f\n", base_e);
printf("10^5 = %f\n", power_of_10);
return 0;
}
在上述代码中， exp 函数计算 e 的指数值，而 pow 函数则计算10的5次幂。每个函数调用后都会有对应的输出语句来显示结果。指数和对数函数对于涉及复利计算、科学数据分析等场景特别有用。
5.1.2 三角函数与反三角函数
C标准库中的三角函数和反三角函数允许程序员进行角度和弧度的三角运算。常用的三角函数包括 sin(x) 、 cos(x) 、 tan(x) ，分别计算弧度为x的角度的正弦、余弦、正切值。反三角函数如 asin(x) 、 acos(x) 、 atan(x) 则分别返回x的反正弦、反余弦和反正切值。
下面的示例代码展示了如何计算一个角度的正弦值以及反余弦值：
#include <stdio.h>
#include <math.h>
int main() {
double angle = M_PI / 4; // 45度，以弧度为单位
double sin_value = sin(angle); // 计算正弦值
double acos_value = acos(1 / sqrt(2)); // 计算反余弦值
printf("sin(45 degrees) = %f\n", sin_value);
printf("acos(1/sqrt(2)) = %f (in radians)\n", acos_value);
return 0;
}
在这段代码中，首先将角度转换为弧度，然后使用 sin 函数计算正弦值。反余弦值的计算则利用了三角恒等式。这些函数对物理模拟、几何计算、游戏开发等领域有着重要的作用。
5.2 复数运算
5.2.1 复数的表示与运算
C标准库对复数运算提供了支持，但是与数学中复数的表示略有不同。在C语言中，复数被表示为两个 double 类型的数，分别是实部和虚部。对于复数的运算，C提供了一系列的函数，如 creal(z) 和 cimag(z) 分别获取复数的实部和虚部， cabs(z) 计算复数的模。
示例代码展示了如何创建复数并获取其实部、虚部及模：
#include <stdio.h>
#include <complex.h> // 注意：math.h中的复数函数需要complex.h头文件
int main() {
double complex z = 3.0 + 4.0 * I; // 创建复数3+4i
double real_part = creal(z); // 获取复数的实部
double imag_part = cimag(z); // 获取复数的虚部
double magnitude = cabs(z); // 获取复数的模
printf("Complex number: %f + %fi\n", real_part, imag_part);
printf("Magnitude of z: %f\n", magnitude);
return 0;
}
在上述代码中，使用了 complex.h 库来处理复数运算，并演示了如何创建一个复数并获取其模。复数运算在电子工程、信号处理等领域是不可或缺的。
5.2.2 复数函数的使用
除了基本的获取实部、虚部和模值之外，C标准库还提供了对复数进行加减乘除等运算的函数，比如 cadd 、 csub 、 cmul 、 cdiv 等。此外，还有实现复数的幂次方和开方的函数，如 cpow 和 csqrt 。这些函数的使用方法与对应的实数运算函数类似。
下面的代码展示了复数的加法运算：
#include <stdio.h>
#include <complex.h>
int main() {
double complex z1 = 1.0 + 2.0 * I;
double complex z2 = 3.0 + 4.0 * I;
double complex z3 = cadd(z1, z2); // 复数加法
printf("Result of z1 + z2: %f + %fi\n", creal(z3), cimag(z3));
return 0;
}
在本例中，我们创建了两个复数 z1 和 z2 ，然后使用 cadd 函数进行加法运算。输出显示了加法运算的结果。复数函数的这些高级运算使得可以更方便地处理复数，适用于更复杂的数学和工程计算。
5.3 随机数生成与统计函数
5.3.1 随机数生成器的使用
随机数是程序设计中经常使用的工具，特别是在模拟、游戏和安全领域。C标准库中的 rand() 函数可以生成一个伪随机数，但是其提供的随机性并不高，因此在需要高质量随机数的场合，推荐使用 srand() 和 rand() 结合，或者使用更高级的随机数生成器如 random() 函数。
下面的示例代码演示了如何使用 srand() 和 rand() 生成随机数：
#include <stdio.h>
#include <stdlib.h>
#include <time.h>
int main() {
srand(time(NULL)); // 初始化随机数生成器
int random_number = rand(); // 生成一个随机数
printf("Random number between 0 and RAND_MAX: %d\n", random_number);
return 0;
}
在这段代码中，我们首先调用 srand() 函数来使用当前时间作为随机数生成器的种子。然后，我们调用 rand() 函数来生成一个随机数。 rand() 函数返回一个介于0到 RAND_MAX （一个在 stdlib.h 中定义的最大整数常量）之间的随机数。
5.3.2 概率分布与统计计算
C标准库还提供了生成符合特定概率分布的随机数的函数，如 rand_r() ，它提供一个简单的线程安全随机数生成器。此外， drand48() 、 erand48() 、 lrand48() 和 nrand48() 函数用于生成[0.0, 1.0]区间内的随机数，它们使用线性同余生成算法。
统计计算方面，C标准库提供了基本的统计函数，如计算平均值和标准差。然而，它们不是直接包含在math.h中，而是可以根据需要实现，或者使用更专业的数学或统计库。
在使用随机数和统计函数时，重要的是了解它们的限制和适用场合。例如，对于涉及安全性的应用，需要更复杂的随机数生成策略来避免可预测性。
至此，第五章的内容涵盖了C标准库中数学运算函数的使用和说明，包括基本的指数、对数、幂运算，三角函数和反三角函数，以及复数运算和随机数生成器的使用。通过上述内容，读者应该可以掌握C语言中处理数学运算的基础知识和常用方法，以及如何在实际开发中应用这些函数。
6. 时间日期函数使用与说明（time.h）
时间与日期的处理是任何现代软件系统中不可或缺的一部分。无论是记录日志事件、计算时间间隔、设置时区还是格式化日期，C标准库中的 time.h 头文件提供了一整套功能丰富的接口来完成这些任务。
6.1 时间日期的表示与操作
在 C 语言中，时间通常通过 time_t 类型表示，它是一个用于记录日历时间的整数类型。 time.h 头文件定义了 struct tm ，这是一个包含年、月、日、时、分、秒等信息的结构体，用于表示分解的本地时间。
6.1.1 时间结构体tm与时间戳
struct tm 提供了一个方便的接口来处理本地时间。它包括以下字段：
-
int tm_sec;：表示秒，范围为 0 到 59（60 或 61 用于闰秒） -
int tm_min;：表示分钟，范围为 0 到 59 -
int tm_hour;：表示小时，范围为 0 到 23 -
int tm_mday;：表示一月中的日子，范围为 1 到 31 -
int tm_mon;：表示月份，范围为 0 到 11（0 代表一月） -
int tm_year;：表示自 1900 年以来的年数 -
int tm_wday;：表示一周中的日子，范围为 0 到 6（0 代表周日） -
int tm_yday;：表示一年中的日子，范围为 0 到 365 -
int tm_isdst;：表示夏令时是否生效，值大于 0 时为真，等于 0 时为假，小于 0 时为不确定
时间戳是一个 time_t 类型的值，表示从 1970 年 1 月 1 日 UTC 开始的秒数。这个表示方法也被称为 Unix 时间戳。
以下是使用 time() 函数获取当前时间戳的例子：
#include <stdio.h>
#include <time.h>
int main() {
time_t now;
time(&now);
printf("Current time: %s", ctime(&now)); // ctime() converts time_t to string
return 0;
}
此代码片段首先声明一个 time_t 类型的变量 now ，然后使用 time() 函数填充它。 ctime() 函数用于将 time_t 值转换成易于阅读的字符串格式。
6.1.2 时间的获取与设置
time.h 还提供了其他函数用于操作时间和日期：
-
double difftime(time_t time1, time_t time0);：返回两个时间之间的差异（秒数）。 -
struct tm *gmtime(const time_t *time);：将time_t值转换为世界协调时间（UTC）的struct tm。 -
struct tm *localtime(const time_t *time);：将time_t值转换为本地时间的struct tm。
#include <stdio.h>
#include <time.h>
int main() {
time_t now;
struct tm *local, *utc;
time(&now);
local = localtime(&now);
utc = gmtime(&now);
printf("Local Time: %02d-%02d-%02d %02d:%02d:%02d\n",
local->tm_year + 1900, local->tm_mon + 1, local->tm_mday,
local->tm_hour, local->tm_min, local->tm_sec);
printf("UTC Time: %02d-%02d-%02d %02d:%02d:%02d\n",
utc->tm_year + 1900, utc->tm_mon + 1, utc->tm_mday,
utc->tm_hour, utc->tm_min, utc->tm_sec);
return 0;
}
此代码显示了如何获取并打印本地时间与 UTC 时间。
6.2 时间日期的计算与格式化
C 语言提供了工具来计算时间间隔和格式化日期/时间输出。
6.2.1 时间间隔的计算
mktime() 函数接受 struct tm ，并返回 time_t 值。它通常用于计算特定时间的秒数表示。
#include <stdio.h>
#include <time.h>
int main() {
struct tm when;
time_t time;
/* Set the tm structure to represent November 18, 2023, 3:15 PM */
when.tm_year = 123; // year since 1900
when.tm_mon = 10; // 0-based months (0-11)
when.tm_mday = 18; // day of month
when.tm_hour = 15; // hour (0-23)
when.tm_min = 15; // minute (0-59)
when.tm_sec = 0; // second (0-59)
when.tm_isdst = -1; // don't know if DST applies
time = mktime(&when);
if (time == (time_t)-1) {
perror("mktime");
return 1;
}
printf("The time is: %s", ctime(&time));
return 0;
}
此代码设置了一个特定的日期和时间，然后通过 mktime() 转换为 time_t 形式。
6.2.2 时间格式化输出
strftime() 函数提供了一个强大的方式来格式化日期和时间。它接受一个 struct tm 并产生一个格式化的字符串。
#include <stdio.h>
#include <time.h>
int main() {
char buffer[80];
struct tm *tp;
time_t t;
time(&t);
tp = localtime(&t);
strftime(buffer, sizeof(buffer), "%Y-%m-%d %H:%M:%S", tp);
printf("Formatted time: %s\n", buffer);
return 0;
}
这段代码使用 localtime() 获取当前本地时间，并使用 strftime() 函数按照指定的格式输出。
6.3 时区与本地化处理
处理时区是时间日期功能的重要部分，确保时间计算和格式化能够适应不同的地理位置和时间标准。
6.3.1 时区的设置与获取
对于多时区的支持，C 标准库提供了 timezone 和 _daylight 全局变量。然而，它们并不完全通用，建议使用 tzset() 和 localtime() 函数来处理时区。
-
void tzset(void);：根据环境变量TZ初始化时区信息。 -
struct tm *localtime(const time_t *time);：将time_t值转换为本地时间。
#include <stdio.h>
#include <time.h>
int main() {
char *tz = getenv("TZ");
if (tz == NULL) {
tz = "UTC"; // default timezone
}
printf("Current timezone: %s\n", tz);
tzset(); // Set timezone based on TZ environment variable
time_t now = time(NULL);
struct tm *local = localtime(&now);
printf("Local time in timezone %s: %s", tz, asctime(local));
return 0;
}
这个例子首先获取当前的 TZ 环境变量，然后使用 tzset() 初始化时区信息，最终使用 localtime() 和 asctime() 打印出当前的本地时间。
6.3.2 本地化信息的管理
本地化涉及到如何按照不同区域习惯显示日期、时间、货币等信息。C 标准库使用 setlocale() 函数来管理本地化信息。
-
char *setlocale(int category, const char *locale);：设置或查询当前的区域设置。
#include <stdio.h>
#include <locale.h>
int main() {
setlocale(LC_ALL, ""); // Use user's default locale settings
// Output current date and time, formatted according to locale
printf("Current date and time in local format: %s\n", asctime(localtime(&time(NULL))));
return 0;
}
这段代码设置了程序的本地化设置，以使得日期和时间的输出格式符合用户的默认本地设置。
在本章中，我们探讨了 time.h 头文件所提供的功能，包括如何使用时间结构体和时间戳，以及如何格式化和计算时间。我们还研究了如何处理时区和本地化信息。这些基础概念和示例将帮助您在自己的程序中实现对时间的精细控制和优雅处理。
7. 错误处理与代码（errno.h）与其他辅助功能函数说明
7.1 错误处理机制
7.1.1 错误码的定义与获取
在C语言中，错误处理是一个核心组成部分。标准库提供了一套机制来报告和处理错误。每个错误状态都有一个唯一的错误码，它是一个通过宏定义的正整数，每个宏都有一个以 E 开头，后面跟有描述性文字的名称。例如，当一个库函数无法完成其任务时，它通常返回一个特定的负值，并将错误码设置为一个相应的值。
在程序中，通常使用 perror() 函数来打印一个系统错误消息，它基于当前的 errno 值来输出对应的错误描述信息。下面是 perror() 函数的基本用法：
#include <stdio.h>
#include <errno.h>
int main() {
errno = ENOENT; // 设置errno为文件不存在的错误码
perror("File error"); // 输出错误信息
return 0;
}
7.1.2 错误处理的实践技巧
正确地处理错误可以提高程序的健壮性和用户体验。实践中，你可以通过检查返回值来判断函数是否成功执行，并根据 errno 的值来进行相应的错误处理。下面是一个处理可能错误的示例：
#include <stdio.h>
#include <errno.h>
#include <stdlib.h>
void myFunction() {
// 假设函数myFunction在某些情况下可能会失败
if (someCondition) {
errno = EINVAL; // 设置错误码为“无效参数”
return;
}
// 正常处理逻辑
}
int main() {
myFunction();
if (errno != 0) {
// 如果errno不为0，则说明发生了错误
perror("Error in myFunction");
} else {
printf("myFunction succeeded!\n");
}
return 0;
}
错误处理通常与日志记录、异常抛出和错误重试等机制相结合使用，以便更有效地诊断和解决问题。
7.2 辅助功能函数
7.2.1 断言与诊断（assert.h）
assert.h 头文件中定义的宏 assert() 用于程序中增加诊断断言。当断言失败时，它将打印一条错误消息并终止程序。这通常用于检查不应该发生的条件，帮助开发者发现程序中的逻辑错误。
下面是一个使用 assert() 的示例代码：
#include <assert.h>
#include <stdio.h>
int divide(int numerator, int denominator) {
assert(denominator != 0); // 断言分母不为0
return numerator / denominator;
}
int main() {
printf("%d\n", divide(10, 0)); // 断言失败，程序终止并打印消息
return 0;
}
7.2.2 可变参数处理（stdarg.h）
可变参数函数是一种可以接受可变数量的参数的函数。 stdarg.h 头文件提供了一组宏，允许开发者编写可以接受可变参数的函数，如 printf() 和 scanf() 。
使用可变参数的函数至少需要一个固定参数，后跟省略号表示可变参数。一个简单的例子如下：
#include <stdarg.h>
#include <stdio.h>
void printNumbers(int count, ...) {
va_list args;
va_start(args, count); // 初始化参数列表
for (int i = 0; i < count; i++) {
int value = va_arg(args, int); // 逐个访问参数
printf("%d\n", value);
}
va_end(args); // 清理资源
}
int main() {
printNumbers(3, 1, 2, 3); // 输出1, 2, 3
return 0;
}
7.2.3 非局部跳转（setjmp.h）
setjmp.h 头文件中的 setjmp() 和 longjmp() 函数提供了非局部跳转的功能。它们允许从一个函数跳转到另一个函数中预先设置的跳转点，绕过了正常的函数调用栈规则。
下面是如何使用 setjmp() 和 longjmp() 的示例：
#include <setjmp.h>
#include <stdio.h>
jmp_buf jump_buffer;
void secondFunction() {
printf("Jumping back...\n");
longjmp(jump_buffer, 1); // 返回到setjmp()设置的点
}
int main() {
if (setjmp(jump_buffer) == 0) {
printf("First call\n");
secondFunction(); // 第二次调用时，从这里返回
} else {
printf("Back to main()\n");
}
return 0;
}
7.2.4 信号处理（signal.h）
信号处理是操作系统级别的功能，用于响应异步事件。 signal.h 头文件提供了控制程序对信号的响应方式的函数。最常用的函数是 signal() ，用于设置一个特定信号的处理程序。
下面是一个使用信号处理的简单例子：
#include <signal.h>
#include <stdio.h>
void signalHandler(int signal) {
printf("Received signal: %d\n", signal);
}
int main() {
signal(SIGINT, signalHandler); // 设置SIGINT信号的处理函数为signalHandler
printf("Press Ctrl+C to send SIGINT\n");
while (1) {
// 主循环
}
return 0;
}
7.3 手册目录的结构与功能
7.3.1 函数索引与分类
标准库手册通常按照不同的功能进行分类，例如输入/输出、字符串处理、数学运算等。每个函数都有一个唯一的名称，并且通常都有一个简短的描述，说明其用途、参数、返回值和可能的错误条件。这些信息对开发者来说是宝贵的资源，有助于快速找到所需的信息。
7.4 函数的详细描述与示例代码
7.4.1 函数参数与返回值详细说明
每个标准库函数的文档通常会详细介绍其参数类型和返回值。理解这些细节对于正确使用函数至关重要。例如， strlen() 函数返回一个字符串的长度，不包括结尾的空字符 '\0' 。该函数的原型如下：
size_t strlen(const char *str);
7.4.2 实际代码示例与使用场景
为了更好地理解如何在实际项目中使用标准库函数，查看示例代码是一个很好的实践。例如，使用 atoi() 函数将字符串转换为整数的示例：
#include <stdlib.h>
#include <stdio.h>
int main() {
char *str = "12345";
int number = atoi(str);
printf("The integer value of '%s' is %d.\n", str, number);
return 0;
}
以上代码演示了如何从字符串转换为整数的基本用法。在实际应用中，应结合错误检查机制，以处理可能的输入错误，如 str 不指向有效数字。
简介：C库函数手册是C语言编程学习与实践中的关键工具，提供了对C标准库所有函数的详细解释。它覆盖了多个领域，包括输入输出、字符串处理、内存管理、数学运算、时间日期等，并针对每个函数提供用法说明、参数细节、返回值以及错误处理。此外，手册还包括对常见函数的使用示例，帮助开发者解决编程中的问题，提高编程效率和程序质量。
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
