总览

函数声明	函数功能
`void *sbrk(intptr_t increment);`	它是一个 `Unix` 系统的函数，用于调整程序的堆空间。
`double scalb(double x, double n);`	计算 x 乘以 2 的 n 次幂（double）
`float scalbf(float x, float n);`	计算 x 乘以 2 的 n 次幂（float）
`long double scalbl(long double x, double n);`	计算 x 乘以 2 的 n 次幂（long double）
`double scalbln(double x, long int n);`	计算 x 乘以 2 的指定长整数 n 次幂（double）
`float scalblnf(float x, long int n);`	计算 x 乘以 2 的指定长整数 n 次幂（float）
`long double scalblnl(long double x, long int n);`	计算 x 乘以 2 的指定长整数 n 次幂（long double）
`double scalbn(double x, int n);`	计算 x 乘以 2 的指定整数 n 次幂（double）
`float scalbnf(float x, int n);`	计算 x 乘以 2 的指定整数 n 次幂（float）
`long double scalbnl(long double x, int n);`	计算 x 乘以 2 的指定整数 n 次幂（long double）
`int scanf(const char *format, ...);`	从标准输入中读取指定格式的数据
`void sector( int x, int y, int stangle, int endangle, int xradius, int yradius );`	画并填充椭圆扇区（Windows BGI）
`void segread(struct SREGS *sregs);`	它是一个 `DOS` 函数，用于从内存段（`segment`）中读取内容。
`void setactivepage(int pagenum);`	用于切换当前显示的页面
`void setallpalette(struct palettetype *palette);`	用于设置图形界面的整个调色板
`void setaspectratio( int xasp, int yasp );`	设置图形纵横比
`void setbkcolor(int color);`	用于设置当前绘图窗口的背景色
`void setbuf(FILE stream, char buffer);`	用于设置标准输入流、标准输出流或标准错误流的缓冲方式
`void setcolor(int color);`	设置当前绘图颜色
`void setfillpattern(char *upattern, int color);`	用于设置当前绘图窗口的填充图案
`void setfillstyle(int pattern, int color);`	用于设置当前绘图窗口的填充样式，即用什么颜色或图案来填充绘制的图形
`void setgraphmode(int mode);`	设置当前的图形模式
`int setjmp(jmp_buf env);`	用于在程序执行过程中设置跳转点，并将当前程序状态保存到一个缓冲区中。当程序需要从该跳转点继续执行时，可以使用 longjmp() 函数恢复之前保存的程序状态并返回到该跳转点。

1. sbrk

1.1 函数说明

函数声明	函数功能
`void *sbrk(intptr_t increment);`	它是一个 `Unix` 系统的函数，用于调整程序的堆空间。

参数：

increment ： 增加的堆空间的大小

返回值：

如果调用成功，返回值即为增加空间前的原始堆顶指针；
如果出错，则返回 (void *)-1

1.2 演示示例

#include <unistd.h>
#include <stdio.h>

int main() {
    void *mem = sbrk(64);

    if (mem == (void *)-1) {
        perror("sbrk");
        return 1;
    }

    printf("Allocated 64 bytes at address %p\n", mem);

    return 0;
}

在上述示例中，

首先调用 sbrk() 函数将堆顶位置向上移动 64 字节；
然后将返回的指针保存在变量 mem 中；如果 sbrk 调用失败（即返回值等于 (void *)-1），则程序通过 perror() 函数输出错误信息并返回 1；
最后，程序打印出分配的内存地址，并返回 0 表示程序成功运行。

2. scalb，scalbf，scalbl

2.1 函数说明

函数声明	函数功能
`double scalb(double x, double n);`	计算 x 乘以 2 的 n 次幂（double）
`float scalbf(float x, float n);`	计算 x 乘以 2 的 n 次幂（float）
`long double scalbl(long double x, double n);`	计算 x 乘以 2 的 n 次幂（long double）

注意：如果 n 超过了可表示的范围，或者结果溢出，则函数可能返回正无穷大、负无穷大或 NaN。

2.2 演示示例

#include <stdio.h>
#include <math.h>

int main() {
    double x = 3.14159265359;
    double y = scalb(x, 10);

    printf("Before: %lf\n", x);
    printf("After: %lf\n", y);

    return 0;
}

3. scalbln，scalblnf，scalblnl

3.1 函数说明

函数声明	函数功能
`double scalbln(double x, long int n);`	计算 x 乘以 2 的指定长整数 n 次幂（double）
`float scalblnf(float x, long int n);`	计算 x 乘以 2 的指定长整数 n 次幂（float）
`long double scalblnl(long double x, long int n);`	计算 x 乘以 2 的指定长整数 n 次幂（long double）

3.2 演示示例

#include <stdio.h>
#include <math.h>

int main() {
    double x = 1.5;
    float y = 2.25f;
    long double z = 3.75l;
    long int n = 3;
    // 将x乘以2的3次幂
    double result = scalbln(x, n);
    printf("scalbln(%lf, %ld) = %lf\n", x, n, result);

    float resultf = scalblnf(y, n);
    printf("scalblnf(%f, %ld) = %f\n", y, n, resultf);

    long double resultL = scalblnl(z, n);
    printf("scalblnl(%Lf, %ld) = %Lf", z, n, resultL);

    return 0;
}

3.3 运行结果

4. scalbn，scalbnf，scalbnl

4.1 函数说明

函数声明	函数功能
`double scalbn(double x, int n);`	计算 x 乘以 2 的指定整数 n 次幂（double）
`float scalbnf(float x, int n);`	计算 x 乘以 2 的指定整数 n 次幂（float）
`long double scalbnl(long double x, int n);`	计算 x 乘以 2 的指定整数 n 次幂（long double）

4.2 演示示例

#include <stdio.h>
#include <math.h>

int main()
{
    double x = 3.1415926;
    float y = 3.1415926f;
    long double z = 3.1415926L;
    int n = 5;

    printf("scalbn(%lf, %d) = %.20lf\n", x, n, scalbn(x, n));
    printf("scalbnf(%f, %d) = %.20f\n", y, n, scalbnf(y, n));
    printf("scalbnl(%Lf, %d) = %.20Lf\n", z, n, scalbnl(z, n));

    return 0;
}

4.3 运行结果

5. scanf

5.1 函数说明

函数声明	函数功能
`int scanf(const char *format, ...);`	从标准输入中读取指定格式的数据

详细内容可参考《scanf》

5.2 演示示例

#include <stdio.h>
#include <math.h>

int main()
{
    char name[20];

    scanf("%s", name);

    printf("Welcome, %s", name);

    return 0;
}

在上述示例中，实现了从标准输入中读取一个字符串，并输出欢迎消息。

我们首先定义一个名为 name 的字符数组，长度为 20；
然后使用 scanf() 函数从标准输入中读取一个字符串，存储到 name 数组中；
最后使用 printf() 函数输出欢迎消息，其中 %s 表示字符串格式化符号，会被 name 所代替。

5.3 运行结果

6. sector

6.1 函数说明

函数声明	函数功能
`void sector( int x, int y, int stangle, int endangle, int xradius, int yradius );`	画并填充椭圆扇区（Windows BGI）

参数：

x ： 扇形的圆心坐标的 x 轴
y ： 扇形的圆心坐标的 y 轴
stangle ： 起始角度（以度数为单位）
endangle ： 结束角度（以度数为单位）
xradius ： 横向半径
yradius ： 纵向半径

6.2 演示示例

#include <graphics.h>

int main(void)
{
   int gdriver = DETECT, gmode;
   int midx, midy, i;
   int stangle = 45, endangle = 135;
   int xrad = 100, yrad = 50;

   initgraph(&gdriver, &gmode, "");

   midx = getmaxx() / 2;
   midy = getmaxy() / 2;

   for (i=EMPTY_FILL; i<USER_FILL; i++)
   {
      setfillstyle(i, getmaxcolor());

      sector(midx, midy, stangle, endangle, xrad, yrad);

      getch();
   }

   closegraph();
   return 0;
}

6.3 运行结果

7. segread

7.1 函数说明

函数声明	函数功能
`void segread(struct SREGS *sregs);`	它是一个 `DOS` 函数，用于从内存段（`segment`）中读取内容。

7.2 演示示例

#include <dos.h>
#include <stdio.h>

int main() {
    struct SREGS regs;
    segread(&regs);  // 读取段寄存器的值
    printf("Data segment: %04X\n", regs.ds);
    printf("Code segment: %04X\n", regs.cs);
    printf("Stack segment: %04X\n", regs.ss);
    return 0;
}

上述的这个示例程序，使用了 <dos.h> 头文件中的 segread() 函数和 struct SREGS 结构体，并打印出数据段（DS）、代码段（CS）和堆栈段（SS）的值。

8. setactivepage

8.1 函数说明

函数声明	函数功能
`void setactivepage(int pagenum);`	用于切换当前显示的页面

8.2 演示示例

#include <graphics.h>

int main(void)
{
   int gdriver = EGA, gmode = EGAHI;
   int x, y, ht;

   initgraph(&gdriver, &gmode, "");

   x = getmaxx() / 2;
   y = getmaxy() / 2;
   ht = textheight("W");

   setactivepage(1);

   line(0, 0, getmaxx(), getmaxy());

   settextjustify(CENTER_TEXT, CENTER_TEXT);
   outtextxy(x, y, "This is page #1:");
   outtextxy(x, y+ht, "Press any key to halt:");

   setactivepage(0);

   outtextxy(x, y, "This is page #0.");
   outtextxy(x, y+ht, "Press any key to view page #1:");
   getch();

   setvisualpage(1);

   getch();
   closegraph();
   return 0;
}

上述示例将在屏幕上绘制两个页面，并允许用户通过按任意键查看第二个页面。

8.3 运行结果

9. setallpallette

9.1 函数说明

函数声明	函数功能
`void setallpalette(struct palettetype *palette);`	用于设置图形界面的整个调色板

参数：

palette ： 调色版结构体

9.2 演示示例

#include <graphics.h>
#include <stdlib.h>
#include <stdio.h>
#include <conio.h>

int main(void)
{
    int gdriver = DETECT, gmode;
    struct palettetype pal, copypal;
    int color, ht;
    int y = 10;
    char msg[80];

    initgraph(&gdriver, &gmode, "");

    ht = 2 * textheight("W");

    getpalette(&pal);

    for (color = 1; color <= MAXCOLORS; color++)
    {
        sprintf(msg, "old colors[%d]: %d", color, pal.colors[color]);
        outtextxy(1, y, msg);
        y += ht;
    }

    for (color = 1; color <= MAXCOLORS; color++)
    {
        setpalette(color, BLACK);
    }

    getpalette(&copypal);

    getch();

    y = 10;
    for (color = 1; color <= MAXCOLORS; color++)
    {
        sprintf(msg, "new colors[%d]: %d", color, copypal.colors[color]);
        outtextxy(150, y, msg);
        y += ht;
    }

    getch();
    // 重置调色板
    setallpalette(&pal);

    getpalette(&pal);

    y = 10;
    for (color = 1; color <= MAXCOLORS; color++)
    {
        sprintf(msg, "old colors[%d]: %d", color, pal.colors[color]);
        outtextxy(300, y, msg);
        y += ht;
    }

    getch();
    closegraph();
    return 0;
}

9.3 运行结果

10. setaspectratio

10.1 函数说明

函数声明	函数功能
`void setaspectratio( int xasp, int yasp );`	设置图形纵横比

参数：

xasp ： 水平缩放比例
yasp ： 垂直缩放比例

10.2 演示示例

#include <graphics.h>

int main()
{
    int gd = DETECT, gm;
    initgraph(&gd, &gm, "");

    // 设置水平和垂直缩放比例为 2:1
    setaspectratio(2, 1);

    // 在图形窗口中绘制一个正方形
    rectangle(100, 100, 200, 200);

    getch();
    closegraph();
    return 0;
}

注意： 因为 BGI 图形库在 Windows 上的实现是基于 Win32 API 的简单封装，并且没有提供缩放功能，所以上述程序在 Windows BGI 下不支持缩放功能，也就是 setaspectratio 没有效果。

11. setbkcolor

11.1 函数说明

函数声明	函数功能
`void setbkcolor(int color);`	用于设置当前绘图窗口的背景色

参数：

color ： 要设置的颜色，预定义颜色有如下：

颜色值	英文枚举	中文描述
0	BLACK	黑
1	BLUE	蓝
2	GREEN	绿
3	CYAN	青
4	RED	红
5	MAGENTA	洋红
6	BROWN	棕
7	LIGHTGRAY	淡灰
8	DARKGRAY	深灰
9	LIGHTBLUE	淡兰
10	LIGHTGREEN	淡绿
11	LIGHTCYAN	淡青
12	LIGHTRED	淡红
13	LIGHTMAGENTA	淡洋红
14	YELLOW	黄
15	WHITE	白

11.2 演示示例

#include <graphics.h>

int main()
{
    int gd = DETECT, gm;
    initgraph(&gd, &gm, "");

    // 设置背景色为蓝色
    setbkcolor(BLUE);

    // 清除先前绘制的图形
    cleardevice();

    // 在图形窗口中绘制一条线段
    line(100, 100, 200, 200);

    getch();
    closegraph();
    return 0;
}

注意： 在修改背景颜色后，需要使用 cleardevice() 函数清除先前绘制的图形并更新背景颜色，不然背景颜色的修改不会生效。

11.3 运行结果

12. setbuf

12.1 函数说明

函数声明	函数功能
`void setbuf(FILE stream, char buffer);`	用于设置标准输入流、标准输出流或标准错误流的缓冲方式

参数：

FILE *stream : 目标文件流指针（如 stdin, stdout, stderr 或 fopen() 返回的指针）。必须指向已打开的文件流。
char *buffer : 缓冲区指针。
- 若传递有效缓冲区地址：使用该缓冲区作为流的缓存
- 若传递 NULL：禁用缓冲

12.2 演示示例

#include <stdio.h>

int main()
{
    FILE *fp;

    // 打开文件，并设置为不带缓冲
    fp = fopen("test.txt","w");
    setbuf(fp, NULL);

    // 写入数据到文件中
    fprintf(fp, "This is a line of text.");

    // 关闭文件
    fclose(fp);

    return 0;
}

在上述这个示例程序中，我们打开了一个名为 test.txt 的文件，并使用 setbuf() 函数将其设置为不带缓冲。然后，我们向文件中写入一行文本，关闭文件并退出程序。

由于我们已经将文件设置为不带缓冲，因此写入的数据将直接写入磁盘，而不会在内存中留下缓冲区。

12.3 运行结果

13. setcolor

13.1 函数说明

函数声明	函数功能
`void setcolor(int color);`	设置当前绘图颜色

参数：

color ： 要设置的颜色，预定义颜色有如下：

颜色值	英文枚举	中文描述
0	BLACK	黑
1	BLUE	蓝
2	GREEN	绿
3	CYAN	青
4	RED	红
5	MAGENTA	洋红
6	BROWN	棕
7	LIGHTGRAY	淡灰
8	DARKGRAY	深灰
9	LIGHTBLUE	淡兰
10	LIGHTGREEN	淡绿
11	LIGHTCYAN	淡青
12	LIGHTRED	淡红
13	LIGHTMAGENTA	淡洋红
14	YELLOW	黄
15	WHITE	白

13.2 演示示

#include <graphics.h>

int main()
{
    int gd = DETECT, gm;
    initgraph(&gd, &gm, "");

    setbkcolor(WHITE);

    cleardevice();

    // 设置绘画颜色为红色
    setcolor(RED);

    // 在图形窗口中绘制一条直线
    line(100, 100, 200, 200);

    getch();
    closegraph();
    return 0;
}

13.3 运行结果

14. setfillpattern

14.1 函数说明

函数声明	函数功能
`void setfillpattern(char *upattern, int color);`	用于设置当前绘图窗口的填充图案

参数：

upattern ： 填充图案
color ： 填充颜色

在调用 setfillpattern() 函数之前，需要先定义一个名为 upattern 的字符数组，并将其用作填充图案。这个图案通常使用一个 8 字节的字节数组表示，每个元素包含一个 8 比特位的掩码，用于表示该位置是否应该被绘制斜线或其他样式。

14.2 演示示例

#include <graphics.h>

int main(void)
{
    int gdriver = DETECT, gmode;
    int maxx, maxy;

    char pattern[8] = {0x00, 0x70, 0x20, 0x27, 0x24, 0x24, 0x07, 0x00};

    // 初始化图形模式
    initgraph(&gdriver, &gmode, "");

    // 获取屏幕的最大 X 和 Y 坐标
    maxx = getmaxx();
    maxy = getmaxy();

    // 设置当前颜色为最大颜色值
    setcolor(getmaxcolor());

    // 设置填充图案
    setfillpattern(pattern, getmaxcolor());

    // 用填充图案填满整个窗口
    bar(0, 0, maxx, maxy);

    // 等待用户按下任意键后关闭窗口
    getch();
    closegraph();

    return 0;
}

上述程序使用了 Windows BGI 图形库来创建一个空白的图形窗口，并在其中填充一种斜线筛子图案。

何为斜线筛子图案，参考如下程序打印：

#include <stdio.h>

int main() {
    char pattern[8] = {0x00, 0x70, 0x20, 0x27, 0x24, 0x24, 0x07, 0x00};

    for (int i = 0; i < 8; i++) {
        for (int j = 0; j < 8; j++) {
            if (pattern[i] & (1 << (7 - j))) {
                printf("*");
            } else {
                printf(" ");
            }
        }
        printf("\n");
    }

    return 0;
}

14.3 运行结果

15. setfillstyle

15.1 函数说明

函数声明	函数功能
`void setfillstyle(int pattern, int color);`	用于设置当前绘图窗口的填充样式，即用什么颜色或图案来填充绘制的图形

参数：

pattern ： 填充样式
color ： 填充颜色

如下是支持的填充样式：

填充样式值	英文枚举	中文描述
0	`EMPTY_FILL`	空填充（无填充）
1	`SOLID_FILL`	实心填充
2	`LINE_FILL`	横线填充
3	`LTSLASH_FILL`	细斜线填充（左斜）
4	`SLASH_FILL`	粗斜线填充（左斜）
5	`BKSLASH_FILL`	粗反斜线填充（右斜）
6	`LTBKSLASH_FILL`	细反斜线填充（右斜）
7	`HATCH_FILL`	网格阴影填充
8	`XHATCH_FILL`	交叉网格填充
9	`INTERLEAVE_FILL`	交错线填充
10	`WIDE_DOT_FILL`	稀疏点状填充
11	`CLOSE_DOT_FILL`	密集点状填充
12	`USER_FILL`	用户自定义填充模式

setfillstyle() 函数还支持使用用户自定义的填充样式。如果要使用用户自定义的填充样式，需要调用 setuserchars() 函数来设置填充字形，然后将填充样式参数设置为 USER_FILL。

15.2 演示示例

#include <graphics.h>

int main()
{
    int gd = DETECT, gm;
    initgraph(&gd, &gm, "");

    // 设置填充样式为斜线筛子图案，颜色为红色
    setfillstyle(SLASH_FILL, RED);

    // 在图形窗口中填充一个矩形
    rectangle(100, 100, 200, 200);
    floodfill(150, 150, getmaxcolor());

    getch();
    closegraph();
    return 0;
}

在上述的示例程序中，

我们首先使用 setfillstyle() 函数将填充样式设置为斜线筛子图案（即 SLASH_FILL 样式），颜色设置为红色。
然后，我们使用 rectangle() 函数在图形窗口中绘制一个矩形，并使用 floodfill() 函数将该矩形填充为红色的斜线筛子图案。
最后按任意键退出图形模式。

15.3 运行结果

16. setgraphmode

16.1 函数说明

函数声明	函数功能
`void setgraphmode(int mode);`	设置当前的图形模式

16.2 演示示例

#include <graphics.h>
#include <stdlib.h>
#include <stdio.h>

int main(void)
{
    int gdriver = DETECT, gmode;
    int x, y;

    initgraph(&gdriver, &gmode, "");

    x = getmaxx() / 2;
    y = getmaxy() / 2;

    settextjustify(CENTER_TEXT, CENTER_TEXT);
    outtextxy(x, y, "Press any key to exit graphics:");
    getch();

    // 将图形模式恢复到文本模式
    restorecrtmode();
    printf("We're now in text mode.\n");
    printf("Press any key to return to graphics mode:");
    getch();

    // 返回图形模式
    setgraphmode(getgraphmode());

    settextjustify(CENTER_TEXT, CENTER_TEXT);
    outtextxy(x, y, "We're back in graphics mode.");
    outtextxy(x, y+textheight("W"), "Press any key to halt:");

    getch();
    closegraph();
    return 0;
}

16.3 运行结果

17. setjmp

17.1 函数说明

函数声明	函数功能
`int setjmp(jmp_buf env);`	用于在程序执行过程中设置跳转点，并将当前程序状态保存到一个缓冲区中。当程序需要从该跳转点继续执行时，可以使用 longjmp() 函数恢复之前保存的程序状态并返回到该跳转点。

参数：

env ： 要保存程序状态的缓冲区，通常声明为 jmp_buf 类型

返回值：
setjmp() 函数返回 0，除非它是从 longjmp() 函数调用返回的，这种情况下，它返回非零值。

17.2 演示示例

#include <stdio.h>
#include <setjmp.h>

jmp_buf buf;

void foo()
{
    printf("foo() before longjmp()\n");
    longjmp(buf, 1);
    printf("foo() after longjmp()\n");
}

int main()
{
    int ret = setjmp(buf);

    if (ret == 0) {
        printf("main() before foo()\n");
        foo();
    } else {
        printf("main() after longjmp()\n");
    }

    return 0;
}

在上述的示例程序中，

我们首先定义了一个名为 buf 的 jmp_buf 类型的缓冲区，并将其作为参数传递给 setjmp() 函数，当前程序状态将保存到 buf 缓冲区中，并返回一个整形，用 ret 变量存储；此时 ret 的值为 0，则说明是第一次调用 setjmp() 函数，主函数内打印输出 ”main() before foo()“
然后我们调用 foo() 函数，打印输出 ”foo() before longjmp()“；
接着调用 longjmp() 函数，将会返回到 setjmp() 函数调用的位置，并传递了一个值 1。因为 longjmp() 调用一定会返回 setjmp() 函数调用的位置，因此 foo() 函数的后面一行代码永远不会被执行。
最后 setjmp() 函数返回 ret 的值为 1，则说明是从 longjmp() 函数中返回的，主函数内打印输出 ”main() after longjmp()“。

17.3 运行结果

参考

[API Reference Document]

总览

函数声明	函数功能
`int raise(int sig);`	用于向当前进程发送指定的信号。
`int rand(void);`	用于生成伪随机数
`ssize_t read(int fd, void *buf, size_t count);`	用于从文件描述符读取数据的函数。
`void realloc(void ptr, size_t size);`	用于重新分配已经分配过内存的空间大小。
`void rectangle( int left, int top, int right, int bottom);`	画一个矩形
`int registerbgidriver(void(*driver)(void));`	用于将BGI（Borland Graphics Interface）驱动程序注册到系统中
`int remove(char *filename);`	用于删除指定的文件
`int rename(char oldname, char newname);`	用于重命名或移动文件。
`void restorecrtmode(void);`	将图形模式恢复到文本模式
`void rewind(FILE *stream);`	将文件指针 `stream` 指向的文件位置重置为文件开头，同时清除任何错误或文件结束标志。
`int rmdir(const char *path);`	用于删除一个空目录，即该目录必须为空。
`double round(double x);`	将传入的实数参数 `x` 四舍五入为最接近的整数（double）
`float roundf(float x);`	将传入的实数参数 `x` 四舍五入为最接近的整数（float）
`long double roundl(long double x);`	将传入的实数参数 `x` 四舍五入为最接近的整数（long double）
`double remainder(double x, double y);`	用于计算两个浮点数的余数（即模运算结果）（double）
`float remainderf (float x, float y );`	用于计算两个浮点数的余数（即模运算结果）（float）
`long double remainderl (long double x, long double y);`	用于计算两个浮点数的余数（即模运算结果）（long double）
`double remquo(double x, double y, int *quo);`	用于计算两个浮点数的余数，并返回商和余数。
`float remquof(float x, float y, int *quo);`	用于计算两个浮点数的余数，并返回商和余数。
`long double remquol(long double x, long double y, int *quo);`	用于计算两个浮点数的余数，并返回商和余数。
`double rint(double x);`	将 x 四舍五入到最接近的整数（double）
`float rintf(float x);`	将 x 四舍五入到最接近的整数（float）
`long double rintl(long double x);`	将 x 四舍五入到最接近的整数（long double）

1. raise

1.1 函数说明

函数声明	函数功能
`int raise(int sig);`	用于向当前进程发送指定的信号。

参数：

sig ： 指定要发送的信号编号

返回值：

如果调用成功，raise() 函数将返回 0；
否则，它将返回一个非零值。

1.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <signal.h>

void sigint_handler(int sig) {
    printf("Caught signal %d\n", sig);
    exit(0);
}

int main() {
    signal(SIGINT, sigint_handler);

    while (1) {
        printf("Doing something...\n");
        getchar();
        // check for interrupt signal
        raise(SIGINT);
    }

    return 0;
}

在上面的示例中，

我们首先使用 signal() 函数设置了一个处理 SIGINT 信号的处理程序 sigint_handler()。
然后，在主循环中，我们随意输入一个字符后，就使用 raise() 函数向当前正在运行的进程发送 SIGINT 信号。当收到 SIGINT 信号时，程序将打印一条消息并退出。

注意： raise() 函数只能向当前进程发送信号，不能向其他进程发送信号。如果要向其他进程发送信号，可以使用 kill() 函数。

1.3 运行结果

2. rand

2.1 函数说明

函数声明	函数功能
`int rand(void);`	用于生成伪随机数

返回值：
每次调用它时会返回一个介于 0 和 RAND_MAX 之间的伪随机整数。其中，RAND_MAX 是一个常量，表示返回值的最大值，通常为 32767。

2.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <time.h>

int main() {
    // 使用系统时间作为随机数种子初始化
    srand(time(NULL));

    // 生成并输出 10 个随机数
    for (int i = 0; i < 10; i++) {
        printf("%d\n", rand());
    }

    return 0;
}

注意：

每次程序运行时，rand() 函数返回的随机数序列都是相同的。如果要生成不同的随机数序列，可以使用 srand() 函数提供的种子来初始化随机数发生器。
由于 rand() 函数只能生成伪随机数，不能保证其真正的随机性。因此，在需要高度安全性的应用程序中，建议使用更加安全的随机数生成器，如 /dev/random 和 /dev/urandom 等系统提供的硬件随机数生成器。

2.3 运行结果

3. read

3.1 函数说明

函数声明	函数功能
`ssize_t read(int fd, void *buf, size_t count);`	用于从文件描述符读取数据的函数。

参数：

fd ： 要读取的文件描述符
buf ： 存储读取数据的缓冲区
count ： 要读取的字节数。

3.2 演示示例

#include <stdio.h>
#include <unistd.h>

#define BUFFER_SIZE 1024

int main() {
    char buffer[BUFFER_SIZE];
    ssize_t num_read;

    num_read = read(STDIN_FILENO, buffer, BUFFER_SIZE);
    if (num_read == -1) {
        perror("read");
        return 1;
    }

    printf("Read %ld bytes from standard input: %.*s", num_read, (int)num_read, buffer);

    return 0;
}

在上述的示例中，

我们首先定义了一个大小为 BUFFER_SIZE 的字符数组 buffer；
然后使用 read() 函数读取标准输入【STDIN_FILENO 表示标准输入的文件描述符】中的数据到 buffer 中；
最后将读取的结果输出到控制台上。

3.3 运行结果

4. realloc

4.1 函数说明

函数声明	函数功能
`void realloc(void ptr, size_t size);`	用于重新分配已经分配过内存的空间大小。

参数：

ptr ： 指向已分配内存区域的指针
size ： 需要分配的新内存大小

返回值：

它会尝试重新调整已经分配给 ptr 指向的内存区域大小，并返回一个指向新内存起始地址的指针。
如果无法分配新的内存，则返回空指针 NULL。

注意： realloc() 函数并不保证原有的内存区域内容会被完全保留。当内存大小增加时，可能会分配新的内存并将原有的数据复制到新内存区域中；当内存大小减小时，则可能截断部分原有的数据。因此，在使用 realloc() 函数时，需要注意备份原有的数据，以免出现数据丢失的情况。

4.2 演示示例

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

int main() {
    // 分配 10 个整型变量的内存空间
    int *p = (int*) malloc(10 * sizeof(int));
    if (p == NULL) {
        printf("内存分配失败\n");
        exit(1);
    }

    // 更改为 20 个整型变量的内存空间
    int *q = (int*) realloc(p, 20 * sizeof(int));
    if (q == NULL) {
        printf("内存分配失败\n");
        exit(1);
    }

    // 输出新的内存地址
    printf("原内存地址：%p，新内存地址：%p\n", p, q);

    // 释放新分配的内存空间
    free(q);

    return 0;
}

在上面的示例中，

我们首先使用 malloc() 函数分配了 10 个整型变量的内存空间，并判断是否分配成功。
接着，我们使用 realloc() 函数将分配的内存空间大小扩充为 20 个整型变量，并判断是否分配成功。
最后，我们输出了原有的内存地址和新的内存地址，并释放了新分配的内存空间。

注意： 在使用 realloc() 函数时，应该始终检查返回值，以确保分配内存空间成功，避免因内存不足或其他原因导致程序崩溃。另外，也应该避免过度使用 realloc() 函数，因为频繁地重新分配内存会影响程序性能。

5. rectangle

5.1 函数说明

函数声明	函数功能
`void rectangle( int left, int top, int right, int bottom);`	画一个矩形

参数：
left, top, right, bottom，它们分别表示矩形左上角和右下角的坐标。

5.2 演示示例

#include <graphics.h>

int main(void)
{
    int gdriver = DETECT, gmode;
    int left, top, right, bottom;

    initgraph(&gdriver, &gmode, "");

    left = getmaxx() / 2 - 50;
    top = getmaxy() / 2 - 50;
    right = getmaxx() / 2 + 50;
    bottom = getmaxy() / 2 + 50;

    rectangle(left,top,right,bottom);

    getch();
    closegraph();
    return 0;
}

5.3 运行结果

6. registerbgidriver

6.1 函数说明

函数声明	函数功能
`int registerbgidriver(void(*driver)(void));`	用于将BGI（Borland Graphics Interface）驱动程序注册到系统中

注意：
它必须在使用任何 BGI 图形函数之前调用。该函数接受一个指向驱动程序结构的指针作为参数，并返回一个整数值以指示是否成功注册了驱动程序。BGI 驱动程序主要用于支持 Borland C++ 等 IDE 环境下的图形绘制和显示操作，它们通常存储在一个单独的库文件中，例如 graphics.h 头文件需要使用的 BGI driver 位于 libbgi.a 文件中。

6.2 演示示例

#include <graphics.h>

int main()
{
    int gd = DETECT, gm;
    initgraph(&gd, &gm, "");
    registerbgidriver(EGAVGA_driver); // 注册EGAVGA驱动程序
    circle(100, 100, 50); // 绘制圆形
    getch(); // 等待用户输入
    closegraph(); // 关闭图形界面
    return 0;
}

7. remove

7.1 函数说明

函数声明	函数功能
`int remove(char *filename);`	用于删除指定的文件

参数：

filename ： 一个指向要删除文件的文件名的字符串指针

返回值：
返回一个整数表示操作是否成功

如果文件成功删除，则返回 0；
否则，返回非零值以指示发生错误。

7.2 演示示例

#include <stdio.h>

int main()
{
    int result;
    char filename[] = "example.txt";
    result = remove(filename);
    if (result == 0)
    {
        printf("The file %s has been removed.\n", filename);
    }
    else
    {
        printf("Error deleting the file %s.\n", filename);
    }
    return 0;
}

7.3 运行结果

8. rename

8.1 函数说明

函数声明	函数功能
`int rename(char oldname, char newname);`	用于重命名或移动文件。

参数：

oldname ： 指定要更改的文件名
newname ： 指定新文件名或包含新路径的新文件名

返回值：

在执行成功时，该函数返回 0；
否则返回非零值以指示发生错误。

8.2 演示示例

#include <stdio.h>

int main()
{
    char oldname[] = "temp.txt";
    char newname[] = "tempnew.txt";
    int result;
    
    result = rename(oldname, newname);
    
    if (result == 0)
    {
        printf("The file has been renamed.\n");
    }
    else
    {
        printf("Error renaming the file.\n");
    }
    
    return 0;
}

8.3 运行结果

9. restorecrtmode

9.1 函数说明

函数声明	函数功能
`void restorecrtmode(void);`	将图形模式恢复到文本模式

9.2 演示示例

#include <graphics.h>
#include <stdlib.h>
#include <stdio.h>

int main(void)
{
    int gdriver = DETECT, gmode;
    int x, y;

    initgraph(&gdriver, &gmode, "");

    x = getmaxx() / 2;
    y = getmaxy() / 2;

    settextjustify(CENTER_TEXT, CENTER_TEXT);
    outtextxy(x, y, "Press any key to exit graphics:");
    getch();

    // 将图形模式恢复到文本模式
    restorecrtmode();
    printf("We're now in text mode.\n");
    printf("Press any key to return to graphics mode:");
    getch();

    // 返回图形模式
    setgraphmode(getgraphmode());

    settextjustify(CENTER_TEXT, CENTER_TEXT);
    outtextxy(x, y, "We're back in graphics mode.");
    outtextxy(x, y+textheight("W"), "Press any key to halt:");

    getch();
    closegraph();
    return 0;
}

9.3 运行结果

10. rewind

10.1 函数说明

函数声明	函数功能
`void rewind(FILE *stream);`	将文件指针 `stream` 指向的文件位置重置为文件开头，同时清除任何错误或文件结束标志。

10.2 演示示例

#include <stdio.h>

int main() {
    FILE *fp = fopen("tempnew.txt", "r");
    if (fp == NULL) {
        perror("Failed to open file");
        return 1;
    }
    
    // 读取文件内容
    char buffer[1024];
    while (fgets(buffer, sizeof(buffer), fp)) {
        printf("%s", buffer);
    }

    printf("\n");
    
    // 将文件指针重置到开头
    rewind(fp);
    
    // 再次读取文件内容
    while (fgets(buffer, sizeof(buffer), fp)) {
        printf("%s", buffer);
    }
    
    fclose(fp);
    return 0;
}

在上述的示例中，

我们首先打开一个名为 tempnew.txt 的文件；
然后使用 fgets() 函数从文件中读取文本行，并输出内容；
接着使用 rewind() 函数将文件指针重置到文件开头，并再次读取文件内容并输出；
最后关闭文件，退出程序。

10.3 运行结果

11. rmdir

11.1 函数说明

函数声明	函数功能
`int rmdir(const char *path);`	用于删除一个空目录，即该目录必须为空。

参数：

返回值：

如果成功，则返回 0；
否则返回 -1，并设置 errno 错误码。

11.2 演示示例

#include <stdio.h>
#include <stdlib.h>
int main() {
    const char *dir_name = "test";
    if (mkdir(dir_name) I= 0) {
        perror("Failed to create directory");
        return 1;
    }

    //在目录中创建一些文件
    FILE *fp1 = fopen("test/file1.txt","w");
    FILE *fp2 = fopen("test/file2.txt","w");
    fclose(fp1);
    fclose(fp2);
    
    /／尝试刪除非空目录
    if (rmdir(dir name) |= 0) {
        perror("Failed to remove directory");
        return 1;
    }
    printf("Directory removed successfullyIn");
    return 0;
}

在上述的示例中，

我们首先创建一个名为 test 的目录；
然后在其中创建两个文件 file1.txt 和 file2.txt；
接着使用 rmdir() 函数尝试删除该目录，但会失败，因为该目录不是空的。

注意： 如果要删除非空目录，可以使用上面的 remove() 函数来删除目录及其所有内容。

11.3 运行结果

12. round，roundf，roundl

12.1 函数说明

函数声明	函数功能
`double round(double x);`	将传入的实数参数 `x` 四舍五入为最接近的整数（double）
`float roundf(float x);`	将传入的实数参数 `x` 四舍五入为最接近的整数（float）
`long double roundl(long double x);`	将传入的实数参数 `x` 四舍五入为最接近的整数（long double）

12.2 演示示例

#include <math.h>
#include <stdio.h>

int main() {
    double x = 3.14159265;
    
    double rounded1 = round(x);     // 将 x 四舍五入为整数，结果为 3
    double rounded2 = round(x * 100) / 100;  // 将 x 精确到小数点后两位，结果为 3.14
    
    printf("rounded1: %lf\n", rounded1);
    printf("rounded2: %lf\n", rounded2);

    float xf = 2.5;
    printf("rountf(%f) = %f\n", xf, roundf(xf)); // 将 xf 四舍五入为整数，结果为 3
    
    long double xL = 2.4;
    printf("rountl(%Lf) = %Lf", xL, roundl(xL)); // 将 xL 四舍五入为整数，结果为 2
    return 0;
}

12.3 运行结果

13. remainder，remainderf，remainderl

13.1 函数说明

函数声明	函数功能
`double remainder(double x, double y);`	用于计算两个浮点数的余数（即模运算结果）（double）
`float remainderf (float x, float y );`	用于计算两个浮点数的余数（即模运算结果）（float）
`long double remainderl (long double x, long double y);`	用于计算两个浮点数的余数（即模运算结果）（long double）

参数：

x ： 被除数
y ： 除数

返回值： x/y 的余数

13.2 演示示例

#include <stdio.h>
#include <math.h>

int main() {
    double x = 10.5, y = 3.2;
    printf("remainder(%lf, %lf) = %.20lf\n", x, y, remainder(x, y));


    float xf = 10.5f, yf = 3.2f;
    printf("remainder(%f, %f) = %.20f\n", xf, yf, remainderf(xf, yf));


    long double xL = 10.5L, yL = 3.2L;
    printf("remainder(%Lf, %Lf) = %.20Lf\n", xL, yL, remainderl(xL, yL));
    return 0;
}

13.3 运行结果

14. remquo，remquof，remquol

14.1 函数说明

函数声明	函数功能
`double remquo(double x, double y, int *quo);`	用于计算两个浮点数的余数，并返回商和余数。
`float remquof(float x, float y, int *quo);`	用于计算两个浮点数的余数，并返回商和余数。
`long double remquol(long double x, long double y, int *quo);`	用于计算两个浮点数的余数，并返回商和余数。

参数：

x ： 被除数
y ： 除数
quo ： 返回商的指针。如果不需要返回商，则可以传递 NULL

返回值： 返回 x/y 的余数，并通过 quo 指针返回商。

14.2 演示示例

#include <stdio.h>
#include <math.h>

int main() {
    int quo;
    double x = 10.5, y = 3.2;
    double rem = remquo(x, y, &quo);
    printf("remquo(%lf, %lf, quo) = %.20lf, quo = %d\n", x, y, rem, quo);

    float xf = 10.5f, yf = 3.2f;
    float remf = remquof(xf, yf, &quo);
    printf("remquof(%f, %f, quo) = %.20f, quo = %d\n", xf, yf, remf, quo);

    long double xL = 10.5L, yL = 3.2L;
    long double remL = remquol(xL, yL, &quo);
    printf("remquol(%Lf, %Lf, quo) = %.20Lf, quo = %d\n", xL, yL, remL, quo);

    return 0;
}

14.3 运行结果

15. rint，rintf，rintl

15.1 函数说明

函数声明	函数功能
`double rint(double x);`	将 x 四舍五入到最接近的整数（double）
`float rintf(float x);`	将 x 四舍五入到最接近的整数（float）
`long double rintl(long double x);`	将 x 四舍五入到最接近的整数（long double）

15.2 演示示例

#include <stdio.h>
#include <math.h>

int main() {
    double d = 3.7;
    float f = 2.4f;
    long double ld = 5.9L;

    printf("rint(%f) = %.1f\n", d, rint(d));   // Output: rint(3.700000) = 4.0
    printf("rintf(%f) = %.1f\n", f, rintf(f)); // Output: rintf(2.400000) = 2.0
    printf("rintl(%Lf) = %.1Lf\n", ld, rintl(ld)); // Output: rintl(5.900000) = 6.0

    return 0;
}

15.3 运行结果

参考

[API Reference Document]

C语言函数大全--q 开头的函数

发表于 2023-04-26 更新于 2025-05-24 分类于开发语言-C

总览

函数声明	函数功能
`void qsort(void base, size_t nmemb, size_t size, int (compar)(const void , const void ));`	用于将指定数组按指定顺序进行排序
`void quick_exit(int status);`	它是 `C11` 标准中新增的函数，用于快速退出程序并执行一些清理操作。它类似于 `exit()` 函数，但不会调用 `atexit()` 注册的函数，并且不会刷新标准 `I/O` 流（例如 `stdout` 和 `stderr`）。
`int qunsetenv(const char *name);`	用于从进程环境中移除指定的环境变量。该函数在某些操作系统上可能不可用，因为它并非标准的 C 语言函数，而是 POSIX 标准中定义的函数。
QuRT相关的函数	详见 4.1 所示

1. qsort

1.1 函数说明

函数声明	函数功能
`void qsort(void base, size_t nmemb, size_t size, int (compar)(const void , const void ));`	用于将指定数组按指定顺序进行排序
参数：

base ： 指向要排序的数组的第一个元素的指针
nmemb ： 表示数组中元素的数量
size ： 表示每个元素的大小（以字节为单位）
compar ： 指向一个函数，用于比较两个元素的值。该函数需要接受两个 const void* 类型的参数，分别指向要比较的两个元素，并返回一个整数值，表示它们的相对顺序。

1.2 演示示例

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

int compare(const void* a, const void* b) {
    return (*(int*)a - *(int*)b);
}

int main() {
    int arr[] = { 5, 2, 8, 4, 1, 9, 3, 6, 7 };
    size_t n = sizeof(arr) / sizeof(int);

    printf("Before sorting:");
    for (int i = 0; i < n; i++) {
        printf(" %d", arr[i]);
    }
    printf("\n");

    qsort(arr, n, sizeof(int), compare);

    printf("After sorting:");
    for (int i = 0; i < n; i++) {
        printf(" %d", arr[i]);
    }
    printf("\n");

    return 0;
}

在上述的示例中，

我们首先定义了一个整数数组 arr，并计算出数组的长度，赋值给 n；
接着我们输出原始数组 "Before sorting: 5 2 8 4 1 9 3 6 7"
然后我们使用 qsort() 函数将其按照升序排列。qsort() 函数中传入一个比较函数 compare()，用于比较两个元素的值。
最后我们再次输出排序后的结果 ”After sorting: 1 2 3 4 5 6 7 8 9“。

注意： 在编写比较函数时，需要根据元素的实际类型进行转换，并确保返回值符合要求（小于零表示第一个元素小于第二个元素，等于零表示两个元素相等，大于零表示第一个元素大于第二个元素）。此外，还需要特别注意参数类型和返回值类型的 const 限定符。

1.3 运行结果

2. quick_exit

2.1 函数说明

函数声明	函数功能
`void quick_exit(int status);`	它是 `C11` 标准中新增的函数，用于快速退出程序并执行一些清理操作。它类似于 `exit()` 函数，但不会调用 `atexit()` 注册的函数，并且不会刷新标准 `I/O` 流（例如 `stdout` 和 `stderr`）。
参数：

status ：程序退出时返回的状态码，0 表示程序正常退出，非零值表示出现了异常情况。

2.2 演示示例

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

void cleanup() {
    printf("Cleaning up...\n");
}

int main() {
    if (at_quick_exit(cleanup) != 0) {
        fprintf(stderr, "Failed to register cleanup function\n");
        exit(EXIT_FAILURE);
    }

    printf("Running...\n");

    quick_exit(EXIT_SUCCESS);
}

在如上的示例中，

我们首先使用 at_quick_exit() 函数注册一个清理函数 cleanup()，当程序使用 quick_exit() 函数退出时，该函数会自动执行。
然后，我们调用 quick_exit() 函数并传入状态码 EXIT_SUCCESS 表示程序正常退出。

注意： 在使用 quick_exit() 函数时需要特别小心，因为它不会调用 atexit() 注册的函数，并且可能导致一些资源泄漏或未完成的操作。只有在必须立即结束程序并执行清理操作时，才应该使用该函数。

3. qunsetenv

3.1 函数说明

函数声明	函数功能
`int qunsetenv(const char *name);`	用于从进程环境中移除指定的环境变量。该函数在某些操作系统上可能不可用，因为它并非标准的 C 语言函数，而是 POSIX 标准中定义的函数。
参数：

name ： 要移除的环境变量的名称

返回值：

如果环境变量不存在，则不进行任何操作，并返回 0；
否则将其移除，并返回一个非零值。

3.2 演示示例

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

int main() {
    // 设置一个环境变量
    setenv("MY_VAR", "hello world", 1);

    // 移除这个环境变量
    if (qunsetenv("MY_VAR") != 0) {
        perror("qunsetenv() failed");
        exit(EXIT_FAILURE);
    }

    // 尝试访问这个环境变量
    char *val = getenv("MY_VAR");
    if (val == NULL) {
        printf("Environment variable MY_VAR has been removed.\n");
    } else {
        printf("Unexpected value: %s\n", val);
    }

    return EXIT_SUCCESS;
}

在上述这个示例程序中，

我们首先使用 setenv() 函数设置了一个名为 MY_VAR 的环境变量；
然后使用 qunsetenv() 函数移除了这个环境变量；
最后再次尝试访问这个环境变量，如果返回值为 NULL，则说明环境变量已经被成功移除了。

注意： 使用 qunsetenv() 函数可以修改当前进程的环境变量，但是对于其他进程或子进程来说，它们的环境变量不受影响。此外，一些操作系统可能不支持对环境变量进行动态修改，因此无法保证 qunsetenv() 函数在所有平台上都能正常工作。

4. QuRT

4.1 函数说明

函数声明	函数功能
`void qurt_sysenv_getvirtaddr(void phys_addr, unsigned int size);`	将物理地址转换为虚拟地址。
`void *qurt_malloc(unsigned int size);`	动态分配内存
`void *qurt_calloc(unsigned int nmemb, unsigned int size);`	动态分配内存，并初始化为零。
`void qurt_free(void *ptr);`	释放动态分配的内存。
`int qurt_thread_create(qurt_thread_t tid, const qurt_thread_attr_t attr, void (start)(void ), void *arg);`	创建新线程。
`int qurt_thread_join(qurt_thread_t tid, int *status);`	等待线程结束并释放其资源。
`unsigned int qurt_thread_get_priority(qurt_thread_t thread);`	用于获取指定线程的优先级。其中参数 `thread` 是要获取优先级的线程的句柄。返回一个无符号整数，表示线程的优先级。
`void qurt_thread_set_priority(qurt_thread_t thread, unsigned int priority);`	用于设置指定线程的优先级。其中参数 `thread` 是要设置优先级的线程的句柄，而参数 `priority` 是要设置的优先级值。
`char qurt_thread_get_name(char name, qurt_thread_t thread);`	用于获取指定线程的名称。其中参数 `name` 是一个指向存储线程名称的缓冲区的指针，而参数 `thread` 是要获取名称的线程的句柄。返回一个指向缓冲区中存储线程名称的指针。
`void qurt_thread_set_name(qurt_thread_t thread, const char *name);`	用于设置指定线程的名称。其中参数 `thread` 是要设置名称的线程的句柄，而参数 `name` 是要设置的线程名称。
`int qurt_thread_stop(qurt_thread_t thread);`	用于停止指定线程的执行，即立即终止线程的运行。其中参数 `thread` 是要停止执行的线程的句柄。返回一个整数值，表示是否成功停止线程。如果成功，则返回 `0`；否则返回一个负数错误代码。
`int qurt_thread_resume(qurt_thread_t thread);`	用于恢复指定线程的执行，即让线程从上次暂停处继续运行。其中参数 `thread` 是要恢复执行的线程的句柄。返回一个整数值，表示是否成功恢复线程。如果成功，则返回 `0`；否则返回一个负数错误代码。
`void qurt_mutex_init(qurt_mutex_t *mutex);`	用于初始化一个互斥锁，即在使用之前必须进行初始化。其中参数 `mutex` 是指向要初始化的互斥锁对象的指针。
`void qurt_mutex_lock(qurt_mutex_t *mutex);`	用于以阻塞方式获取一个互斥锁。如果该互斥锁已被其他线程锁定，则当前线程将一直等待，直到可以获取该锁。其中参数 `mutex` 是指向要获取的互斥锁对象的指针。
`void qurt_mutex_unlock(qurt_mutex_t *mutex);`	用于释放一个互斥锁，即解除对该互斥锁的占用。其中参数 `mutex` 是指向要释放的互斥锁对象的指针。
`void qurt_timer_sleep(unsigned int ticks);`	用于让当前线程进入休眠状态，休眠时间由参数 `ticks` 指定（每个 `tick` 的长度取决于系统时钟频率）。在休眠期间，该线程将不会被调度执行。注意，该函数可能会提前唤醒线程，因此休眠时间并不精确。
`void qurt_signal_init(qurt_signal_t *signal);`	用于初始化一个信号量，即在使用之前必须进行初始化。其中参数 `signal` 是指向要初始化的信号量对象的指针。
`unsigned int qurt_signal_wait(qurt_signal_t signal, unsigned int mask, unsigned int option, unsigned int ret_signal);`	用于等待一个或多个信号量的触发。其中参数 `signal` 是指向要等待的信号量对象的指针，参数 `mask` 表示要等待哪些信号量，参数 `option` 用于指定等待的行为选项，参数 `ret_signal` 用于返回实际触发的信号量。
`void qurt_signal_set(qurt_signal_t *signal, unsigned int mask);`	用于触发一个或多个信号量。其中参数 `signal` 是指向要触发的信号量对象的指针，参数 `mask` 表示要触发哪些信号量。
`void qurt_signal2_init(qurt_signal2_t *signal);`	用于初始化一个带有两个信号量的信号量对象。其中参数 `signal` 是指向要初始化的信号量对象的指针。
`void qurt_signal2_destroy(qurt_signal2_t *signal);`	用于销毁带有两个信号量的信号量对象，并释放其占用的内存空间。其中参数 `signal` 是要销毁的信号量对象的指针。
`void qurt_signal2_set(qurt_signal2_t *signal, unsigned int mask);`	用于设置带有两个信号量的信号量对象中的一个或多个信号量。其中参数 `signal` 是要设置信号量的信号量对象的指针，而参数 `mask` 是一个 `32` 位无符号整数，表示要设置的信号量掩码。掩码中每个位代表一个信号量，如果该位为 `1`，则表示相应的信号量被设置；如果该位为 `0`，则表示相应的信号量未被设置。
`unsigned int qurt_signal2_wait(qurt_signal2_t *signal, unsigned int mask, unsigned int options);`	用于等待带有两个信号量的信号量对象中指定的信号量被触发。其中参数 `signal` 是要等待的信号量对象的指针，而参数 `mask` 是一个 32 位无符号整数，表示要等待的信号量掩码。掩码中每个位代表一个信号量，如果该位为 `1`，则表示相应的信号量需要被触发；如果该位为 `0`，则表示相应的信号量不需要被触发。参数 `options` 则指定等待信号量的选项，例如是否超时等。它返回一个 `32` 位无符号整数，表示哪些信号量已被触发。返回值中每个位代表一个信号量，如果该位为 `1`，则表示相应的信号量已被触发；如果该位为 `0`，则表示相应的信号量未被触发。
`void qurt_timer_create(qurt_timer_t timer, const char name);`	用于创建一个新的定时器。其中参数 `timer` 是指向要创建的定时器对象的指针，参数 `name` 是定时器的名称（可以为 `NULL`）。
`void qurt_timer_delete(qurt_timer_t timer);`	用于删除一个已经创建的定时器。其中参数 `timer` 是要删除的定时器对象。
`void qurt_timer_start(qurt_timer_t timer, uint32_t duration);`	用于启动一个定时器，并指定定时器的超时时间。其中参数 `timer` 是要启动的定时器对象，参数 `duration` 是定时器的超时时间（以 `tick` 为单位）。
`void qurt_timer_stop(qurt_timer_t timer);`	用于停止一个已经运行的定时器。其中参数 `timer` 是要停止的定时器对象。
`qurt_thread_t qurt_thread_get_id(void);`	用于获取当前线程的 `ID`。
`int qurt_mem_region_create(qurt_mem_region_t *region, unsigned int size, qurt_mem_cache_mode_t cache_attrib, qurt_mem_region_type_t type);`	用于创建一个内存区域对象，并分配指定大小的内存空间。其中参数 `region` 是指向要创建的内存区域对象的指针，参数 `size` 指定内存区域的大小，而 `cache_attrib` 和 `type` 分别指定内存区域的缓存属性和类型。返回一个整数值，表示是否成功创建内存区域。如果成功，则返回 `0`；否则返回一个负数错误代码。
`int qurt_mem_region_delete(qurt_mem_region_t region);`	用于删除指定的内存区域对象，并释放其占用的内存空间。其中参数 `region` 是要删除的内存区域对象的句柄。返回一个整数值，表示是否成功删除内存区域。如果成功，则返回 `0`；否则返回一个负数错误代码。
`void qurt_mem_region_attr_init(qurt_mem_region_attr_t *attr);`	用于初始化一个内存区域属性对象。其中参数 `attr` 是指向要初始化的内存区域属性对象的指针。
`int qurt_mem_pool_create(qurt_mem_pool_t pool, void baseaddr, unsigned int size, qurt_mem_cache_mode_t cache_attrib);`	用于创建一个内存池对象，并分配指定大小的内存空间。其中参数 `pool` 是指向要创建的内存池对象的指针，参数 `baseaddr` 指定内存池的起始地址，而 `size` 和 `cache_attrib` 分别指定内存池的大小和缓存属性。返回一个整数值，表示是否成功创建内存池。如果成功，则返回 `0`；否则返回一个负数错误代码。
`int qurt_mem_pool_delete(qurt_mem_pool_t pool);`	用于删除指定的内存池对象，并释放其占用的内存空间。其中参数 pool 是要删除的内存池对象的句柄。返回一个整数值，表示是否成功删除内存池。如果成功，则返回 `0`；否则返回一个负数错误代码。
`int qurt_pipe_create(qurt_pipe_t *pipe, unsigned int pipe_type, unsigned int pipe_elements, unsigned int elem_size);`	用于创建一个管道对象，并分配指定大小的内存空间。其中参数 `pipe` 是指向要创建的管道对象的指针，参数 `pipe_type` 指定管道类型，参数 `pipe_elements` 指定管道元素个数，而 `elem_size` 指定每个管道元素的大小。返回一个整数值，表示是否成功创建管道。如果成功，则返回 `0`；否则返回一个负数错误代码。
`int qurt_pipe_delete(qurt_pipe_t pipe);`	用于删除指定的管道对象，并释放其占用的内存空间。其中参数 `pipe` 是要删除的管道对象的句柄。返回一个整数值，表示是否成功删除管道。如果成功，则返回 `0`；否则返回一个负数错误代码。
`int qurt_pipe_send(qurt_pipe_t pipe_id, void *buf, unsigned int size, unsigned int timeout);`	用于向指定的管道发送数据。其中参数 `pipe_id` 是要发送数据的管道对象的句柄，参数 `buf` 指向要发送的数据缓冲区，参数 `size` 指定要发送的数据大小，而 `timeout` 指定等待发送操作完成的超时时间（单位为 ticks）。返回一个整数值，表示是否成功发送数据。如果成功，则返回 `0`；否则返回一个负数错误代码。
`int qurt_pipe_receive(qurt_pipe_t pipe_id, void buf, unsigned int size, unsigned int recv_size, unsigned int timeout);`	用于从指定的管道接收数据。其中参数 `pipe_id` 是要接收数据的管道对象的句柄，参数 `buf` 指向接收数据的缓冲区，参数 `size` 指定要接收的数据大小，而 `recv_size` 是一个指针，用于返回实际接收到的数据大小。参数 `timeout` 指定等待接收操作完成的超时时间（单位为 `ticks`）。返回一个整数值，表示是否成功接收数据。如果成功，则返回 0；否则返回一个负数错误代码。

4.2 演示示例

4.2.1 QuRT 创建线程示例

#include <stdio.h>
#include "qurt.h"

void task1(void *arg) {
    printf("Task 1 is running...\n");
    printf("Task 1 is done.\n");
}

void task2(void *arg) {
    printf("Task 2 is running...\n");
    printf("Task 2 is done.\n");
}

int main() {
    qurt_thread_t t1, t2;
    qurt_thread_attr_t attr;

    qurt_thread_attr_init(&attr);
    qurt_thread_create(&t1, &attr, (void (*)(void *))task1, NULL);
    qurt_thread_create(&t2, &attr, (void (*)(void *))task2, NULL);

    qurt_thread_join(t1, NULL);
    qurt_thread_join(t2, NULL);

    return 0;
}

在上述的示例中，我们使用 qurt_thread_create() 函数创建了两个线程，分别执行 task1() 和 task2() 函数，并使用 qurt_thread_join() 函数等待它们结束。
注意： 在开发过程中，需要根据实际情况合理使用内存管理函数和多任务调度函数，并避免出现死锁、资源泄漏等问题。

4.2.2 QuRT 互斥锁示例

#include "qurt.h"
#include <stdio.h>

// 共享资源
int global_counter = 0;

// 互斥锁对象
static qurt_mutex_t mutex;

int main() {
    // 初始化互斥锁对象
    qurt_mutex_init(&mutex);

    // 创建两个线程，同时访问共享资源
    qurt_thread_t thread1, thread2;
    qurt_thread_create(&thread1, NULL, increment_global_counter, NULL);
    qurt_thread_create(&thread2, NULL, increment_global_counter, NULL);

    // 等待两个线程结束
    qurt_thread_join(thread1, NULL);
    qurt_thread_join(thread2, NULL);

    // 输出最终结果
    printf("Global counter: %d\n", global_counter);

    return 0;
}

void increment_global_counter(void *arg) {
    for (int i = 0; i < 1000000; ++i) {
        // 获取互斥锁
        qurt_mutex_lock(&mutex);

        // 访问共享资源
        ++global_counter;

        // 释放互斥锁
        qurt_mutex_unlock(&mutex);
    }
}

在上面这个示例程序中，

我们首先使用 qurt_mutex_init() 函数初始化了一个互斥锁对象。
然后创建了两个线程，它们都会调用 increment_global_counter() 函数来增加全局计数器 global_counter 的值。由于多个线程可能同时访问该共享资源，因此在访问之前需要先获取互斥锁，以避免竞争条件的发生。在 increment_global_counter() 函数中，我们使用 qurt_mutex_lock() 函数获取互斥锁，并使用 qurt_mutex_unlock() 函数释放互斥锁。
最后，我们在主函数中输出了最终的计数器值。

4.2.3 QuRT 信号量示例

#include "qurt.h"
#include <stdio.h>

// 共享资源
int global_counter = 0;

// 信号量对象
static qurt_signal_t sem;

int main() {
    // 初始化信号量对象
    qurt_signal_init(&sem);

    // 创建两个线程，分别增加和减少全局计数器的值
    qurt_thread_t thread1, thread2;
    qurt_thread_create(&thread1, NULL, increment_global_counter, NULL);
    qurt_thread_create(&thread2, NULL, decrement_global_counter, NULL);

    // 等待两个线程结束
    qurt_thread_join(thread1, NULL);
    qurt_thread_join(thread2, NULL);

    // 输出最终结果
    printf("Global counter: %d\n", global_counter);

    return 0;
}

void increment_global_counter(void *arg) {
    for (int i = 0; i < 1000000; ++i) {
        // 等待信号量
        qurt_signal_wait(&sem, 1, QURT_SIGNAL_ATTR_WAIT_ANY, NULL);

        // 访问共享资源
        ++global_counter;

        // 触发信号量
        qurt_signal_set(&sem, 1);
    }
}

void decrement_global_counter(void *arg) {
    for (int i = 0; i < 1000000; ++i) {
        // 等待信号量
        qurt_signal_wait(&sem, 1, QURT_SIGNAL_ATTR_WAIT_ANY, NULL);

        // 访问共享资源
        --global_counter;

        // 触发信号量
        qurt_signal_set(&sem, 1);
    }
}

在上述的示例程序中，

我们首先使用 qurt_signal_init() 函数初始化了一个信号量对象。
然后创建了两个线程，一个增加全局计数器的值，一个减少全局计数器的值。由于多个线程同时访问该共享资源，因此需要使用信号量进行同步。在每个线程中，我们使用 qurt_signal_wait() 函数等待信号量，当信号量触发时才能访问共享资源，并使用 qurt_signal_set() 函数释放信号量。
接着使用 qurt_thread_join() 函数等待两个线程结束；
最后输出最终结果。

4.2.4 QuRT 定时器示例

#include "qurt.h"
#include <stdio.h>

// 定时器对象
static qurt_timer_t timer;

// 定时器回调函数
void timer_callback(int arg) {
    printf("Timer expired\n");
}

int main() {
    // 创建定时器对象
    qurt_timer_create(&timer, NULL);

    // 启动定时器
    qurt_timer_start(timer, 1000);

    // 注册定时器回调函数
    qurt_timer_set_attr(timer, QURT_TIMER_ATTR_CALLBACK_FUNCTION, (void *)timer_callback);
    qurt_timer_set_attr(timer, QURT_TIMER_ATTR_CALLBACK_ARGUMENT, (void *)0);

    // 等待定时器超时
    while (1) {
        qurt_timer_sleep(10);
    }

    // 停止定时器
    qurt_timer_stop(timer);

    // 删除定时器对象
    qurt_timer_delete(timer);

    return 0;
}

在上述的示例程序中，

我们首先使用 qurt_timer_create() 函数创建了一个定时器。
然后使用 qurt_timer_start() 函数启动了该定时器，并指定了定时器的超时时间（1000 毫秒）。
接着使用 qurt_timer_set_attr() 函数注册了定时器回调函数。
最后进入一个无限循环，每隔 10 毫秒调用 qurt_timer_sleep() 函数进入休眠状态，等待定时器超时。当定时器超时时，将触发定时器回调函数 timer_callback()，输出一条消息。

注意： 在程序结束时需要使用 qurt_timer_stop() 停止定时器，并使用 qurt_timer_delete() 删除定时器对象。

4.2.5 QuRT 共享内存区域示例

#include "qurt.h"
#include <stdio.h>

#define SHM_SIZE 1024

int main() {
    // 创建共享内存区域
    qurt_mem_region_t shm;
    qurt_mem_region_attr_t attr;
    qurt_mem_region_attr_init(&attr);
    qurt_mem_region_create(&shm, SHM_SIZE, QURT_MEM_CACHE_NONE, QURT_MEM_REGION_SHARED | QURT_MEM_REGION_PERM_READ | QURT_MEM_REGION_PERM_WRITE);

    // 在共享内存区域中写入数据
    char *buf = (char *)qurt_mem_region_get_vaddr(&shm);
    sprintf(buf, "Hello, shared memory!");

    // 打印从共享内存区域中读取的数据
    printf("%s\n", buf);

    // 删除共享内存区域
    qurt_mem_region_delete(shm);

    return 0;
}

在上述这个示例程序中，

我们首先使用 qurt_mem_region_create() 函数创建了一个大小为 SHM_SIZE 的共享内存区域，并设置其缓存属性为 QURT_MEM_CACHE_NONE，类型为 QURT_MEM_REGION_SHARED，并且具有读写权限。
然后，在共享内存区域中写入了一些数据，并使用 printf() 函数打印了从共享内存区域中读取的数据。
最后，使用 qurt_mem_region_delete() 函数删除了共享内存区域。

4.2.6 QuRT 使用管道进行进程间通信的示例

#include "qurt.h"
#include <stdio.h>

#define PIPE_SIZE 1024

int main() {
    // 创建管道
    qurt_pipe_t pipe;
    qurt_pipe_create(&pipe, QURT_PIPE_ATTR_BLOCKING | QURT_PIPE_ATTR_PIPE_TYPE_BYTE_QUEUE, PIPE_SIZE, 1);

    // 创建子进程
    qurt_thread_t child;
    qurt_thread_create(&child, NULL, child_thread, (void *)&pipe);

    // 向管道发送数据
    char msg[] = "Hello, pipe!";
    qurt_pipe_send(pipe, msg, sizeof(msg), QURT_TIME_WAIT_FOREVER);

    // 等待子进程结束
    qurt_thread_join(child, NULL);

    // 删除管道
    qurt_pipe_delete(pipe);

    return 0;
}

void child_thread(void *arg) {
    // 从管道接收数据
    char buf[PIPE_SIZE];
    unsigned int recv_size;
    qurt_pipe_receive(*(qurt_pipe_t *)arg, buf, PIPE_SIZE, &recv_size, QURT_TIME_WAIT_FOREVER);

    // 打印从管道中接收到的数据
    printf("%s\n", buf);
}

在上述示例程序中，

我们首先使用 qurt_pipe_create() 函数创建一个大小为 1024 字节的管道对象，属性设置为阻塞式字节队列。
然后我们使用 qurt_thread_create() 函数创建了一个名为 child 的子线程，并将管道对象传递给它。我们在 child_thread() 函数中调用了 qurt_pipe_receive() 函数来从管道接收数据，然后使用 printf() 函数打印出接收到的字符串。
接着我们定义了一个字符串 msg，并使用 qurt_pipe_send() 函数向管道发送该字符串。
最后我们使用 qurt_pipe_delete() 函数删除了管道对象。

C语言函数大全--p 开头的函数

发表于 2023-04-25 更新于 2025-05-10 分类于开发语言-C

总览

函数声明	函数功能
`void perror(const char *s);`	用于将当前错误码对应的错误信息打印到标准输出设备（通常是终端）。
`void pieslice(int x, int y, int stanle, int endangle, int radius);`	在图形模式下绘制并填充一个扇形（饼图切片）
`double pow(double x, double y);`	用于计算 x 的 y 次幂，并返回结果（double）
`float powf(float x, float y);`	用于计算 x 的 y 次幂，并返回结果（float）
`long double powl(long double x, long double y);`	用于计算 x 的 y 次幂，并返回结果（long double）
`double pow10(double x);`	用于计算 $10^x$ （double）
`float pow10f(float x);`	用于计算 $10^x$（float）
`long double pow10l(long double x);`	用于计算 $10^x$ （long double）
`int printf(const char *format, ...);`	它是标准 I/O 库中定义的函数，用于将格式化的数据输出到标准输出流（通常是控制台窗口）
`int pthread_create(pthread_t thread, const pthread_attr_t attr, void (start_routine) (void ), void arg);`	创建一个新的线程
`int pthread_join(pthread_t thread, void **retval);`	阻塞当前线程，等待指定的线程结束。
`int pthread_mutex_init(pthread_mutex_t mutex, const pthread_mutexattr_t attr);`	初始化互斥锁。返回值为 0 表示成功，否则表示失败。
`int pthread_mutex_destroy(pthread_mutex_t *mutex);`	销毁互斥锁。返回值为 0 表示成功，否则表示失败。
`int pthread_mutex_lock(pthread_mutex_t *mutex);`	尝试获取互斥锁，如果已经被占用，则会阻塞当前线程。返回值为 0 表示成功获取互斥锁，否则表示失败。
`int pthread_mutex_unlock(pthread_mutex_t *mutex);`	释放互斥锁。
`int putc(int c, FILE *stream);`	它是标准 `I/O` 库中定义的函数，用于将一个字符输出到指定的文件流。
`int putchar(int c);`	它是标准 `I/O` 库中定义的函数，用于将一个字符输出到标准输出流（通常是控制台窗口）。
`int putenv(char *string);`	用于设置环境变量的值。
`void putimage(int left, int top, void *bitmap, int op);`	用于将位图图像输出到指定的窗口或屏幕上
`void putpixel(int x, int y, int color);`	用于将一个像素点画在指定的位置上
`int puts(const char *s);`	用于将一个字符串输出到标准输出流
`int putw(int w, FILE *stream);`	用于将一个整数值以二进制形式写入到指定的文件中。

1. perror

1.1 函数说明

函数声明	函数功能
`void perror(const char *s);`	用于将当前错误码对应的错误信息打印到标准输出设备（通常是终端）。

参数：

s ： 用于描述错误类型或者出错的上下文信息。它会在该信息后面追加当前错误码对应的错误信息，并且自动换行。

1.2 演示示例

#include <stdio.h>
#include <errno.h>

int main() {
    FILE *fp = fopen("tempfile.txt", "r");
    if (fp == NULL) {
        perror("Failed to open file");
        printf("Error code: %d\n", errno);
    }
    return 0;
}

在上述的示例中，

我们首先尝试打开一个不存在的文件，并通过 fopen() 函数返回的值来检查是否成功。由于该文件不存在，fopen() 函数将返回 NULL；
然后我们可以使用 perror() 函数来输出一个错误消息和具体的错误信息，以帮助我们找到问题所在。如果发生了错误，errno 全局变量会被设置为一个非零值，我们还可以使用它来获取具体的错误代码。

1.3 运行结果

2. pieslice

2.1 函数说明

函数声明	函数功能
`void pieslice(int x, int y, int stanle, int endangle, int radius);`	在图形模式下绘制并填充一个扇形（饼图切片）

参数：

x ： 圆心的x 坐标
y ： 圆心的y 坐标
startangle ： 圆弧的起始角度（以度为单位）
endangle ： 圆弧的结束角度（以度为单位）
- radius ： 圆的半径

2.2 演示示例

#include <graphics.h>

int main() {
    int gdriver = DETECT, gmode;
    int midx, midy;
    int stangle = 45, endangle = 135, radius = 100;

    initgraph(&gdriver, &gmode, "");  // 初始化图形窗口

    midx = getmaxx() / 2;
    midy = getmaxy() / 2;

    setcolor(YELLOW);  // 设置画笔颜色为黄色
    setfillstyle(EMPTY_FILL, getmaxcolor()); // 设置填充样式。
    // 绘制一个半径为100像素、起始角度为45度、结束角度为135度的圆弧
    pieslice(midx, midy, stangle, endangle, radius);

    getch();  // 等待用户按键
    closegraph();  // 关闭图形窗口
    return 0;
}

2.3 运行结果

3. pow，powf，powl

3.1 函数说明

函数声明	函数功能
`double pow(double x, double y);`	用于计算 x 的 y 次幂，并返回结果（double）
`float powf(float x, float y);`	用于计算 x 的 y 次幂，并返回结果（float）
`long double powl(long double x, long double y);`	用于计算 x 的 y 次幂，并返回结果（long double）

3.2 演示示例

#include <stdio.h>
#include <math.h>

int main() {
    double result = pow(2.0, 3.5);
    printf("The result of pow(2.0, 3.5)    is: %.20lf\n", result);

    float resultf = powf(2.0f, 3.5f);
    printf("The result of powf(2.0f, 3.5f) is: %.20f\n", resultf);

    long double resultL = powl(2.0L, 3.5L);
    printf("The result of powl(2.0L, 3.5L) is: %.20Lf\n", resultL);
    return 0;
}

3.3 运行结果

4. pow10，pow10f，pow10l

4.1 函数说明

函数声明	函数功能
`double pow10(double x);`	用于计算 $10^x$ （double）
`float pow10f(float x);`	用于计算 $10^x$（float）
`long double pow10l(long double x);`	用于计算 $10^x$ （long double）

4.2 演示示例

#include <stdio.h>
#include <math.h>

int main() {
    double result = pow10(-2.0);
    printf("The result is: %lf\n", result);
    return 0;
}

#include <iostream>
#include <cmath>

int main() {
    float result = std::pow10f(-2.0f);
    std::cout << "10^-2 = " << result << std::endl;

    long double result = std::pow10l(-2.0L);
    std::cout << "10^-2 = " << result << std::endl;

    return 0;
}

5. printf

5.1 函数说明

函数声明	函数功能
`int printf(const char *format, ...);`	它是标准 I/O 库中定义的函数，用于将格式化的数据输出到标准输出流（通常是控制台窗口）
参数：

format ： 一个格式化字符串
可变参数： 任意数量，这些可变参数会根据格式化字符串进行格式化，并被输出到标准输出流。

返回值：

成功打印的字符数。

5.2 演示示例

#include <stdio.h>

int main() {
    printf("Hello, world!\n");
    char name[20] = "Huazie";
    printf("My name is %s", name);
    return 0;
}

5.3 运行结果

6. pthread_create，pthread_join

6.1 函数说明

函数声明	函数功能
`int pthread_create(pthread_t thread, const pthread_attr_t attr, void (start_routine) (void ), void arg);`	创建一个新的线程
`int pthread_join(pthread_t thread, void **retval);`	阻塞当前线程，等待指定的线程结束。

pthread_create 参数：

thread ： 指向线程标识符的指针，用于返回新创建线程的标识符
attr ： 指向线程属性结构体的指针，用于指定线程的属性，通常为 NULL 表示使用默认属性
start_routine ： 指向线程函数的指针，用于指定线程的入口点
arg ： 传递给线程函数的参数，可以为任意类型的指针。

pthread_join 参数：

pthread_t thread ：目标线程的标识符（由 pthread_create() 返回）。必须是已创建且未被分离（non-detached）的线程。
void **retval ：用于接收目标线程的退出状态值的指针的地址。
- 若目标线程通过 return 返回值或调用 pthread_exit(void *retval) 终止，retval 将指向该值。
- 若不需要获取退出状态，可设为 NULL。
- 若目标线程被取消，retval 会被设为 PTHREAD_CANCELED（通常为 -1）。

6.2 演示示例

#include <stdio.h>
#include <pthread.h>

void *thread_func(void *arg) {
    printf("Hello from the new thread!\n");
    return NULL;
}

int main() {
    pthread_t thread;
    int ret = pthread_create(&thread, NULL, thread_func, NULL);
    if (ret != 0) {
        printf("Failed to create thread!\n");
        return -1;
    }

    pthread_join(thread, NULL);

    printf("Hello from the main thread!\n");
    return 0;
}

在上述的示例中，主线程调用了 pthread_create() 函数来创建一个新的线程，并传递一个函数指针 thread_func 作为新线程的入口点。新线程运行这个函数，并输出一条消息。主线程等待新线程结束，然后继续运行自己的代码。

6.3 运行结果

7. pthread_mutex_init，pthread_mutex_destroy，pthread_mutex_lock，pthread_mutex_unlock

7.1 函数说明

函数声明	函数功能
`int pthread_mutex_init(pthread_mutex_t mutex, const pthread_mutexattr_t attr);`	初始化互斥锁。返回值为 0 表示成功，否则表示失败。
`int pthread_mutex_destroy(pthread_mutex_t *mutex);`	销毁互斥锁。返回值为 0 表示成功，否则表示失败。
`int pthread_mutex_lock(pthread_mutex_t *mutex);`	尝试获取互斥锁，如果已经被占用，则会阻塞当前线程。返回值为 0 表示成功获取互斥锁，否则表示失败。
`int pthread_mutex_unlock(pthread_mutex_t *mutex);`	释放互斥锁。

参数：

mutex ： 指向互斥锁对象的指针。
attr ： 指向线程属性结构体的指针，用于指定互斥锁对象的属性，通常为 NULL 表示使用默认属性。

7.2 演示示例

#include <stdio.h>
#include <pthread.h>

pthread_mutex_t mutex;

void *thread_func(void *arg) {
    printf("Thread %d: Attempting to lock the mutex.\n", (int)arg);

    pthread_mutex_lock(&mutex);

    printf("Thread %d: Locked the mutex!\n", (int)arg);
    // ... Critical section code ...
    printf("Thread %d: Unlocking the mutex.\n", (int)arg);

    pthread_mutex_unlock(&mutex);

    return NULL;
}

int main() {
    pthread_t thread1, thread2;
    int ret;

    ret = pthread_mutex_init(&mutex, NULL);
    if (ret != 0) {
        printf("Failed to initialize mutex!\n");
        return -1;
    }

    ret = pthread_create(&thread1, NULL, thread_func, (void *)1);
    if (ret != 0) {
        printf("Failed to create thread 1!\n");
        return -1;
    }

    ret = pthread_create(&thread2, NULL, thread_func, (void *)2);
    if (ret != 0) {
        printf("Failed to create thread 2!\n");
        return -1;
    }

    pthread_join(thread1, NULL);
    pthread_join(thread2, NULL);

    pthread_mutex_destroy(&mutex);

    return 0;
}

在上述的示例中，两个线程分别调用了 pthread_mutex_lock() 和 pthread_mutex_unlock() 函数来保护临界区代码，以确保同时只有一个。

7.3 运行结果

8. putc

8.1 函数说明

函数声明	函数功能
`int putc(int c, FILE *stream);`	它是标准 `I/O` 库中定义的函数，用于将一个字符输出到指定的文件流。

参数：

c ： 要输出的字符
stream ： 指向目标文件流的指针

返回值：

成功输出的字符的 ASCII 码

8.2 演示示例

#include <stdio.h>

int main() {
    FILE *fp;
    char *str = "Hello, world!\n";

    fp = fopen("output.txt", "w");
    if (fp == NULL) {
        printf("Failed to open file for writing!\n");
        return -1;
    }

    int i = 0;
    while (str[i] != '\0') {
        putc(str[i], fp);
        i++;
    }

    fclose(fp);

    return 0;
}

在上述的示例中，我们打开名为 output.txt 的文件以供写入，并使用 putc() 函数将字符串中的每个字符逐一输出到文件中。最后，我们关闭文件。

注意： 与 putchar() 函数类似，putc() 函数可以用来逐一输出字符串中的每个字符，但通常会更多地用于将数据写入文件或其他输出流。

8.3 运行结果

9. putchar

9.1 函数说明

函数声明	函数功能
`int putchar(int c);`	它是标准 `I/O` 库中定义的函数，用于将一个字符输出到标准输出流（通常是控制台窗口）。

参数：

c ： 要输出的字符

返回值：

成功输出，则返回该字符的 ASCII 码值

9.2 演示示例

#include <stdio.h>

int main() {
    putchar('H');
    putchar('e');
    putchar('l');
    putchar('l');
    putchar('o');
    putchar(',');
    putchar(' ');
    putchar('w');
    putchar('o');
    putchar('r');
    putchar('l');
    putchar('d');
    putchar('!');
    putchar('\n');
    return 0;
}

注意： 单引号用于表示字符常量，例如 ‘H’ 表示字符 H 的 ASCII 码。

9.3 运行结果

10. putenv

10.1 函数说明

函数声明	函数功能
`int putenv(char *string);`	用于设置环境变量的值。

参数：

string ： 字符串参数，格式为 name=value，其中 name 是要设置的环境变量的名称，value 是要为其设置的值。

返回值：

0 表示成功；
非 0 表示失败。

10.2 演示示例

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

int main() {
    char *var = "MY_VAR=hello";
    int ret = putenv(var);
    if (ret != 0) {
        printf("Failed to set environment variable!\n");
        return -1;
    }

    char *val = getenv("MY_VAR");
    printf("The value of MY_VAR is: %s\n", val);

    return 0;
}

在上述的示例中，

我们首先使用 putenv() 函数将一个名为 MY_VAR 的环境变量设置为字符串 "hello"。
然后，我们使用 getenv() 函数获取 MY_VAR 环境变量的值；
最后使用 printf() 函数输出它。

注意： 由于 putenv() 函数接受一个指向可变字符串的指针，因此应该避免将局部变量的地址传递给它，以免在函数返回后出现未定义行为。

10.3 运行结果

11. putimage

11.1 函数说明

函数声明	函数功能
`void putimage(int left, int top, void *bitmap, int op);`	用于将位图图像输出到指定的窗口或屏幕上

参数：

left： 表示位图左上角的 x 坐标
top： 表示位图左上角的 y 坐标
bitmap： 一个指向位图数据的指针，这个数据必须按照指定格式存储
op： 表示绘制位图的方式，可以为以下值之一：
- COPY_PUT：覆盖模式，即将位图完全覆盖到目标位置。
- AND_PUT：按位与模式，即将位图与目标位置进行按位与运算后输出。
- OR_PUT：按位或模式，即将位图与目标位置进行按位或运算后输出。
- XOR_PUT：按位异或模式，即将位图与目标位置进行按位异或运算后输出。

11.2 演示示例

#include <graphics.h>

#define ARROW_SIZE 10

void draw_arrow(int x, int y);

int main(void)
{
   int gdriver = DETECT, gmode;
   void *arrow;
   int x, y, maxx;
   unsigned int size;

   initgraph(&gdriver, &gmode, "");

   maxx = getmaxx();
   x = 0;
   y = getmaxy() / 2;

   draw_arrow(x, y);

   size = imagesize(x, y-ARROW_SIZE, x+(4*ARROW_SIZE), y+ARROW_SIZE);

   arrow = malloc(size);

   getimage(x, y-ARROW_SIZE, x+(4*ARROW_SIZE), y+ARROW_SIZE, arrow);

   while (!kbhit())
   {
      putimage(x, y-ARROW_SIZE, arrow, XOR_PUT);

      x += ARROW_SIZE;
      if (x >= maxx)
          x = 0;

      putimage(x, y-ARROW_SIZE, arrow, XOR_PUT);
   }

   free(arrow);
   closegraph();
   return 0;
}

void draw_arrow(int x, int y)
{
   moveto(x, y);
   linerel(4*ARROW_SIZE, 0);
   linerel(-2*ARROW_SIZE, -1*ARROW_SIZE);
   linerel(0, 2*ARROW_SIZE);
   linerel(2*ARROW_SIZE, -1*ARROW_SIZE);
}

上述程序使用了 graphics.h 图形库来画一个箭头，并在屏幕上循环移动它。

首先，程序初始化图形库，然后调用 getmaxx() 和 getmaxy() 函数获取屏幕的宽度和高度。
接着，程序调用 draw_arrow() 函数来绘制箭头图形，并使用 imagesize() 函数计算出需要分配给位图数据的内存大小。
接下来，程序使用 malloc() 函数动态分配了一块内存空间，并调用 getimage() 函数获取箭头图像的位图数据。该函数会将指定位置的屏幕区域保存到指定的内存地址中。
最后，程序进入一个循环，在每次迭代中先使用 putimage() 函数将之前存储的箭头图像覆盖掉屏幕上的箭头，然后将箭头向右移动一定的距离。当用户按下任意键时，程序结束循环并退出。

11.3 运行结果

12. putpixel

12.1 函数说明

函数声明	函数功能
`void putpixel(int x, int y, int color);`	用于将一个像素点画在指定的位置上

参数：

x：表示要绘制像素的 x 坐标
y：表示要绘制像素的 y 坐标
color： 表示要绘制的像素颜色，通常为一个整数值。

12.2 演示示例

#include <graphics.h>
#include <time.h>

#define PIXEL_COUNT 1000
#define DELAY_TIME  100

int main(void)
{
    int gdriver = DETECT, gmode;
    int i, x, y, color, maxx, maxy, maxcolor, seed;

    initgraph(&gdriver, &gmode, "");

    maxx = getmaxx() + 1;
    maxy = getmaxy() + 1;
    maxcolor = getmaxcolor() + 1;

    while (!kbhit())
    {
        srand((unsigned)time(NULL));
        for (i=0; i<PIXEL_COUNT; i++)
        {
            x = rand() % maxx + 1;
            y = rand() % maxy + 1;
            color = rand() % maxcolor + 1;
            putpixel(x, y, color);
        }

        delay(DELAY_TIME);
    }

    getch();
    closegraph();
    return 0;
}

上述这个程序使用 graphics.h 图形库在屏幕上绘制随机像素点，并不断更新它们的颜色。

首先，程序初始化图形库，并调用 getmaxx()、getmaxy() 和 getmaxcolor() 函数获取屏幕的尺寸和颜色范围。
接着，程序进入一个循环，在每次迭代中使用 rand() 函数生成随机的坐标和颜色值，并使用 putpixel() 函数绘制对应位置的像素点。另外还使用了 delay() 函数来控制每次更新之间的时间间隔，该函数会使程序暂停指定的毫秒数，以便让用户观察到像素点的变化效果。
最后当用户按下任意键时，程序退出循环并结束执行。

12.3 运行结果

13. puts

13.1 函数说明

函数声明	函数功能
`int puts(const char *s);`	用于将一个字符串输出到标准输出流

参数：

s：要输出的以 '\0' 结尾的字符串

返回值：

成功输出的字符数（包括换行符）

13.2 演示示例

#include <stdio.h>

int main() {
    char *str = "Hello, world!";
    puts(str);
    return 0;
}

注意： 在输出字符串时，puts() 函数会自动将字符串的内容和换行符写入到标准输出流中，因此不需要再进行额外的操作。如果要将字符串输出到文件或其他输出流中，则可以使用 fputs() 函数。

13.3 运行结果

14. putw

14.1 函数说明

函数声明	函数功能
`int putw(int w, FILE *stream);`	用于将一个整数值以二进制形式写入到指定的文件中。

参数：

w ： 要写入的整数值
stream ： 指向要写入的文件的指针。

返回值：

如果成功，则返回写入的字节数（通常为 4 个字节）；
如果发生错误，则返回 EOF。

14.2 演示示例

#include <stdio.h>

int main() {
    int num = 42;
    FILE *fp = fopen("output.bin", "wb");

    putw(num, fp);

    fclose(fp);
    return 0;
}

在上述的示例中，

我们首先定义了一个整数变量，并使用 fopen() 函数打开一个名为 "output.bin" 的二进制文件；
接着，我们调用 putw() 函数将整数值写入到该文件中；
最后关闭文件并结束程序。

注意： 由于 putw() 函数是以二进制形式写入数据的，因此相对于文本文件而言，它更适合用于存储数字、结构体等复杂类型的数据。如果要将字符串或其他文本数据写入到文件中，则可以使用 fprintf() 函数。

14.3 运行结果

参考

[API Reference Document]

C语言函数大全--o 开头的函数

发表于 2023-04-24 更新于 2025-05-10 分类于开发语言-C

总览

函数声明	函数功能
`void obstack_init(struct obstack *obstack_ptr);`	它是 `POSIX` 标准库中的一个非标准函数，用于初始化对象堆栈。对象堆栈是一种可以动态增长以存储任意类型的对象的数据结构。其中，`obstack_ptr` 参数是一个指向 `struct obstack` 类型的指针，表示要初始化的对象堆栈。
`void obstack_free(struct obstack obstack_ptr, void object_ptr);`	用于释放通过对象堆栈分配的所有内存。其中，`obstack_ptr` 参数是一个指向 `struct obstack` 类型的指针，表示要释放的对象堆栈；`object_ptr` 参数是要释放的内存块。
`void obstack_alloc(struct obstack obstack_ptr, int size);`	用于从对象堆栈中分配指定大小的内存，并返回其地址。其中，`obstack_ptr` 参数是一个指向 `struct obstack` 类型的指针，表示要从中分配内存的对象堆栈；`size` 参数表示要分配的内存块的大小。
`void obstack_blank(struct obstack obstack_ptr, int size);`	用于向对象堆栈添加指定数量的空间，并返回指向添加的第一个字节的指针。其中，`obstack_ptr` 参数是一个指向 `struct obstack` 类型的指针，表示要添加空间的对象堆栈；`size` 参数表示要添加的空间大小。
`void obstack_grow(struct obstack obstack_ptr, const void *data, int size);`	用于将数据复制到对象堆栈，并返回指向添加的第一个字节的指针。其中，`obstack_ptr` 参数是一个指向 `struct obstack` 类型的指针，表示要添加数据的对象堆栈；`data` 参数是要复制的数据的指针；`size` 参数表示要复制的数据的大小。
`#define offsetof(type, member) ((size_t)(&((type *)0)->member))`	它是一个宏，用于获取结构体中某个成员的偏移量。
`int open(const char *path, int oflag, ...);`	用于打开文件
`int openat(int dirfd, const char *pathname, int flags, mode_t mode);`	它是 Linux 系统定义的一个函数，它可以打开一个相对于指定目录的文件。与 `open()` 函数相比，`openat()` 函数更加灵活，并支持更多的选项。
`DIR opendir(const char name);`	它是 POSIX 标准定义的一个函数，用于打开目录并返回一个指向 `DIR` 结构体类型的指针。
`int openpty(int amaster, int aslave, char name, const struct termios termp, const struct winsize *winp);`	它是 POSIX 标准定义的一个函数，用于打开一个伪终端（PTY）并返回与之关联的主从设备文件描述符。伪终端可以用于在进程之间建立通信，或者在程序中模拟终端行为。
`int on_exit(void (function)(int, void ), void *arg);`	它是 POSIX 标准定义的一个函数，用于在进程退出时调用注册的回调函数。这个函数可以用于在程序异常退出或者正常退出时执行一些清理工作、记录日志等操作
`void outtext(char *textstring);`	在图形视区显示一个字符串
`void outtextxy(int x, int y, char *textstring);`	在指定位置显示一字符串

1. obstack_init，obstack_free，obstack_alloc，obstack_blank，obstack_grow

1.1 函数说明

函数声明	函数功能
`void obstack_init(struct obstack *obstack_ptr);`	它是 `POSIX` 标准库中的一个非标准函数，用于初始化对象堆栈。对象堆栈是一种可以动态增长以存储任意类型的对象的数据结构。其中，`obstack_ptr` 参数是一个指向 `struct obstack` 类型的指针，表示要初始化的对象堆栈。
`void obstack_free(struct obstack obstack_ptr, void object_ptr);`	用于释放通过对象堆栈分配的所有内存。其中，`obstack_ptr` 参数是一个指向 `struct obstack` 类型的指针，表示要释放的对象堆栈；`object_ptr` 参数是要释放的内存块。
`void obstack_alloc(struct obstack obstack_ptr, int size);`	用于从对象堆栈中分配指定大小的内存，并返回其地址。其中，`obstack_ptr` 参数是一个指向 `struct obstack` 类型的指针，表示要从中分配内存的对象堆栈；`size` 参数表示要分配的内存块的大小。
`void obstack_blank(struct obstack obstack_ptr, int size);`	用于向对象堆栈添加指定数量的空间，并返回指向添加的第一个字节的指针。其中，`obstack_ptr` 参数是一个指向 `struct obstack` 类型的指针，表示要添加空间的对象堆栈；`size` 参数表示要添加的空间大小。
`void obstack_grow(struct obstack obstack_ptr, const void *data, int size);`	用于将数据复制到对象堆栈，并返回指向添加的第一个字节的指针。其中，`obstack_ptr` 参数是一个指向 `struct obstack` 类型的指针，表示要添加数据的对象堆栈；`data` 参数是要复制的数据的指针；`size` 参数表示要复制的数据的大小。

1.2 演示示例

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

int main(void)
{
    struct obstack my_obstack;
    const char *str1 = "Hello, ";
    const char *str2 = "World!";
    char *dst;

    obstack_init(&my_obstack);

    dst = (char *)obstack_alloc(&my_obstack, strlen(str1) + strlen(str2) + 1);
    strcpy(dst, str1);
    strcat(dst, str2);

    printf("%s\n", (char *)my_obstack.chunk);

    dst = (char *)obstack_blank(&my_obstack, sizeof(int)*2);
    int a = 100;
    int b = 200;
    memcpy(dst, &a, sizeof(int));
    memcpy(dst+sizeof(int), &b, sizeof(int));

    printf("%d %d\n", *(int *)(my_obstack.next_free-sizeof(int)*2), *(int *)(my_obstack.next_free-sizeof(int)));

    double d = 3.1415926;
    dst = (char *)obstack_grow(&my_obstack, &d, sizeof(double));

    printf("%f\n", *(double *)(my_obstack.next_free-sizeof(double)));

    obstack_free(&my_obstack, NULL);

    return 0;
}

在上述的程序中，

我们首先定义一个名为 my_obstack 的 struct obstack 类型变量，并将其传递给 obstack_init() 函数以初始化对象堆栈。
接着，我们使用 obstack_alloc() 函数从对象堆栈中分配一块内存，并将两个字符串连接起来。
然后，我们使用 obstack_blank() 函数向对象堆栈添加一块指定大小的空间，并使用 memcpy() 函数将两个整数复制到该空间中。
接下来，我们使用 obstack_grow() 函数向对象堆栈添加一个双精度浮点数，并返回指向该浮点数的指针。
最后，我们使用 printf() 函数将连接后的字符串、添加的整数和添加的双精度浮点数输出到终端，并使用 obstack_free() 函数释放通过对象堆栈分配的所有内存。

注意：在使用 obstack_blank() 函数向对象堆栈添加空间时，建议使用 sizeof 运算符来计算要添加的空间大小，并在使用 memcpy() 复制数据时也应该小心不要越界。同时，在使用 obstack_grow() 函数向对象堆栈添加数据时，需要小心指针是否正确，并且操作前需要先使用 memcpy() 将要添加的数据复制到一个临时变量中。

2. offsetof

2.1 宏说明

宏定义	宏描述
`#define offsetof(type, member) ((size_t)(&((type *)0)->member))`	它是一个宏，用于获取结构体中某个成员的偏移量。

参数：

type ： 表示结构体类型
member ： 表示结构体中的一个成员变量名

返回值： 一个 size_t 类型的值，表示该成员变量在结构体中的偏移量（单位是字节）。

2.2 演示示例

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

struct example {
    int a;
    char b;
    double c;
};

int main(void)
{
    size_t offset_b = offsetof(struct example, b);
    printf("Offset of 'b' in struct example: %zu\n", offset_b);

    return 0;
}

在这个程序中，

我们定义了一个名为 example 的结构体类型，并使用 offsetof 宏获取结构体中成员变量 b 的偏移量。
最后，我们使用 printf() 函数将结果输出到终端。

注意： 在使用 offsetof 宏时，结构体类型名称必须使用括号括起来，否则代码会产生语法错误。此外，offsetof 宏的参数必须是已定义的结构体类型名称和该结构体类型中的成员变量名称，否则也会导致编译错误。

3. open

3.1 函数说明

函数声明	函数功能
`int open(const char *path, int oflag, ...);`	用于打开文件

参数：

path ： 表示要打开的文件路径
oflag ： 表示打开文件时的选项标志，可以为以下常量之一或多个按位或组合而成：
- O_RDONLY：只读模式打开文件。
- O_WRONLY：只写模式打开文件。
- O_RDWR：读写模式打开文件。
- O_CREAT：如果文件不存在，则创建它。
- O_TRUNC：如果文件已存在，则将其长度截断为 0。
- O_APPEND：在文件末尾追加数据。
可选参数： 表示文件所有者、组和其他用户的访问权限。如果使用了 O_CREAT 选项，则必须提供这个参数

3.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <fcntl.h>

int main(void)
{
    int fd = open("temp.txt", O_RDONLY);
    if (fd == -1) {
        perror("open");
        exit(1);
    }

    char buf[1024];
    ssize_t nread;
    while ((nread = read(fd, buf, sizeof(buf))) > 0) {
        if (write(STDOUT_FILENO, buf, nread) != nread) {
            perror("write");
            exit(1);
        }
    }

    if (nread == -1) {
        perror("read");
        exit(1);
    }

    if (close(fd) == -1) {
        perror("close");
        exit(1);
    }

    return 0;
}

在上述的程序中，

我们使用 open() 函数打开文件 temp.txt，并通过 read() 函数读取其中的数据。
然后，我们使用 write() 函数将数据写入标准输出，直到读取完整个文件。
最后，我们使用 close() 函数关闭文件。

注意： 在使用 open() 函数打开文件时，返回值为负数则表示出现了错误。此时可以使用 perror() 函数输出错误信息，并使用 exit() 函数退出程序。同时，在使用 read() 函数和 write() 函数读写文件时也需要小心处理返回值，以避免出现不可预期的错误。

3.3 运行结果

4. openat

4.1 函数说明

函数声明	函数功能
`int openat(int dirfd, const char *pathname, int flags, mode_t mode);`	它是 Linux 系统定义的一个函数，它可以打开一个相对于指定目录的文件。与 `open()` 函数相比，`openat()` 函数更加灵活，并支持更多的选项。

参数：

dirfd ： 表示要打开文件所在目录的文件描述符。如果传递的是 AT_FDCWD，则表示使用当前工作目录。
pathname ： 表示要打开的文件路径
flags ： 表示打开文件时的选项标志，可以为以下常量之一或多个按位或组合而成：
- O_RDONLY：只读模式打开文件。
- O_WRONLY：只写模式打开文件。
- O_RDWR：读写模式打开文件。
- O_CREAT：如果文件不存在，则创建它。
- O_TRUNC：如果文件已存在，则将其长度截断为 0。
- O_APPEND：在文件末尾追加数据。
- O_DIRECTORY：要求打开的文件必须是一个目录。
- O_NOFOLLOW：不跟随符号链接打开文件。
mode ： 表示文件所有者、组和其他用户的访问权限。如果使用了 O_CREAT 选项，则必须提供这个参数

4.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <fcntl.h>
#include <dirent.h>

int main(void)
{
    int dirfd = open(".", O_RDONLY | O_DIRECTORY);
    if (dirfd == -1) {
        perror("open");
        exit(1);
    }

    DIR *dirp = fdopendir(dirfd);
    if (dirp == NULL) {
        perror("fdopendir");
        exit(1);
    }

    struct dirent *entry;
    while ((entry = readdir(dirp)) != NULL) {
        printf("%s\n", entry->d_name);
    }

    if (closedir(dirp) == -1) {
        perror("closedir");
        exit(1);
    }

    return 0;
}

在这个程序中，

我们使用 openat() 函数打开当前目录，并通过 fdopendir() 函数将文件描述符转换为目录流。
然后，我们使用 readdir() 函数读取目录中的文件，并将文件名输出到终端。
最后，我们使用 closedir() 函数关闭目录。

注意： 在使用 openat() 函数打开文件时，可以通过传递不同的文件描述符指定要打开的目录，从而实现更加灵活的操作。此外，在使用 readdir() 函数读取目录时也需要注意判断返回值是否为 NULL，以避免出现不可预期的错误。

5. opendir

5.1 函数说明

函数声明	函数功能
`DIR opendir(const char name);`	它是 POSIX 标准定义的一个函数，用于打开目录并返回一个指向 `DIR` 结构体类型的指针。

参数：

name ： 表示要打开的目录路径

返回值：

如果该函数执行成功，则返回一个指向 DIR 类型的指针；
否则返回 NULL。

5.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>

int main(void)
{
    DIR *dirp = opendir(".");
    if (dirp == NULL) {
        perror("opendir");
        exit(1);
    }

    struct dirent *entry;
    while ((entry = readdir(dirp)) != NULL) {
        printf("%s\n", entry->d_name);
    }

    if (closedir(dirp) == -1) {
        perror("closedir");
        exit(1);
    }

    return 0;
}

在上述的程序中，我们使用 opendir() 函数打开当前目录，并通过 readdir() 函数读取目录中的文件名，最后使用 closedir() 函数关闭目录。

注意： 在使用 opendir() 函数打开目录时，返回值为 NULL 则表示出现了错误。此时可以使用 perror() 函数输出错误信息，并使用 exit() 函数退出程序。同时，在使用 readdir() 函数读取目录时也需要小心处理返回值，以避免出现不可预期的错误。

6. openpty

6.1 函数说明

函数声明	函数功能
`int openpty(int amaster, int aslave, char name, const struct termios termp, const struct winsize *winp);`	它是 POSIX 标准定义的一个函数，用于打开一个伪终端（PTY）并返回与之关联的主从设备文件描述符。伪终端可以用于在进程之间建立通信，或者在程序中模拟终端行为。

参数：

amaster ： 表示要返回的主设备文件描述符
aslave ： 表示要返回的从设备文件描述符
name ： 表示从设备名称的缓冲区，如果不需要则可以传递 NULL
termp ： 表示要使用的终端属性，如果不需要则可以传递 NULL
winp ： 表示要使用的窗口大小，如果不需要则可以传递 NULL

返回值：

如果该函数执行成功，则返回值为 0；
否则返回 -1。

6.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <fcntl.h>
#include <termios.h>

int main(void)
{
    int master, slave;
    char buf[1024];
    ssize_t nread;

    if (openpty(&master, &slave, NULL, NULL, NULL) == -1) {
        perror("openpty");
        exit(1);
    }

    printf("Slave device: /dev/pts/%d\n", slave);

    while ((nread = read(STDIN_FILENO, buf, sizeof(buf))) > 0) {
        if (write(master, buf, nread) != nread) {
            perror("write");
            exit(1);
        }
    }

    if (nread == -1) {
        perror("read");
        exit(1);
    }

    if (close(master) == -1) {
        perror("close");
        exit(1);
    }

    return 0;
}

在上述的程序中，

我们使用 openpty() 函数打开一个伪终端，并通过 read() 函数读取标准输入中的数据。
然后，我们将数据写入主设备文件描述符；
最后关闭该设备。

注意： 在使用 openpty() 函数打开伪终端时，返回值为 -1 则表示出现了错误。此时可以使用 perror() 函数输出错误信息，并使用 exit() 函数退出程序。同时，在使用 read() 函数和 write() 函数读写文件时也需要小心处理返回值，以避免出现不可预期的错误。

7. on_exit

7.1 函数说明

函数声明	函数功能
`int on_exit(void (function)(int, void ), void *arg);`	它是 POSIX 标准定义的一个函数，用于在进程退出时调用注册的回调函数。这个函数可以用于在程序异常退出或者正常退出时执行一些清理工作、记录日志等操作

参数：

function ： 表示要注册的回调函数
arg ： 表示传递给回调函数的参数

返回值：

如果该函数执行成功，则返回值为 0；
否则返回 -1。

7.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

void cleanup(int status, void *arg)
{
    printf("Cleanup function called with status %d\n", status);
}

int main(void)
{
    if (on_exit(cleanup, NULL) != 0) {
        perror("on_exit");
        exit(EXIT_FAILURE);
    }

    printf("This is the main program\n");

    return 0;
}

在如上的程序中，

我们使用 on_exit() 函数注册了一个回调函数 cleanup()，并将其参数设置为 NULL。
然后，在主函数中输出了一条消息。当程序退出时，会自动调用回调函数来进行清理操作。

8. outtext

8.1 函数说明

函数声明	函数功能
`void outtext(char *textstring);`	在图形视区显示一个字符串

参数：

char *textstring ：指向以空字符（’\0’）结尾的字符串的指针。

8.2 演示示例

#include <graphics.h>

int main(void)
{
   int gdriver = DETECT, gmode, errorcode;
   int midx, midy;

   initgraph(&gdriver, &gmode, "");

   midx = getmaxx() / 2;
   midy = getmaxy() / 2;

   moveto(midx, midy);

   outtext("This ");
   outtext("is ");
   outtext("a ");
   outtext("test.");

   getch();
   closegraph();
   return 0;
}

在上述的程序中，

我们首先调用 initgraph() 函数初始化图形系统；
然后获取窗口的中心坐标；
接着使用 moveto() 函数将当前绘图位置移动到屏幕中心。
最后，使用 outtext() 函数输出一段文字，然后等待用户按下任意键，并关闭图形窗口。

8.3 运行结果

9. outtextxy

9.1 函数说明

函数声明	函数功能
`void outtextxy(int x, int y, char *textstring);`	在指定位置显示一字符串

参数：

int x : 字符串输出的水平起始坐标（单位为像素）。取值范围：与当前图形模式的屏幕分辨率相关（例如，640x480 模式下，x 范围为 0 到 639）。
int y : 字符串输出的垂直起始坐标（单位为像素）。取值范围：与当前图形模式的屏幕分辨率相关（例如，480p 模式下，y 范围为 0 到 479）。
char *textstring : 指向以空字符（’\0’）结尾的字符串的指针。

9.2 演示示例

#include <graphics.h>

int main(void)
{
   int gdriver = DETECT, gmode, errorcode;
   int x, y;

   initgraph(&gdriver, &gmode, "");

   x = getmaxx() / 2;
   y = getmaxy() / 2;

   outtextxy(x, y, "Hello, world!");

   getch();
   closegraph();
   return 0;
}

在上述这个程序中，

我们首先通过 initgraph() 函数初始化图形系统并创建一个窗口;
然后，定义了一个坐标位置 (x, y) 并使用 outtextxy() 函数在该位置输出一段文本。
最后，使用 getch 函数等待用户按下任意键，然后关闭图形窗口。

9.3 运行结果

C语言函数大全--n 开头的函数

发表于 2023-04-23 更新于 2025-05-10 分类于开发语言-C

总览

函数声明	函数功能
`double nan(const char *tagp);`	用于返回一个表示 NaN（非数值）的 double 类型数字
`int nanosleep(const struct timespec req, struct timespec rem);`	用于暂停当前进程的执行一段指定的时间。相比于 sleep() 函数，nanosleep() 函数可以精确地指定等待时间，以纳秒为单位。
`double nearbyint(double x);`	用于将一个浮点数四舍五入到最接近的整数值（double）
`float nearbyintf(float x);`	用于将一个浮点数四舍五入到最接近的整数值（float）
`long double nearbyintl(long double x);`	用于将一个浮点数四舍五入到最接近的整数值（long double）
`double nextafter(double x, double y);`	用于找出与给定的浮点数最接近的下一个浮点数（double）
`float nextafterf(float x, float y);`	用于找出与给定的浮点数最接近的下一个浮点数（float）
`long double nextafterl(long double x, long double y);`	用于找出与给定的浮点数最接近的下一个浮点数（long double）
`double nexttoward(double x, long double y);`	用于找出与给定的浮点数最接近、并朝着指定方向的下一个浮点数（double）
`float nexttowardf(float x, long double y);`	用于找出与给定的浮点数最接近、并朝着指定方向的下一个浮点数（float）
`long double nexttowardl(long double x, long double y);`	用于找出与给定的浮点数最接近、并朝着指定方向的下一个浮点数（long double）
`locale_t newlocale(int category_mask, const char *locale, locale_t base);`	用于创建并返回一个新的本地化环境变量，以便在不同的本地化设置之间进行切换。
`int nftw(const char dirpath, int (fn)(const char fpath, const struct stat sb, int typeflag, struct FTW *ftwbuf), int nopenfd, int flags);`	用于递归遍历指定目录下的所有文件和子目录，并对每个文件或目录执行指定操作。
`int nice(int inc);`	它是一个系统调用，可将进程截止到当前用户的最大优先级减少指定的优先级，以更改进程的调度优先级。较高的 niceness 值意味着较低的优先级。
`char *nl_langinfo(nl_item item);`	它是一个 `POSIX` 标准函数，用于获取当前本地化环境下的语言环境信息。它可以返回一些与语言、货币、日期和时间格式等相关的信息。
`long nrand48(unsigned short xsubi[3]);`	用于生成带有指定状态的随机数。它使用 48 位整数来表示随机数的状态，可以方便地切换不同的随机数生成器状态。
`uint32_t ntohl(uint32_t netlong);`	用于将网络字节序（大端序）转换为主机字节序（小端序）。
`uint16_t ntohs(uint16_t netshort);`	用于将网络字节序（大端序）转换为主机字节序（小端序）。

1. nan

1.1 函数说明

函数声明	函数功能
`double nan(const char *tagp);`	用于返回一个表示 NaN（非数值）的 double 类型数字

参数：

tagp ： 指向字符串的指针；用于指定 NaN 数字的类型。如果不需要指定类型，则可以将该参数设置为 NULL。

1.2 演示示例

#include <stdio.h>
#include <math.h>

int main(void)
{
    double x = 0.0 / 0.0;  // 使用除 0 运算符来生成 NaN 数字
    printf("x: %f\n", x);

    double y = nan(NULL);  // 使用 nan() 函数来生成 NaN 数字
    printf("y: %f\n", y);

    return 0;
}

注意： NaN 数字具有一些特殊的属性，例如与任何数字进行比较都会返回 false，因此在实际编程中需要特别小心处理 NaN 的情况，避免出现异常结果

1.3 运行结果

2. nanosleep

2.1 函数说明

函数声明	函数功能
`int nanosleep(const struct timespec req, struct timespec rem);`	用于暂停当前进程的执行一段指定的时间。相比于 sleep() 函数，nanosleep() 函数可以精确地指定等待时间，以纳秒为单位。

参数：

req ： 指向 timespec 结构体的指针，用于指定要等待的时间。timespec 结构体包含两个成员变量：tv_sec 表示等待时间的整数部分（秒），tv_nsec 表示等待时间的小数部分（纳秒）。如果 rem 参数不为 NULL，则在函数返回时，未完成的等待时间将被存储在 rem 指向的 timespec 结构体中。
rem ： 未完成的等待时间

2.2 演示示例

#include <stdio.h>
#include <time.h>

int main(void)
{
    struct timespec req = { 0 };
    req.tv_sec = 2;         // 等待时间为 2 秒
    req.tv_nsec = 5000000;  // 加上 5 毫秒

    int ret = nanosleep(&req, NULL);
    if (ret == 0) {
        printf("nanosleep completed\n");
    } else {
        printf("nanosleep interrupted by signal\n");
    }

    return 0;
}

在上述的程序中，

我们首先创建一个 timespec 结构体变量 req，用于指定等待时间。在本例中，我们将等待时间设置为 2 秒加上 5 毫秒。
接着，我们调用 nanosleep() 函数，并传递 req 变量的地址作为第一个参数。如果函数执行成功（即完成了预定的等待时间），则返回值为 0，否则返回 -1。
最后，我们检查函数的返回值，以确定 nanosleep() 是否成功完成。如果返回值为 0，则表示函数已经完成了预定的等待时间；如果返回值为 -1，则说明函数被信号中断。在实际编程中，我们还可以通过检查 errno 变量来获取更具体的错误信息。

3. nearbyint，nearbyintf，nearbyintl

3.1 函数说明

函数声明	函数功能
`double nearbyint(double x);`	用于将一个浮点数四舍五入到最接近的整数值（double）
`float nearbyintf(float x);`	用于将一个浮点数四舍五入到最接近的整数值（float）
`long double nearbyintl(long double x);`	用于将一个浮点数四舍五入到最接近的整数值（long double）

3.2 演示示例

#include <stdio.h>
#include <math.h>

int main(void)
{
    double x = 2.3;
    double y = -1.8;

    double z = nearbyint(x);   // 将 2.3 四舍五入到 2
    double w = nearbyint(y);   // 将 -1.8 四舍五入到 -2

    printf("x: %lf, nearbyint(x): %lf\n", x, z);
    printf("y: %lf, nearbyint(y): %lf\n", y, w);

    float xf = 2.5;
    printf("xf: %f, nearbyintf(xf): %f\n", xf, nearbyintf(xf));

    long double xL = -1.3;
    printf("xL: %Lf, nearbyintl(xL): %Lf\n", xL, nearbyintl(xL));

    return 0;
}

注意： nearbyint() 函数对于 0.5 的情况具有特殊处理：如果要转换的数恰好与两个整数的距离相等，则按照偶数方向进行舍入（即选择更接近偶数的整数）。例如，如果要将 2.5 转换为整数，那么将近似到最接近的偶数 2，而不是 3。这种舍入方式称为 “银行家舍入法” 或 “四舍六入五成双”。

3.3 运行结果

4. nextafter，nextafterf，nextafterl

4.1 函数说明

函数声明	函数功能
`double nextafter(double x, double y);`	用于找出与给定的浮点数最接近的下一个浮点数（double）
`float nextafterf(float x, float y);`	用于找出与给定的浮点数最接近的下一个浮点数（float）
`long double nextafterl(long double x, long double y);`	用于找出与给定的浮点数最接近的下一个浮点数（long double）

参数：

x ： 要查找其下一个浮点数的浮点数
- y ： 给定浮点数的目标值，表示前进方向。

返回值：

如果 y 大于 x，则向正无穷方向查找；
如果 y 小于 x，则向负无穷方向查找；如果 y 等于 x，则返回 y。

4.2 演示示例

#include <stdio.h>
#include <math.h>

int main(void)
{
    double x = 1.0;
    double y = 2.0;

    printf("nextafter(%lf, %lf): %.20lf\n", x, y, nextafter(x, y));      
    printf("nextafter(%lf, %lf): %.20lf\n", y, x, nextafter(y, x));

    float xf = 2.0;
    float yf = 1.0;
    printf("nextafterf(%f, %f): %.20f\n", xf, yf, nextafterf(xf, yf));   

    long double xL = -1.2;
    long double yL = - 1.5;   
    printf("nextafterl(%Lf, %Lf): %.20Lf\n", xL, yL, nextafterl(xL, yL));      

    return 0;
}

注意： 由于计算机内部存储浮点数的方式是有限制的，因此在进行浮点数计算时可能会存在误差。在实际编程中，我们应该特别小心处理这些情况，避免出现异常结果。

4.3 运行结果

5. nexttoward，nexttowardf，nexttowardl

5.1 函数说明

函数声明	函数功能
`double nexttoward(double x, long double y);`	用于找出与给定的浮点数最接近、并朝着指定方向的下一个浮点数（double）
`float nexttowardf(float x, long double y);`	用于找出与给定的浮点数最接近、并朝着指定方向的下一个浮点数（float）
`long double nexttowardl(long double x, long double y);`	用于找出与给定的浮点数最接近、并朝着指定方向的下一个浮点数（long double）

参数：

x ： 要查找其下一个浮点数的浮点数
y ： 给定浮点数的目标值，表示前进方向。

返回值：

如果 y 大于 x，则向正无穷方向查找；
如果 y 小于 x，则向负无穷方向查找；如果 y 等于 x，则返回 y。

5.2 演示示例

#include <stdio.h>
#include <math.h>

int main(void)
{
    double x = 1.0;
    long double y = 2.0;

    printf("nexttoward(%lf, %Lf): %.20lf\n", x, y, nexttoward(x, y)); 

    float xf = 3.2;
    printf("nexttowardf(%f, %Lf): %.20f\n", xf, y, nexttowardf(xf, y)); 

    long double xL = 1.9;
    printf("nexttowardl(%Lf, %Lf): %.20Lf\n", xL, y, nexttowardl(xL, y)); 

    return 0;
}

5.3 运行结果

6. newlocale

6.1 函数说明

函数声明	函数功能
`locale_t newlocale(int category_mask, const char *locale, locale_t base);`	用于创建并返回一个新的本地化环境变量，以便在不同的本地化设置之间进行切换。

参数：

category_mask ： 指定了要创建的本地化环境变量包含哪些类别。可以使用下列常量按位或来指定：
- LC_ALL_MASK：表示所有类别。
- LC_COLLATE_MASK：表示字符串比较和排序规则。
- LC_CTYPE_MASK：表示字符分类和转换规则。
- LC_MESSAGES_MASK：表示本地化消息文本。
- LC_MONETARY_MASK：表示货币格式。
- LC_NUMERIC_MASK：表示数字格式。
- LC_TIME_MASK：表示时间和日期格式。
locale ： 指定了要使用的区域设置名称。如果为 NULL 或空字符串，则使用当前系统默认的本地化设置。
base ： 指定了要基于的基础本地化环境变量。如果为 NULL，则使用 LC_GLOBAL_LOCALE。

6.2 演示示例

#include <stdio.h>
#include <locale.h>

int main()
{
    // 创建一个新的本地化环境变量，用于解析德语字符串比较和排序规则。
    locale_t loc = newlocale(LC_COLLATE_MASK, "de_DE.UTF-8", LC_GLOBAL_LOCALE);

    // 在新的本地化环境变量下比较两个字符串，并输出比较结果。
    const char *str1 = "äbc";
    const char *str2 = "abc";
    int result = strcoll_l(str1, str2, loc);
    printf("%s %s %s\n", str1, (result < 0 ? "<" : (result > 0 ? ">" : "==")), str2);

    // 释放本地化环境变量
    freelocale(loc);

    return 0;
}

在上述程序中，

我们首先使用 newlocale() 函数创建一个新的本地化环境变量 loc，以便比较和排序德语字符串。
接着，我们使用 strcoll_l() 函数来在新的本地化环境变量下比较两个字符串 str1 和 str2。
最后，我们输出比较结果，并使用 freelocale() 函数释放 loc 变量。

注意： 在实际编程中应该特别注意本地化设置对字符处理、货币格式、时间格式等方面的影响，避免出现不必要的错误。

7. nftw

7.1 函数说明

函数声明	函数功能
`int nftw(const char dirpath, int (fn)(const char fpath, const struct stat sb, int typeflag, struct FTW *ftwbuf), int nopenfd, int flags);`	用于递归遍历指定目录下的所有文件和子目录，并对每个文件或目录执行指定操作。

参数：

dirpath ： 要遍历的目录路径
fn ： 一个回调函数，用于在遍历过程中对每个文件或目录执行指定操作。该函数的参数如下：
- fpath ： 当前文件的完整路径。
- sb ： 当前文件的 struct stat 结构体指针，包含了当前文件的各种属性信息。
- typeflag ： 表示当前文件的类型，可能为以下值之一：
  - FTW_F：普通文件。
  - FTW_D：目录。
  - FTW_DNR：无法读取的目录。
  - FTW_NS：无法访问的文件（可能是因为权限问题）。
  - FTW_SL：符号链接。
  - FTW_DP：与 FTW_D 相同，但目录本身还未被访问。
  - FTW_SLN：符号链接，指向不存在的文件。
- ftwbuf ： 一个 struct FTW 结构体指针，包含了一些关于遍历状态的信息。
nopenfd ： 最大打开文件描述符数
flags ： 控制遍历行为的标志位，可以使用下列常量按位或来指定：
- FTW_CHDIR：进入目录后更改工作目录。
- FTW_DEPTH：深度优先遍历。
- FTW_MOUNT：不跨越文件系统边界。
- FTW_PHYS：不跟随符号链接。

7.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <ftw.h>

static int count = 0;

int print_file_info(const char *fpath, const struct stat *sb, int typeflag, struct FTW *ftwbuf)
{
    // 打印文件路径和类型
    printf("%s ", fpath);
    if (typeflag == FTW_F) {
        printf("(file)\n");
    } else if (typeflag == FTW_D) {
        printf("(dir)\n");
    } else {
        printf("(other)\n");
    }

    // 计数器加一
    count++;

    return 0;
}

int main(void)
{
    int result = nftw(".", print_file_info, 10, FTW_PHYS);

    if (result == -1) {
        perror("nftw");
        exit(EXIT_FAILURE);
    }

    printf("Total files and directories: %d\n", count);

    return 0;
}

在上述的程序中，

我们首先定义了一个回调函数 print_file_info()，用于打印每个文件或目录的路径和类型，并将计数器加一。
接着，我们调用 nftw() 函数来递归遍历当前目录下的所有文件和子目录，并对每个文件或目录执行 print_file_info() 函数。
最后，我们输出遍历总数。

注意： 在实际编程中应该特别注意文件访问权限等问题，以避免出现不必要的错误。

7.3 运行结果

8. nice

8.1 函数说明

函数声明	函数功能
`int nice(int inc);`	它是一个系统调用，可将进程截止到当前用户的最大优先级减少指定的优先级，以更改进程的调度优先级。较高的 niceness 值意味着较低的优先级。

参数：

inc ： 要增加或减少的优先级值。如果 inc 的值为正数，则表示将进程的优先级降低；如果 inc 的值为负数，则表示将进程的优先级提高。通常情况下，只有具有 root 权限的进程才能将自己的优先级升高。

8.2 演示示例

#include <stdio.h>
#include <unistd.h>

int main(void)
{
    // 输出当前进程的初始优先级
    printf("Initial nice value: %d\n", nice(0));

    // 将进程的优先级减少 10
    int result = nice(10);
    if (result == -1) {
        perror("nice");
    } else {
        printf("New nice value: %d\n", result);
    }

    return 0;
}

在上述程序中，

我们首先使用 nice(0) 函数输出当前进程的初始优先级；
接着，我们使用 nice(10) 函数将进程的调度优先级降低 10；
最后将新的优先级值输出到终端。

注意： 由于 nice() 函数并不是标准 C 库中的函数，因此在编译时需要传递 -posix 参数或其他类似参数以启用 POSIX 标准。在实际编程中应该特别注意优先级修改对进程正常运行的影响，以避免出现不必要的错误。

9. nl_langinfo

9.1 函数说明

函数声明	函数功能
`char *nl_langinfo(nl_item item);`	它是一个 `POSIX` 标准函数，用于获取当前本地化环境下的语言环境信息。它可以返回一些与语言、货币、日期和时间格式等相关的信息。

参数：

item ： 指定要获取的本地化信息。可以使用下列常量之一来指定：
- ABDAY_*：星期缩写名称（0 ~ 6 表示周日到周六）。
- DAY_*：星期全称（0 ~ 6 表示周日到周六）。
- ABMON_*：月份缩写名称（0 ~ 11 表示一月到十二月）。
- MON_*：月份全称（0 ~ 11 表示一月到十二月）。
- AM_STR：上午字符串。
- PM_STR：下午字符串。
- D_FMT：日期格式字符串。
- T_FMT：时间格式字符串。
- ERA：纪元字符串。
- ERA_D_T_FMT：带日期和时间的纪元字符串。
- ERA_D_FMT：仅带日期的纪元字符串。
- ERA_T_FMT：仅带时间的纪元字符串。
- ALT_DIGITS：非十进制数字字符。

9.2 演示示例

#include <stdio.h>
#include <langinfo.h>

int main(void)
{
    char *time_fmt = nl_langinfo(T_FMT);
    char *date_fmt = nl_langinfo(D_FMT);

    printf("Time format: %s\n", time_fmt);
    printf("Date format: %s\n", date_fmt);

    return 0;
}

在上述的程序中，

我们使用 nl_langinfo(T_FMT) 函数获取当前本地化环境下的时间格式字符串，并将其输出到终端。
接着，我们使用 nl_langinfo(D_FMT) 函数获取当前本地化环境下的日期格式字符串，并将其输出到终端。

注意： 在实际编程中应该特别注意处理不同本地化环境下信息的差异，以避免出现不必要的错误。

10. nrand48

10.1 函数说明

函数声明	函数功能
`long nrand48(unsigned short xsubi[3]);`	用于生成带有指定状态的随机数。它使用 48 位整数来表示随机数的状态，可以方便地切换不同的随机数生成器状态。

参数：

xsubi ： 一个包含 3 个 16 位无符号整数的数组，表示了当前随机数生成器的状态。如果想更改随机数生成器的状态，只需修改 xsubi 数组即可。

10.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <time.h>

int main(void)
{
    unsigned short seed[3];
    seed[0] = (unsigned short) time(NULL);
    seed[1] = (unsigned short) getpid();
    seed[2] = 12345;

    srand48(seed);

    printf("Random number: %ld\n", nrand48(seed));

    return 0;
}

在上述的程序中，

我们首先创建了一个包含 3 个 16 位无符号整数的数组 seed，并将其用作随机数生成器的种子。
接着，我们使用 srand48() 函数初始化随机数生成器，并使用 nrand48() 函数生成一个随机数，并将其输出到终端。

注意： 由于 nrand48() 函数生成的是伪随机数，因此在实际使用时需要注意选择足够复杂的种子，并采取适当的加密措施以避免出现不必要的安全问题。

11. ntohl，ntohs

11.1 函数说明

函数声明	函数功能
`uint32_t ntohl(uint32_t netlong);`	用于将网络字节序（大端序）转换为主机字节序（小端序）。
`uint16_t ntohs(uint16_t netshort);`	用于将网络字节序（大端序）转换为主机字节序（小端序）。

参数：

netlong ： 表示要转换的 32 位整数。
netshort ： 表示要转换的 16 位整数。

11.2 演示示例

#include <stdio.h>
#include <stdint.h>
#include <netinet/in.h>

int main(void)
{
    uint32_t num1 = 0x12345678;
    uint16_t num2 = 0x5678;

    printf("Original value (hex):\n");
    printf("num1: %08X\n", num1);
    printf("num2: %04X\n", num2);

    num1 = ntohl(num1);
    num2 = ntohs(num2);

    printf("Converted value (hex):\n");
    printf("num1: %08X\n", num1);
    printf("num2: %04X\n", num2);

    return 0;
}

注意： 在实际编程中应该特别注意不同平台之间的字节序差异，以避免出现不必要的错误。

C语言函数大全--m 开头的函数（下）

发表于 2023-04-22 更新于 2025-05-10 分类于开发语言-C

总览

函数声明	函数功能
`int mkdirat(int dirfd, const char *pathname, mode_t mode);`	它是一个 `Linux` 系统下的系统调用函数，用于在指定目录下创建新的子目录
`int mkfifo(const char *pathname, mode_t mode);`	它是一个 `Linux` 系统下的系统调用函数，用于创建命名管道
`int mkstemp(char *template);`	用于在磁盘上创建一个唯一的临时文件并打开它以进行读写
`int mkdir(const char *pathname, mode_t mode);`	它是一个 `Linux` 系统下的系统调用函数，用于创建新目录
`int mkdir(const char *pathname);`	它是在 `Windows` 系统下的系统调用函数，用于创建新目录
`time_t mktime(struct tm *timeptr);`	用于将表示时间的结构体（struct tm）转换为对应的 Unix 时间戳
`int mlock(const void *addr, size_t len);`	它是一个 `Linux` 系统下的系统调用函数，用于将指定内存区域锁定在物理内存中，防止其被交换到磁盘上
`void mmap(void addr, size_t length, int prot, int flags, int fd, off_t offset);`	它是一个 `Linux` 系统下的系统调用函数，可以将一个文件或者设备映射到内存中，并返回指向该内存区域的指针
`double modf(double x, double *iptr);`	用于将浮点数 `value` 拆分为其整数部分和小数部分（double）
`float modff(float value, float *iptr);`	用于将浮点数 `value` 拆分为其整数部分和小数部分（float）
`long double modfl(long double value, long double *iptr);`	用于将浮点数 `value` 拆分为其整数部分和小数部分（long double）
`int mount(const char source, const char target, const char filesystemtype, unsigned long mountflags, const void data);`	用于将文件系统挂载到指定的挂载点，并返回挂载点的文件描述符
`int msync(void *addr, size_t length, int flags);`	用于将指定内存区域的数据同步到文件中
`int munmap(void *addr, size_t length);`	用于取消内存映射区域，并释放与之相关的资源
`int munlock(const void *addr, size_t len);`	用于将之前使用mlock()函数锁定的内存区域解锁，使其可被操作系统交换出去或被回收

1. mkdirat

1.1 函数说明

函数声明	函数功能
`int mkdirat(int dirfd, const char *pathname, mode_t mode);`	它是一个 `Linux` 系统下的系统调用函数，用于在指定目录下创建新的子目录

参数：

dirfd ： 要在其下创建新目录的父目录的文件描述符。如果值为 AT_FDCWD，则表示使用当前工作目录
pathname ： 要创建的新目录的名称和路径
mode ： 要创建的新目录的权限模式

返回值：

如果成功创建新目录时，则返回 0；
如果失败时，则返回 -1，并设置错误码（errno）。

1.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <fcntl.h>
#include <sys/stat.h>
#include <unistd.h>

int main() 
{
    int dirfd;
    if ((dirfd = open("/tmp", O_RDONLY)) == -1) 
    {
        printf("Error opening directory.\n");
        return 1;
    }

    if (mkdirat(dirfd, "testdir", S_IRWXU | S_IRGRP | S_IXGRP | S_IROTH | S_IXOTH) == -1) 
    {
        printf("Error creating directory.\n");
        return 1;
    }

    close(dirfd);
    return 0;
}

在上述的示例代码中，

首先，我们打开 /tmp 目录并获取其文件描述符 dirfd；
然后，我们调用 mkdirat() 函数，并将目录的文件描述符、要创建的新目录的名称和路径以及目录的权限模式作为参数传递给函数。如果函数调用成功，则新目录将在 /tmp 目录下创建。
最后，调用 close() 函数关闭文件。

注意：

使用 mkdirat() 函数时，我们需要确保指定的父目录存在并具有适当的权限。
如果要使用相对路径创建新目录，需要确保当前工作目录正确设置。

2. mkfifo

2.1 函数说明

函数声明	函数功能
`int mkfifo(const char *pathname, mode_t mode);`	它是一个 `Linux` 系统下的系统调用函数，用于创建命名管道

参数：

pathname ： 要创建的命名管道的名称和路径
mode ： 命名管道的权限模式

返回值：

如果成功创建命名管道时，则返回 0；
如果失败时，则返回 -1，并设置错误码（errno）。

2.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <sys/stat.h>
#include <fcntl.h>

int main() 
{
    // 如果函数调用成功，则在 /tmp 目录下创建一个名为 myfifo 的命名管道
    if (mkfifo("/tmp/myfifo", S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP) == -1) 
    {
        printf("Error creating named pipe.\n");
        return 1;
    }

    return 0;
}

注意：

使用 mkfifo() 函数时，我们需要确保指定的路径可被访问并且不存在同名的文件或目录。
如果要使用相对路径创建命名管道，需要确保当前工作目录正确设置。

3. mkstemp

3.1 函数说明

函数声明	函数功能
`int mkstemp(char *template);`	用于在磁盘上创建一个唯一的临时文件并打开它以进行读写

参数：

template ： 指向包含 6 个连续 'X' 的字符串的指针，这些 'X' 将被替换为随机字符以创建唯一的文件名。例如，"/tmp/tempfile-XXXXXX" 将会被替换为类似 "/tmp/tempfile-5ZqYU2" 的唯一文件名。

3.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

int main() 
{
    char temp_file_template[] = "tmp/tempfile-XXXXXX";
    int fd;

    if ((fd = mkstemp(temp_file_template)) == -1) 
    {
        printf("Error creating temporary file.\n");
        return 1;
    }

    printf("Temporary file created: %s\n", temp_file_template);

    // 读写临时文件

    // 关闭临时文件
    close(fd);
    return 0;
}

如上演示了，在 windows 下创建临时文件：

首先，我们定义了一个字符串 temp_file_template，它包含连续的 6 个 'X'；
接着，我们调用 mkstemp() 函数，并将指向 temp_file_template 的指针作为参数传递给函数。如果函数调用成功，则返回新创建文件的文件描述符，并将 temp_file_template 中的 'X' 替换为随机字符以形成唯一的文件名；
然后，调用 printf() 函数，输出该临时文件的名称；
再接着，可以使用 fd 来操作临时文件【这里示例省略了】；
再然后，临时文件使用完毕，调用 close() 函数关闭临时文件。
最后，返回 0 表示程序执行成功。

注意： 在使用 mkstemp() 函数时，我们需要确保提供的模板字符串至少包含 6 个 'X'，并且文件命名方式不能与现有文件冲突。

3.3 运行结果

4. mkdir

4.1 函数说明

函数声明	函数功能
`int mkdir(const char *pathname, mode_t mode);`	它是一个 `Linux` 系统下的系统调用函数，用于创建新目录
`int mkdir(const char *pathname);`	它是在 `Windows` 系统下的系统调用函数，用于创建新目录

参数：

pathname： 要创建的新目录的名称和路径
mode ： 要创建的新目录的权限模式

返回值：

如果成功创建新目录时，则返回 0；
如果失败时，则返回 -1，并设置错误码（errno）。

4.2 演示示例

4.2.1 Windows 下示例

#include <stdio.h>
#include <stdlib.h> 
#include <sys/stat.h>

int main() 
{
    if (mkdir("tmp/newdir") == -1) 
    {
        printf("Error creating new directory.\n");
        return 1;
    }

    return 0;
}

4.2.1 Linux 下示例

#include <stdio.h>
#include <stdlib.h> 
#include <sys/stat.h>
#include <sys/types.h>

int main() 
{
    if (mkdir("/tmp/newdir", S_IRWXU | S_IRGRP | S_IXGRP | S_IROTH | S_IXOTH) == -1) 
    {
        printf("Error creating new directory.\n");
        return 1;
    }

    return 0;
}

4.3 运行结果

Windows 下示例运行结果

5. mktime

5.1 函数说明

函数声明	函数功能
`time_t mktime(struct tm *timeptr);`	用于将表示时间的结构体（struct tm）转换为对应的 Unix 时间戳

参数：

timeptr ： 指向 struct tm 结构体的指针，其中包含要转换为 Unix 时间戳的日期和时间信息

返回值：

如果转换成功，则返回对应于输入时间的 Unix 时间戳；
如果转换失败，则返回 -1。

5.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <time.h>

int main() 
{
    struct tm my_time = {0};  // 初始化为 0，避免随机值影响结果
    my_time.tm_year = 2023 - 1900;  // 年份应该减去 1900
    my_time.tm_mon = 4 - 1;  // 月份从 0 开始计数，应该减去 1
    my_time.tm_mday = 15;
    my_time.tm_hour = 10;
    my_time.tm_min = 30;
    my_time.tm_sec = 0;

    time_t timestamp = mktime(&my_time);
    if (timestamp == -1) 
    {
        printf("Error converting time to timestamp.\n");
        return 1;
    }

    printf("Unix timestamp: %lld\n", timestamp);

    return 0;
}

在上面的示例代码中，

首先，我们创建一个 struct tm 结构体 my_time，并将其初始化为 0；
然后，设置结构体的年、月、日、时、分、秒等信息。这里的年份应该减去 1900，月份应该从 0 开始计数减去 1；
接着，调用 mktime() 函数，并将指向 my_time 结构体的指针作为参数传递给函数。如果函数调用成功，则返回对应于输入时间的 Unix 时间戳。
最后，输出该 Unix 时间戳。

注意：

在使用 mktime() 函数时，我们需要确保提供的 struct tm 结构体中的所有字段都已正确设置。
由于 mktime() 函数所使用的时区可能与系统默认的时区不同，所以在某些情况下，转换结果可能会有一定偏差。

5.3 运行结果

6. mlock

6.1 函数说明

函数声明	函数功能
`int mlock(const void *addr, size_t len);`	它是一个 `Linux` 系统下的系统调用函数，用于将指定内存区域锁定在物理内存中，防止其被交换到磁盘上

参数：

addr ： 要锁定的内存区域的起始地址
len ： 要锁定的内存区域的长度（字节数）

返回值：

如果成功锁定内存区域时，则返回 0；
如果失败时，则返回 -1，并设置错误码（errno）。

6.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <string.h>   // memset 函数所需头文件
#include <sys/mman.h> // mlock 函数所需头文件

#define PAGE_SIZE 4096  // 页大小

int main() 
{
    char *buf;
    size_t size = PAGE_SIZE;

    // 分配一段内存并清零
    buf = (char *)malloc(size);
    memset(buf, 0, size);

    // 锁定分配的内存区域
    if (mlock(buf, size) == -1) 
    {
        printf("Error locking memory.\n");
        return 1;
    }

    // 使用分配的内存...
    strncpy(buf, "Hello world!", size);
    printf("%s\n", buf);

    // 解锁内存区域
    if (munlock(buf, size) == -1) 
    {
        printf("Error unlocking memory.\n");
        return 1;
    }

    free(buf);
    return 0;
}

在上述的示例代码中，

首先，我们使用 malloc() 函数分配了一个页大小的内存区域，并使用 memset() 函数将其清零；
然后，调用 mlock() 函数，并将指向分配内存区域起始地址的指针以及内存区域的长度作为参数传递给函数。如果函数调用成功，则锁定分配的内存区域，防止其被交换到磁盘上；
接着，就可以对该内存区域进行读写操作【示例代码简单演示了使用 strncpy() 函数向上述的分配内存区域中写入字符串 "Hello world!"，并通过 printf() 函数输出该字符串】；
再接着，调用 munlock() 函数解除内存区域的锁定；
最后，释放分配内容，并正常结束程序。

注意： 在使用 mlock() 函数时，我们需要确保指定的内存区域已正确分配并且足够大，以避免锁定错误的内存区域。

7. mmap

7.1 函数说明

函数声明	函数功能
`void mmap(void addr, size_t length, int prot, int flags, int fd, off_t offset);`	它是一个 `Linux` 系统下的系统调用函数，可以将一个文件或者设备映射到内存中，并返回指向该内存区域的指针

参数：

addr ： 映射区域开始地址，通常为 NULL，由内核选定
length ： ：映射区域的长度（字节数）
prot ： 映射区域的保护方式。其可能的取值如下【按位或（|）组合】：
- PROT_NONE: 区域不能被访问。
- PROT_READ: 区域可被读取。
- PROT_WRITE: 区域可被写入。
- PROT_EXEC: 区域可被执行。
flags ： 制定映射区域的类型和其他标志。其可能的取值如下【按位或（|）组合】：
- MAP_SHARED: 允许多个进程共享该映射区域，对映射区域所做的修改将反映到所有共享该区域的进程中。
- MAP_PRIVATE: 该映射区域只允许当前进程进行访问，对映射区域所做的修改不会反映到其他进程中。
- MAP_FIXED: 强制将映射区域放置在指定的地址处（如果该地址已经被占用，则会导致错误）。
- MAP_ANONYMOUS: 创建一个匿名映射区域，不与任何文件关联。
- MAP_FILE: 将映射区域与文件关联，需要指定文件描述符和偏移量。
- MAP_LOCKED: 指示内核在物理存储器中锁定映射区域的页面，以确保在访问该区域时不会发生缺页中断。
fd ： 要映射的文件描述符
offset ： 文件映射的起始偏移量

7.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <sys/mman.h>
#include <fcntl.h>
#include <unistd.h>

int main() 
{
    int fd;
    char *ptr;

    // 打开文件
    if ((fd = open("example.txt", O_RDWR)) == -1) 
    {
        printf("Error opening file.\n");
        return 1;
    }

    // 将文件映射到内存中
    ptr = mmap(NULL, 4096, PROT_READ | PROT_WRITE, MAP_SHARED, fd, 0);
    if (ptr == MAP_FAILED) 
    {
        printf("Error mapping file.\n");
        return 1;
    }

    // 使用映射区域进行读写操作
    strncpy(ptr, "Hello world!", 13);
    printf("%s\n", ptr);

    // 取消映射并关闭文件
    if (munmap(ptr, 4096) == -1) 
    {
        printf("Error unmapping file.\n");
        return 1;
    }
    close(fd);

    return 0;
}

上述的示例代码，演示了如何使用 mmap() 函数将一个文件映射到内存中，并使用指针 ptr 访问这个映射区域 :

首先，我们调用 open() 函数打开文件 "example.txt"，并检查是否成功打开。
接着，调用 mmap() 函数将文件的前 4096 字节映射到内存中，同时指定保护方式为可读写（PROT_READ | PROT_WRITE）以及共享属性（MAP_SHARED）。
然后，如果映射成功，则使用 strncpy() 函数向映射区域中写入字符串 "Hello world!"，并通过 printf() 函数输出该字符串。
最后，调用 munmap() 函数取消映射，并关闭文件。

8. modf，modff，modfl

8.1 函数说明

函数声明	函数功能
`double modf(double x, double *iptr);`	用于将浮点数 `value` 拆分为其整数部分和小数部分（double）
`float modff(float value, float *iptr);`	用于将浮点数 `value` 拆分为其整数部分和小数部分（float）
`long double modfl(long double value, long double *iptr);`	用于将浮点数 `value` 拆分为其整数部分和小数部分（long double）

参数：

value ： 待处理的浮点数
iptr ： 用于返回 value 的整数部分

8.2 演示示例

#include <stdio.h>
#include <math.h>

int main() 
{
    double x = 3.141592653589793;
    double ipart;

    double fpart = modf(x, &ipart);

    printf("x = %f\n", x);
    printf("整数部分 = %.0f\n", ipart);
    printf("小数部分 = %f\n", fpart);

    float y = 2.718281828459045;
    float ipart_f;

    float fpart_f = modff(y, &ipart_f);

    printf("y = %f\n", y);
    printf("整数部分 = %.0f\n", ipart_f);
    printf("小数部分 = %f\n", fpart_f);

    long double z = 1.414213562373095;
    long double ipart_l;

    long double fpart_l = modfl(z, &ipart_l);

    printf("z = %Lf\n", z);
    printf("整数部分 = %.0Lf\n", ipart_l);
    printf("小数部分 = %Lf\n", fpart_l);

    return 0;
}

8.3 运行结果

9. mount

9.1 函数说明

函数声明	函数功能
`int mount(const char source, const char target, const char filesystemtype, unsigned long mountflags, const void data);`	用于将文件系统挂载到指定的挂载点，并返回挂载点的文件描述符

参数：

source ： 要挂载的文件系统。可以是一个设备文件名、一个目录路径或者 NULL（表示根据 filesystemtype 参数自动选择默认源）
target ： 要挂载到的目标点，即挂载点
filesystemtype ： 要挂载的文件系统类型
mountflags ： 挂载选项
data ： 任意与文件系统相关的数据

9.2 演示示例

#include <stdio.h>
#include <sys/mount.h>

int main() 
{
    int ret;
    const char* source = "/dev/sda1";
    const char* target = "/mnt/usbdrive";
    const char* type = "ext4";

    ret = mount(source, target, type, 0, NULL);
    if (ret == -1) 
    {
        perror("mount");
        return 1;
    }

    printf("File system mounted successfully!\n");

    return 0;
}

在上面的示例代码中，我们调用 mount() 函数将 /dev/sda1 设备文件上的 ext4 文件系统挂载到 /mnt/usbdrive 目录下，并检查挂载操作是否成功。如果 mount() 函数返回值为 -1，则表示挂载失败，通过 perror() 函数输出错误信息并返回 1，程序异常结束；否则，打印 “File system mounted successfully!” 表示挂载成功，并返回 0，程序正常结束。

10. msync

10.1 函数说明

函数声明	函数功能
`int msync(void *addr, size_t length, int flags);`	用于将指定内存区域的数据同步到文件中

参数：

addr ： 要同步的内存起始地址
length ： 要同步的内存区域长度
flags ： 同步选项，可以是以下值之一：
- MS_ASYNC： 进行异步写操作（默认选项）
- MS_SYNC： 进行同步写操作
- MS_INVALIDATE： 使 cache 内容无效

10.2 演示示例

#include <stdio.h>
#include <sys/mman.h>
#include <fcntl.h>
#include <unistd.h>
#include <string.h>

int main() 
{
    int fd = open("example.txt", O_RDWR);
    if (fd == -1) 
    {
        perror("open");
        return 1;
    }

    // 将文件映射到内存中
    char* ptr = mmap(NULL, 4096, PROT_READ | PROT_WRITE, MAP_SHARED, fd, 0);
    if (ptr == MAP_FAILED) 
    {
        perror("mmap");
        close(fd);
        return 1;
    }

    // 写入新的数据
    strncpy(ptr, "Hello world!", 13);

    // 同步数据到文件中
    int ret = msync(ptr, 4096, MS_SYNC);
    if (ret == -1) 
    {
        perror("msync");
        munmap(ptr, 4096);
        close(fd);
        return 1;
    }

    // 解除映射并关闭文件
    ret = munmap(ptr, 4096);
    if (ret == -1) 
    {
        perror("munmap");
        close(fd);
        return 1;
    }
    close(fd);

    return 0;
}

在上面的示例代码中，

首先，我们通过 open() 函数打开文件 "example.txt"；
然后，使用 mmap() 函数将文件的前 4096 字节映射到内存中；
接着，调用 strncpy() 函数向映射区域中写入新的数据，并通过 msync() 函数将修改后的数据同步回磁盘文件；
最后，调用 munmap() 函数解除映射并关闭文件。

11. munmap

11.1 函数说明

函数声明	函数功能
`int munmap(void *addr, size_t length);`	用于取消内存映射区域，并释放与之相关的资源

参数：

addr ： 要取消映射的内存起始地址
length ： 要取消映射的内存区域长度

在调用 munmap() 函数后，操作系统将取消指定的内存映射，并回收相应的资源，包括虚拟地址空间和关联的物理内存页（如果存在）。此外，取消映射还可能导致未同步到磁盘文件中的修改数据丢失。

注意： 必须在对映射区域进行任何修改或者访问之前，先使用 mmap() 函数将文件映射到内存中；并在完成所有操作之后，再使用 munmap() 函数解除映射。否则，可能会引发各种错误或者异常情况。

11.2 演示示例

参见 7.2 的演示示例，这里不再赘述

12. munlock

12.1 函数说明

函数声明	函数功能
`int munlock(const void *addr, size_t len);`	用于将之前使用mlock()函数锁定的内存区域解锁，使其可被操作系统交换出去或被回收

参数：

addr ： 待解锁的内存区域的起始地址
len ： 待解锁的内存区域的长度（以字节为单位）

返回值：

如果成功解锁时，则返回 0；
如果失败时，则返回 -1，并设置错误码（errno）。

注意： 只有拥有相应权限的进程才能解锁该内存区域。

12.2 演示示例

参见 6.2 的演示示例，这里不再赘述

C语言函数大全--m 开头的函数（上）

发表于 2023-04-22 更新于 2025-05-07 分类于开发语言-C

总览

函数声明	函数功能
`void *malloc(size_t size);`	用于动态分配内存
`int mblen(const char *s, size_t n);`	检查多字节字符的长度
`size_t mbrlen(const char s, size_t n, mbstate_t ps);`	检查多字节字符的长度
`size_t mbrtowc(wchar_t pwc, const char s, size_t n, mbstate_t *ps);`	将多字节字符转换为宽字符
`int mbsinit(const mbstate_t *ps);`	检查转换状态是否为起始状态
`size_t mbstowcs(wchar_t pwcs, const char s, size_t n);`	用于将多字节字符序列转换为宽字符序列。
`size_t mbsrtowcs(wchar_t dst, const char src, size_t len, mbstate_t ps);`	用于将多字节字符序列转换为宽字符序列，并在转换过程中自动更新 mbstate_t 转换状态结构体。
`int mbtowc(wchar_t restrict pwc, const char restrict s, size_t n);`	用于将一个多字节字符 (Multibyte Character) 转换成一个宽字符 (Wide Character)。
`void memccpy(void restrict dst, const void *restrict src, int c, size_t n);`	用于将内存块的内容复制到另一个内存块中，并在指定字符出现时停止复制。
`void memchr(const void s, int c, size_t n);`	用于在某一内存块中查找指定字符的位置。
`void memcpy(void dest, const void *src, size_t n);`	用于将源内存块中的 n 个字节复制到目标内存块中。
`int memcmp(const void s1, const void s2, size_t n);`	用于比较两个内存块的内容是否相同。
`void memmove(void dest, const void *src, size_t n);`	用于将源内存块中的 n 个字节复制到目标内存块中。与 `memcpy()` 函数不同的是，`memmove()` 函数在复制过程中会处理内存块重叠的情况。
`void memset(void s, int c, size_t n);`	用于将一个内存块中的所有字节都设置为指定的值。
`errno_t memset_s(void *s, rsize_t smax, int c, rsize_t n);`	C11 标准新增了一个名为 `memset_s()` 的安全版本函数。与 `memset()` 函数不同的是，`memset_s()` 函数会在设置内存块值时检查目标内存块大小，并防止缓冲区溢出、重叠等安全问题。

1. malloc

1.1 函数说明

函数声明	函数功能
`void *malloc(size_t size);`	用于动态分配内存

参数：

size ： 需要分配的内存大小（以字节为单位）

返回值：

如果分配成功，返回分配的内存块的指针；
如果分配失败，则返回 NULL。

1.2 演示示例

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

int main()
{
    char *str = NULL;

    // 分配内存
    str = (char *)malloc(20 * sizeof(char));

    if (str == NULL)
    {
        printf("Failed to allocate memory.\n");
        return 1;
    }

    // 将字符串复制到内存中
    strcpy(str, "Hello, world!");

    // 输出字符串
    printf("%s\n", str);

    // 释放内存
    free(str);

    return 0;
}

在上面的示例程序中，

我们首先声明一个指向字符型的指针 str，并将其初始化为 NULL；
然后使用 malloc() 函数动态分配了 20 字节的内存空间，并将其赋值给 str 指针；
接下来，我们使用 strcpy() 函数将字符串 "Hello, world!" 复制到内存中，并使用 printf() 函数输出字符串；
最后，我们使用 free() 函数释放了分配的内存空间。

1.3 运行结果

2. mblen

2.1 函数说明

函数声明	函数功能
`int mblen(const char *s, size_t n);`	检查多字节字符的长度

参数：

s ： 指向待检查的多字节字符或多字节字符序列的指针
n ： 要检查的最大字节数

注意： 如果 s 是空指针，则返回 0，表示不是多字节字符；否则，如果 n 不足以包含完整的多字节字符，则返回 -1，表示需要更多的输入；否则，返回多字节字符所需的字节数。

2.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <locale.h>

int main()
{
    // 设置本地化环境
    setlocale(LC_ALL, "");

    char str[] = u8"你好，世界！";
    int len;

    // 检查第一个字符的长度
    len = mblen(str, MB_CUR_MAX);

    if (len == -1)
    {
        printf("Failed to determine the length of the multibyte character.\n");
        return 1;
    }

    printf("The length of the first multibyte character is %d bytes.\n", len);

    return 0;
}

在上面的示例程序中，

我们首先使用 setlocale() 函数设置本地化环境，以便正确处理多字节字符。
然后我们定义了一个包含中文字符的字符串 str；
接着使用 mblen() 函数检查第一个字符的长度，并将其保存到变量 len 中。
最后，我们输出该字符的长度。

2.3 运行结果

3. mbrlen

3.1 函数说明

函数声明	函数功能
`size_t mbrlen(const char s, size_t n, mbstate_t ps);`	检查多字节字符的长度

参数：

s ： 指向待检查的多字节字符或多字节字符序列的指针
n ： 要检查的最大字节数
ps ： 描述转换状态的 mbstate_t 结构体的指针

注意： 如果 s 是空指针，则返回 0，表示不是多字节字符；否则，如果 n 不足以包含完整的多字节字符，则返回 (size_t)-2，表示需要更多的输入；否则，如果 ps 是 NULL，则使用默认转换状态；否则，将 ps 的值更新为已经转换的字符数，并返回多字节字符所需的字节数。

3.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <wchar.h>
#include <locale.h>

int main()
{
    // 设置本地化环境
    setlocale(LC_ALL, "");

    char str[] = u8"你好，世界！";
    int len;

    // 检查第一个字符的长度
    len = mbrlen(str, MB_CUR_MAX, NULL);

    if (len == (size_t)-2) // 特殊的返回值，表示发生了错误
    {
        printf("Failed to determine the length of the multibyte character.\n");
        return 1;
    }

    printf("The length of the first multibyte character is %d bytes.\n", len);

    return 0;
}

在上面的示例程序中，

我们首先使用 setlocale() 函数设置本地化环境，以便正确处理多字节字符。
然后我们定义了一个包含中文字符的字符串 str；
接着使用 mbrlen() 函数检查第一个字符的长度，并将其保存到变量 len 中。
最后，我们输出该字符的长度。

3.3 运行结果

4. mbrtowc

4.1 函数说明

函数声明	函数功能
`size_t mbrtowc(wchar_t pwc, const char s, size_t n, mbstate_t *ps);`	将多字节字符转换为宽字符

参数：

pwc ： 一个指向宽字符的指针，表示将要存入转换后的宽字符；
s ： 一个指向多字节字符或字符序列的指针；
n ： 一个表示最多转换的字节数的整数；
ps ： 一个指向转换状态的指针，如果为 NULL，则使用默认转换状态。

返回值：

如果能转换，返回转换的字符数；
如果不能转换，则返回 (size_t)-1。

4.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <locale.h>
#include <wchar.h>

int main()
{
    // 设置本地化环境
    setlocale(LC_ALL, "");

    char str[] = u8"你好，世界！";
    wchar_t wc;
    mbstate_t state = {0};

    // 将第一个字符转换为宽字符
    size_t len = mbrtowc(&wc, str, MB_CUR_MAX, &state);

    if (len == (size_t)-1)
    {
        printf("Failed to convert multibyte character.\n");
        return 1;
    }

    // 输出宽字符
    wprintf(L"The first wide character is: %lc\n", wc);

    return 0;
}

在上面的示例程序中，

我们首先使用 setlocale() 函数设置本地化环境，以便正确处理多字节字符。
然后我们定义了一个包含中文字符的字符串 str；
接着使用 mbrtowc() 函数将第一个字符转换为宽字符，并将其保存到变量 wc 中。
最后，我们使用 wprintf() 函数输出宽字符。

注意： 在调用 mbrtowc() 函数之前，必须将 mbstate_t 结构体的值初始化为 0。在 C99 标准中，可以使用大括号对结构体进行初始化，这会把结构体或数组的每个元素都初始化为默认值（0 或 NULL）。

4.3 运行结果

5. mbsinit

5.1 函数说明

函数声明	函数功能
`int mbsinit(const mbstate_t *ps);`	检查转换状态是否为起始状态
参数：

ps ： 指向 mbstate_t 结构体的指针，表示要检查的转换状态。

注意： 如果 ps 是空指针，则返回非零值（真），表示默认转换状态已经初始化；否则，如果 ps 描述的转换状态是起始状态，则返回非零值（真）；否则，返回 0（假）。

5.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <locale.h>
#include <wchar.h>

int main()
{
    // 设置本地化环境
    setlocale(LC_ALL, "");

    char str[] = u8"你好，世界！";
    mbstate_t state = {0};

    // 检查转换状态是否为起始状态
    if (!mbsinit(&state))
    {
        printf("The conversion state is not initial.\n");
        return 1;
    }

    // 打印转换状态
    printf("The conversion state is %s.\n", (mbsinit(&state) ? "initial" : "not initial"));

    return 0;
}

在上面的示例程序中，

我们首先定义了一个包含中文字符的字符串 str 和一个转换状态结构体 state；
然后我们使用 mbsinit() 函数检查转换状态是否为起始状态;
最后在控制台输出 "The conversion state is initial."。

5.3 运行结果

6. mbstowcs

6.1 函数说明

函数声明	函数功能
`size_t mbstowcs(wchar_t pwcs, const char s, size_t n);`	用于将多字节字符序列转换为宽字符序列。
参数：

pwcs ： 指向存储结果宽字符序列的缓冲区的指针
s ： 待转换的多字节字符序列
n ： 缓冲区的最大长度（以宽字符数计）

返回值：

如果成功地将多字节字符序列转换为宽字符序列，则该函数返回实际写入缓冲区中的宽字符数，不包括空字符 \0；
如果遇到了无效的多字节字符或编码，或者宽字符缓冲区不足，导致转换失败，则该函数返回 (size_t)-1。

6.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <locale.h>
#include <wchar.h>

int main()
{
    // 设置本地化环境
    setlocale(LC_ALL, "");

    char str[] = u8"你好，世界！";
    wchar_t wcbuf[20];

    // 将多字节字符序列转换为宽字符序列
    size_t ret = mbstowcs(wcbuf, str, sizeof(wcbuf)/sizeof(wchar_t));

    if (ret == (size_t)-1)
    {
        printf("Failed to convert multibyte character sequence.\n");
        return 1;
    }

    // 在控制台输出宽字符序列及其长度
    wprintf(L"The wide character string is: %ls (%zu characters)\n", wcbuf, ret);

    return 0;
}

在上面的示例程序中，我们首先定义了一个包含中文字符的字符串 str 和一个用于存储结果宽字符序列的缓冲区 wcbuf。然后我们使用 mbstowcs() 函数将多字节字符序列转换为宽字符序列，并在控制台输出相应的信息。

注意： 在计算缓冲区大小时，必须将其指定为宽字符数（即 sizeof(wcbuf)/sizeof(wchar_t)），而不是字节数或字符数。这是因为在 Windows 等一些操作系统中，wchar_t 类型并不总是占用固定的字节数，而可能会根据编译器和平台而变化。

6.3 运行结果

7. mbstowcs

7.1 函数说明

函数声明	函数功能
`size_t mbsrtowcs(wchar_t dst, const char src, size_t len, mbstate_t ps);`	用于将多字节字符序列转换为宽字符序列，并在转换过程中自动更新 mbstate_t 转换状态结构体。

参数：

dst： 指向存储结果宽字符序列的缓冲区的指针
src ： 指向待转换的多字节字符序列的指针的指针
len ： 缓冲区的最大长度（以宽字符数计）
ps ： 指向包含转换状态信息的结构体 mbstate_t 的指针

返回值：

如果成功地将多字节字符序列转换为宽字符序列，则该函数返回实际写入缓冲区中的宽字符数，不包括空字符 \0；
如果遇到了无效的多字节字符或编码，或者宽字符缓冲区不足，导致转换失败，则该函数返回 (size_t)-1。

注意： mbsrtowcs() 函数会自动更新转换状态结构体 mbstate_t，以记录上一次调用的状态并在下一次调用时继续使用。这使得 mbsrtowcs() 函数适用于处理长的、包含部分多字节字符的字符串。它会自动识别和处理多字节字符序列中的部分字符，并等待更多的字节，直到可以完成转换为止。

7.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <locale.h>
#include <wchar.h>

int main()
{
    // 设置本地化环境
    setlocale(LC_ALL, "");

    char str[] = u8"你好，世界！";
    wchar_t wcbuf[20];
    mbstate_t state = {0};

    // 将多字节字符序列转换为宽字符序列
    size_t ret = mbsrtowcs(wcbuf, (const char**)&str, sizeof(wcbuf)/sizeof(wchar_t), &state);
    if (ret == (size_t)-1)
    {
        printf("Failed to convert multibyte character sequence.\n");
        return 1;
    }

    // 在控制台输出宽字符序列及其长度
    wprintf(L"The wide character string is: %ls (%zu characters)\n", wcbuf, ret);

    return 0;
}

8. mbtowc

8.1 函数说明

函数声明	函数功能
`int mbtowc(wchar_t restrict pwc, const char restrict s, size_t n);`	用于将一个多字节字符 (Multibyte Character) 转换成一个宽字符 (Wide Character)。

参数：

pwc ： 指向存储宽字符的指针。
s ： 指向要转换的多字节字符的指针。
n ： 要转换的最大字节数。

返回值：

如果转换成功，则返回转换后的宽字符数；
如果遇到无效的多字节字符，则返回 -1；
如果传递了空指针，则返回 0。

8.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <locale.h>
#include <wchar.h>

int main(void)
{
    setlocale(LC_ALL, "");

    char mbstr[] = "Hello, world!";
    wchar_t wc;
    int len = mbtowc(&wc, mbstr, sizeof(mbstr));
    if (len > 0) {
        wprintf(L"%lc\n", wc);
    } else if (len == 0) {
        wprintf(L"Empty string.\n");
    } else if (len == -1) {
        wprintf(L"Invalid multibyte character.\n");
    }

    return EXIT_SUCCESS;
}

8.3 运行结果

9. memccpy

9.1 函数说明

函数声明	函数功能
`void memccpy(void restrict dst, const void *restrict src, int c, size_t n);`	用于将内存块的内容复制到另一个内存块中，并在指定字符出现时停止复制。
参数：

dst ： 要复制到的目标内存块的指针
src ： 要从中复制数据的源内存块的指针
c ： 指定的字符值
n ： 要复制的字节数

返回值：

如果源内存块的前 n 个字节中包含字符 c，则返回指向字符 c 后面一个字节的指针；
否则返回 NULL。

9.2 演示示例

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

int main(void)
{
    char src[] = "Hello, world!";
    char dst[20];
    memset(dst, 0, sizeof(dst));

    char *p = (char*) memccpy(dst, src, 'o', sizeof(src));
    if (p) {
        printf("'%c' found at index %ld\n", *(p - 1), p - dst - 1);
    } else {
        printf("'%c' not found\n", 'o');
    }

    printf("%s\n", dst);

    return 0;
}

9.3 运行结果

10. memchr

10.1 函数说明

函数声明	函数功能
`void memchr(const void s, int c, size_t n);`	用于在某一内存块中查找指定字符的位置。

参数：

s ： 要进行查找的内存块的起始地址
c ： 要查找的指定字符，以整数形式表示
n ： 要查找的字节数，即在前 n 个字节中查找指定字符

10.2 演示示例

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

int main(void)
{
    char str[] = "Hello, world!";
    char ch = 'w';
    char *p;

    // 在字符串中查找指定字符
    p = (char*) memchr(str, ch, strlen(str));
    if (p) {
        printf("'%c' found at index %ld\n", ch, p - str);
    } else {
        printf("'%c' not found\n", ch);
    }

    return EXIT_SUCCESS;
}

在上述程序中，

我们首先定义了一个字符串 str 和要查找的指定字符 ch；
然后使用 memchr() 函数查找字符串 str 中是否包含指定字符 ch；
最后如果找到了该字符，则输出它的索引位置；否则，输出未找到的提示信息。

10.3 运行结果

11. memcpy

11.1 函数说明

函数声明	函数功能
`void memcpy(void dest, const void *src, size_t n);`	用于将源内存块中的 n 个字节复制到目标内存块中。

参数：

dest ： 目标内存块的起始地址
src ： 源内存块的起始地址
n ： 要复制的字节数

11.2 演示示例

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

int main(void)
{
    char src[] = "Hello, world!";
    char dst[20];
    memset(dst, 0, sizeof(dst));

    // 将源字符串复制到目标字符串中
    memcpy(dst, src, strlen(src));

    printf("%s\n", dst);

    return 1;
}

注意： 在使用 memcpy() 函数进行内存复制时，目标内存块必须足够大，以容纳源内存块中的全部内容。否则，复制过程可能会导致访问非法内存空间，从而导致代码异常或崩溃。因此，在进行内存复制时，应该尽量避免超出目标内存块大小的范围。

11.3 运行结果

12. memcmp

12.1 函数说明

函数声明	函数功能
`int memcmp(const void s1, const void s2, size_t n);`	用于比较两个内存块的内容是否相同。

参数：

s1 ： 要进行比较的第一个内存块的起始地址
s2 ： 要进行比较的第二个内存块的起始地址
n ： 要比较的字节数。

注意： memcmp() 函数会逐一比较两个内存块中对应位置上的字节大小，直到找到差异或者比较完全部字节。

如果两个内存块完全相同，则返回值为 0；
如果两个内存块不同，则返回值是两个内存块中第一个不同字节处的差值（s1 中该字节的值减去 s2 中该字节的值）。

12.2 演示示例

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

int main(void)
{
    char str1[] = "Hello, world!";
    char str2[] = "Hello, everyone!";

    // 比较两个字符串
    int result = memcmp(str1, str2, strlen(str1));
    printf("result = %d\n", result);
    if (result == 0) {
        printf("Strings are equal\n");
    } else if (result < 0) {
        printf("String '%s' is smaller than string '%s'\n", str1, str2);
    } else {
        printf("String '%s' is larger than string '%s'\n", str1, str2);
    }

    return 1;
}

注意： 在比较两个内存块时，应该确保被比较的内存块中包含足够的字节，并且待比较的字节数不超过内存块大小，否则函数可能会出现异常行为。另外，由于返回值是有符号整数类型，因此在比较时应该将其强制转换为无符号整数类型，以避免出现不必要的错误。

12.3 运行结果

13. memmove

13.1 函数说明

函数声明	函数功能
`void memmove(void dest, const void *src, size_t n);`	用于将源内存块中的 n 个字节复制到目标内存块中。与 `memcpy()` 函数不同的是，`memmove()` 函数在复制过程中会处理内存块重叠的情况。

参数：

dest ： 目标内存块的起始地址
src ： 源内存块的起始地址
n ： 要复制的字节数。

注意： memmove() 函数会将源内存块中的前 n 个字节复制到目标内存块中，并返回指向目标内存块起始地址的指针。

13.2 演示示例

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

int main(void)
{
    char str[] = "Hello, world!";
    char tmp[20];
    memset(tmp, 0, sizeof(tmp));

    // 将源字符串复制到目标字符串中（处理重叠的情况）
    memmove(tmp, str + 6, strlen(str) - 6);

    printf("%s\n", tmp);

    return 0;
}

注意： 在使用 memmove() 函数进行内存复制时，目标内存块必须足够大，以容纳源内存块中的全部内容。否则，复制过程可能会导致访问非法内存空间，从而导致代码异常或崩溃。此外，由于 memmove() 函数的处理开销较大，因此在不涉及内存块重叠时，应该尽量使用 memcpy() 函数以提高效率。

13.3 运行结果

14. memset，memset_s

14.1 函数说明

函数声明	函数功能
`void memset(void s, int c, size_t n);`	用于将一个内存块中的所有字节都设置为指定的值。
`errno_t memset_s(void *s, rsize_t smax, int c, rsize_t n);`	C11 标准新增了一个名为 `memset_s()` 的安全版本函数。与 `memset()` 函数不同的是，`memset_s()` 函数会在设置内存块值时检查目标内存块大小，并防止缓冲区溢出、重叠等安全问题。

memset 参数：

s ： 要进行设置的内存块的起始地址
c ： 要设置的值，以整数形式表示
n ： 要设置的字节数

memset_s 参数：

s ： 要进行设置的内存块的起始地址
smax ： 目标内存块的大小
c ： 要设置的值，以整数形式表示
n ： 要设置的字节数

14.2 演示示例

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

int main(void)
{
    char str[21] = {'\0'};
    memset(str, 'A', sizeof(str) - 1);
    printf("%s\n", str);
    return 0;
}

14.3 运行结果

参考

[API Reference Document]

C语言函数大全-- l 开头的 Linux 内核函数(链表管理函数)

发表于 2023-04-21 更新于 2025-04-29 分类于开发语言-C

总览

函数声明	函数功能
`void list_add(struct list_head new, struct list_head head);`	它是 Linux 内核中双向链表操作的一个基本函数，用于将新节点添加到双向链表的头部
`void list_add_tail(struct list_head new, struct list_head head);`	它是 Linux 内核中双向链表操作的一个基本函数，用于将新节点添加到链表尾部。
`void list_cut_before(struct list_head new, struct list_head head, struct list_head *entry);`	它是 Linux 内核中双向链表操作的一个基本函数，用于将一段节点从原始链表中移动到另一个链表中，并将其添加到新链表的头部。
`void list_cut_position(struct list_head new, struct list_head head, struct list_head *entry);`	它是 Linux 内核中双向链表操作的一个基本函数，用于将一段节点从原始链表中移动到另一个链表中，并将其添加到新链表的头部。与list_cut_before不同的是，该函数需要指定要移动的节点的具体位置，而不是直接指定一个节点。
`void list_del(struct list_head *entry);`	用于从链表中删除一个节点，但不会修改该节点的指针信息。
`void list_del_init(struct list_head *entry);`	用于从链表中删除一个节点，但会将被删除的节点的指针信息初始化为NULL。
`void list_del_init_careful(struct list_head entry, struct list_head prev, struct list_head *next);`	用于从链表中删除一个节点，但需要指定该节点的前驱节点和后继节点，以确保链表结构正确。
`int list_empty(const struct list_head *head);`	用于判断链表是否为空，并返回非零值表示为空，返回0表示不为空
`int list_empty_careful(const struct list_head *head);`	用于判断链表是否为空，但会先检查链表头部的指针是否为空，以避免对空指针进行解引用。
`void list_move(struct list_head list, struct list_head head);`	用于将一个节点移动到另外一个链表的头部。
`void list_move_tail(struct list_head list, struct list_head head);`	用于将一个节点移动到另外一个链表的尾部。
`void list_bulk_move_tail(struct list_head list, int count, struct list_head head);`	用于将多个节点从一个链表移动到另一个链表的尾部。
`void list_replace(struct list_head old, struct list_head new);`	用于用一个新节点替换指定节点。
`void list_replace_init(struct list_head old, struct list_head new);`	除了可以完成 list_replace 做的所有操作外，它还将原来的节点初始化为空。
`static inline void list_rotate_left(struct list_head *head)`	用于将链表向左旋转一个位置。
`void list_rotate_to_front(struct list_head head, struct list_head pivot);`	用于将指定节点移到链表头部，并旋转链表使得该节点成为新的头部。
`void list_splice(struct list_head list, struct list_head head);`	用于将一个链表中的所有节点插入到另一个链表的指定位置之前。
`void list_splice_tail(struct list_head list, struct list_head head);`	用于将一个链表中的所有节点插入到另一个链表的尾部。
`void list_splice_init(struct list_head list, struct list_head head);`	除了可以完成 `list_splice` 做的所有操作外，它还将原来的链表初始化为空。
`void list_splice_tail_init(struct list_head list, struct list_head head);`	除了可以完成 `list_splice_tail` 做的所有操作外，它还将原来的链表初始化为空。
`void list_swap(struct list_head list1, struct list_head list2);`	交换两个链表头部的位置。

1. list_add，list_add_tail

1.1 函数说明

函数声明	函数功能
`void list_add(struct list_head new, struct list_head head);`	它是 Linux 内核中双向链表操作的一个基本函数，用于将新节点添加到双向链表的头部
`void list_add_tail(struct list_head new, struct list_head head);`	它是 Linux 内核中双向链表操作的一个基本函数，用于将新节点添加到链表尾部。
参数：

new ： 要添加的新节点的指针
head ： 链表头节点的指针。
- list_add() 函数会将 new 节点插入到链表头之前，使其成为新的链表头节点。
- list_add_tail() 函数会根据链表头节点找到链表尾节点，并将 new 节点添加到链表尾部。

1.2 演示示例

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

struct list_head {
    struct list_head *next, *prev;
};

struct node {
    int data;
    struct list_head link;
};

void init_list_head(struct list_head *head)
{
    head->next = head->prev = head;
}

void print_list(struct list_head *head)
{
    struct node *p;
    for (p = (struct node *)head->next; p != (struct node *)head; p = (struct node *)p->link.next) {
        printf("%d ", p->data);
    }
    printf("\n");
}

int main()
{
    struct list_head head = { NULL, NULL };
    init_list_head(&head); // 用于初始化双向链表头部节点。

    struct node *n1 = (struct node *)malloc(sizeof(struct node));
    n1->data = 1;
    list_add(&n1->link, &head); // 将节点添加到链表的头部

    struct node *n2 = (struct node *)malloc(sizeof(struct node));
    n2->data = 2;
    list_add(&n2->link, &head);

    struct node *n3 = (struct node *)malloc(sizeof(struct node));
    n3->data = 3;
    list_add_tail(&n3->link, &head); // 将节点添加到链表的尾部

    printf("The original list is: ");
    print_list(&head);

    return 0;
}

在上述示例代码中，我们首先定义了 list_head 和 node 两个结构体，并通过调用 init_list_head() 函数初始化链表头部。然后，我们创建了三个 node 类型的节点，前两个节点分别通过 list_add() 函数将它们添加到链表的头部，最后一个节点通过 list_add_tail() 函数添加到链表的尾部。最后，我们调用 print_list() 函数打印链表中的元素。

注意： 在使用 list_add() 和 list_add_tail() 函数之前，我们要为每个新节点分配内存空间。

2. list_cut_before，list_cut_position

2.1 函数说明

函数声明	函数功能
`void list_cut_before(struct list_head new, struct list_head head, struct list_head *entry);`	它是 Linux 内核中双向链表操作的一个基本函数，用于将一段节点从原始链表中移动到另一个链表中，并将其添加到新链表的头部。
`void list_cut_position(struct list_head new, struct list_head head, struct list_head *entry);`	它是 Linux 内核中双向链表操作的一个基本函数，用于将一段节点从原始链表中移动到另一个链表中，并将其添加到新链表的头部。与list_cut_before不同的是，该函数需要指定要移动的节点的具体位置，而不是直接指定一个节点。

参数：

new ： 要添加的新链表头部；
head ： 原始链表的头部
entry ： 要移动的节点

list_cut_before() 函数会将 entry 节点及其前面的所有节点从原始链表中移动到 new 所指示的链表中，并将 entry 所在位置的前一个节点作为新链表的头节点。
list_cut_position() 函数会将 entry 节点及其后面的所有节点从原始链表中移动到 new 所指示的链表中，并将 entry 所在位置作为新链表的头节点。

2.2 演示示例

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

struct list_head {
    struct list_head *next, *prev;
};

struct node {
    int data;
    struct list_head link;
};

void init_list_head(struct list_head *head)
{
    head->next = head->prev = head;
}

void print_list(struct list_head *head)
{
    struct node *p;
    for (p = (struct node *)head->next; p != (struct node *)head; p = (struct node *)p->link.next) {
        printf("%d ", p->data);
    }
    printf("\n");
}

int main()
{
    struct list_head head1 = { NULL, NULL };
    init_list_head(&head1);

    struct node *n1 = (struct node *)malloc(sizeof(struct node));
    n1->data = 1;
    list_add_tail(&n1->link, &head1);

    struct node *n2 = (struct node *)malloc(sizeof(struct node));
    n2->data = 2;
    list_add_tail(&n2->link, &head1);

    struct node *n3 = (struct node *)malloc(sizeof(struct node));
    n3->data = 3;
    list_add_tail(&n3->link, &head1);

    printf("The original list is: ");
    print_list(&head1);

    struct list_head head2 = { NULL, NULL };
    init_list_head(&head2);

    // 移动节点n1和n2到另一个链表中
    list_cut_before(&head2, &head1, &n2->link);
    printf("The first list after move is: ");
    print_list(&head1);
    printf("The second list after move is: ");
    print_list(&head2);

    // 再次移动节点n3到另一个链表中
    list_cut_position(&head2, &head1, &n3->link);
    printf("The first list after second move is: ");
    print_list(&head1);
    printf("The second list after second move is: ");
    print_list(&head2);

    return 0;
}

在上述示例代码中，我们首先定义了 list_head 和 node 两个结构体，并通过调用 init_list_head() 函数初始化两个链表的头部。然后，我们创建了三个 node 类型的节点并分别将它们添加到第一个链表的尾部。接着，我们利用list_cut_before()函数和 list_cut_position() 函数将链表中的一段节点移动到第二个链表中。最后，我们调用 print_list 函数分别打印两个链表中的元素。

3. list_del，list_del_init，list_del_init_careful

3.1 函数说明

函数声明	函数功能
`void list_del(struct list_head *entry);`	用于从链表中删除一个节点，但不会修改该节点的指针信息。
`void list_del_init(struct list_head *entry);`	用于从链表中删除一个节点，但会将被删除的节点的指针信息初始化为NULL。
`void list_del_init_careful(struct list_head entry, struct list_head prev, struct list_head *next);`	用于从链表中删除一个节点，但需要指定该节点的前驱节点和后继节点，以确保链表结构正确。

参数：

entry ： 要删除的节点
prev ： 该节点的前驱节点
next ： 该节点的后继节点

3.2 演示示例

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

struct list_head {
    struct list_head *next, *prev;
};

struct node {
    int data;
    struct list_head link;
};

void init_list_head(struct list_head *head)
{
    head->next = head->prev = head;
}

void print_list(struct list_head *head)
{
    struct node *p;
    for (p = (struct node *)head->next; p != (struct node *)head; p = (struct node *)p->link.next) {
        printf("%d ", p->data);
    }
    printf("\n");
}

int main()
{
    struct list_head head = { NULL, NULL };
    init_list_head(&head);

    struct node *n1 = (struct node *)malloc(sizeof(struct node));
    n1->data = 1;
    list_add_tail(&n1->link, &head);

    struct node *n2 = (struct node *)malloc(sizeof(struct node));
    n2->data = 2;
    list_add_tail(&n2->link, &head);

    struct node *n3 = (struct node *)malloc(sizeof(struct node));
    n3->data = 3;
    list_add_tail(&n3->link, &head);

    printf("The original list is: ");
    print_list(&head);

    // 删除节点n2，但不改变其指针信息
    list_del(&n2->link);
    printf("The list after delete n2 is: ");
    print_list(&head);

    // 删除节点n3，并初始化其指针信息为NULL
    list_del_init(&n3->link);
    printf("The list after delete and init n3 is: ");
    print_list(&head);

    // 删除节点n1，并指定其前驱和后继节点
    list_del_init_careful(&n1->link, &head, head.next);
    printf("The list after careful delete n1 is: ");
    print_list(&head);

    return 0;
}

在上述示例代码中，我们首先定义了 list_head 和 node 两个结构体，并通过调用 init_list_head() 函数初始化链表头部。然后，我们创建了三个 node 类型的节点并分别将它们添加到链表的尾部。接下来，我们利用 list_del()、 list_del_init() 和 list_del_init_careful() 函数从链表中删除节点，并打印每次操作后的链表元素。

注意： 在使用这些函数之前，我们要确保被删除的节点在链表中。

4. list_empty，list_empty_careful

4.1 函数说明

函数声明	函数功能
`int list_empty(const struct list_head *head);`	用于判断链表是否为空，并返回非零值表示为空，返回0表示不为空
`int list_empty_careful(const struct list_head *head);`	用于判断链表是否为空，但会先检查链表头部的指针是否为空，以避免对空指针进行解引用。

参数：

head ： 要判断的链表头部

4.2 演示示例

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

struct list_head {
    struct list_head *next, *prev;
};

struct node {
    int data;
    struct list_head link;
};

void init_list_head(struct list_head *head)
{
    head->next = head->prev = head;
}

void print_list(struct list_head *head)
{
    struct node *p;
    for (p = (struct node *)head->next; p != (struct node *)head; p = (struct node *)p->link.next) {
        printf("%d ", p->data);
    }
    printf("\n");
}

int main()
{
    struct list_head head = { NULL, NULL };
    init_list_head(&head);

    printf("Is the list empty? %d\n", list_empty(&head));
    printf("Is the list empty carefully? %d\n", list_empty_careful(&head));

    struct node *n1 = (struct node *)malloc(sizeof(struct node));
    n1->data = 1;
    list_add_tail(&n1->link, &head);

    printf("The list after adding n1: ");
    print_list(&head);
    printf("Is the list empty? %d\n", list_empty(&head));
    printf("Is the list empty carefully? %d\n", list_empty_careful(&head));

    struct node *n2 = (struct node *)malloc(sizeof(struct node));
    n2->data = 2;
    list_add_tail(&n2->link, &head);

    printf("The list after adding n2: ");
    print_list(&head);
    printf("Is the list empty? %d\n", list_empty(&head));
    printf("Is the list empty carefully? %d\n", list_empty_careful(&head));

    return 0;
}

在上述示例代码中，我们首先定义了 list_head 和 node 两个结构体，并通过调用init_list_head()函数初始化链表头部。然后，我们利用list_empty()和list_empty_careful()函数分别判断链表是否为空，并打印其返回值。接下来，我们创建了两个node类型的节点并分别将它们添加到链表的尾部。每次添加节点后，我们再次使用list_empty和list_empty_careful函数判断链表是否为空，并打印其返回值。

需要注意的是，在使用这些函数之前，我们要确保链表头部已经初始化。

5. Linux 内核中双向链表遍历相关宏

宏定义	宏描述
`#define list_entry(ptr, type, member) ((type )((char )(ptr)-(unsigned long)(&((type *)0)->member)))`	用于获取一个节点所在结构体的起始地址。
`static inline int list_entry_is_head(const struct list_head entry, const struct list_head head) { return entry->prev == head; }`	用于判断给定节点是否为链表头。
`#define list_first_entry(ptr, type, member) list_entry((ptr)->next, type, member)`	用于获取链表中第一个节点所在结构体的起始地址。
`#define list_first_entry_or_null(ptr, type, member) ({ struct list_head __head = (ptr); struct list_head __pos = __head->next; __pos != __head ? list_entry(__pos, type, member) : NULL; })`	用于获取链表中第一个节点所在结构体的起始地址，但会先检查链表是否为空，以避免对空指针进行解引用。
`#define list_next_entry(pos, member) list_entry((pos)->member.next, typeof(*(pos)), member)`	用于获取链表中紧随给定节点之后的节点所在结构体的起始地址。
`#define list_last_entry(ptr, type, member) list_entry((ptr)->prev, type, member)`	用于获取链表中最后一个节点所在结构体的起始地址。
`#define list_prepare_entry(pos, ptr, member) ((pos) ? : list_entry(ptr, typeof(*pos), member))`	用于准备一个节点的数据结构指针。如果该指针为NULL，则将其初始化为链表的头部。
`#define list_prev_entry(pos, member) list_entry((pos)->member.prev, typeof(*(pos)), member)`	用于获取链表中紧靠给定节点之前的节点所在结构体的起始地址。
`#define list_for_each(pos, head) for (pos = (head)->next; pos != (head); pos = pos->next)`	遍历链表中的所有节点
`#define list_for_each_continue(pos, head) for (pos = pos->next; pos != (head); pos = pos->next)`	从当前节点继续遍历链表中的剩余节点。
`#define list_for_each_prev(pos, head) for (pos = (head)->prev; pos != (head); pos = pos->prev)`	从链表尾部开始遍历所有节点。
`#define list_for_each_safe(pos, n, head) for (pos = (head)->next, n = pos->next; pos != (head); pos = n, n = pos->next)`	与list_for_each函数类似，但允许在遍历过程中删除或添加节点。其中，n参数表示要处理的下一个节点。
`#define list_for_each_prev_safe(pos, n, head) for (pos = (head)->prev, n = pos->prev; pos != (head); pos = n, n = pos->prev)`	与list_for_each_safe函数类似，但遍历顺序是从链表尾部开始。
`#define list_for_each_entry(pos, head, member) for (pos = list_first_entry(head, typeof(*pos), member); &pos->member != (head); pos = list_next_entry(pos, member))`	用于在遍历链表时，获取每个节点所在结构体的起始地址。其中，pos参数表示当前节点所在结构体的指针；head参数表示要遍历的链表头部指针；member参数表示每个节点在结构体中的成员名称。
`#define list_for_each_entry_reverse(pos, head, member) for (pos = list_last_entry(head, typeof(*pos), member); &pos->member != (head); pos = list_prev_entry(pos, member))`	与list_for_each_entry函数类似，但遍历顺序是从链表尾部开始。
`#define list_for_each_entry_continue(pos, head, member) for (pos = list_next_entry(pos, member); &pos->member != (head); pos = list_next_entry(pos, member))`	用于从当前节点继续往后遍历链表，并获取每个节点所在结构体的起始地址。
`#define list_for_each_entry_continue_reverse(pos, head, member) for (pos = list_prev_entry(pos, member); &pos->member != (head); pos = list_prev_entry(pos, member))`	与list_for_each_entry_continue函数类似，但遍历顺序是从链表尾部开始。
`#define list_for_each_entry_from(pos, head, member) for (; &pos->member != (head); pos = list_next_entry(pos, member))`	用于从某个节点开始遍历链表，并获取每个节点所在结构体的起始地址。其中，pos参数表示当前要遍历的节点所在结构体的指针；head参数表示要遍历的链表头部指针；member参数表示每个节点在结构体中的成员名称。
`#define list_for_each_entry_from_reverse(pos, head, member) for (; &pos->member != (head); pos = list_prev_entry(pos, member))`	与list_for_each_entry_from函数类似，但遍历顺序是从链表尾部开始。
`#define list_for_each_entry_safe(pos, n, head, member) for (pos = list_first_entry(head, typeof(*pos), member), n = list_next_entry(pos, member); &pos->member != (head); pos = n, n = list_next_entry(n, member))`	与list_for_each_entry函数类似，但允许在遍历过程中删除或添加节点。其中，n参数表示要处理的下一个节点。
`#define list_for_each_entry_safe_continue(pos, n, head, member) for (pos = list_next_entry(pos, member), n = list_next_entry(pos, member); &pos->member != (head); pos = n, n = list_next_entry(n, member))`	用于从当前节点继续往后遍历链表，并允许在遍历过程中删除或添加节点。
`#define list_for_each_entry_safe_from(pos, n, head, member) for (n = list_next_entry(pos, member); &pos->member != (head); pos = n, n = list_next_entry(n, member))`	用于从某个节点开始遍历链表，并允许在遍历过程中删除或添加节点。
`#define list_for_each_entry_safe_reverse(pos, n, head, member) for (pos = list_last_entry(head, typeof(*pos), member), n = list_prev_entry(pos, member); &pos->member != (head); pos = n, n = list_prev_entry(n, member))`	与list_for_each_entry_reverse函数类似，但允许在遍历过程中删除或添加节点。
`#define list_is_first(pos, head) ((pos)->prev == (head))`	用于检查当前节点是否为链表中的第一个节点。其中，pos 参数表示要检查的节点指针；head 参数表示链表头部指针。
`#define list_is_last(pos, head) ((pos)->next == (head))`	用于检查当前节点是否为链表中的最后一个节点。其中，pos 参数表示要检查的节点指针；head 参数表示链表头部指针。
`#define list_is_head(pos, head) ((pos) == (head))`	用于检查当前节点是否为链表头部。其中，pos参数表示要检查的节点指针；head参数表示链表头部指针。
`#define list_is_singular(head) (!list_empty(head) && ((head)->next == (head)->prev))`	用于检查链表中是否只有一个节点。其中，head参数表示链表头部指针。
`#define list_safe_reset_next(curr, next, member) next = list_entry((curr)->member.next, typeof(*curr), member)`	用于安全地重置一个节点的后继节点指针，以便在遍历链表时删除当前节点。其中，curr 参数表示当前节点指针；next 参数表示当前节点的后继节点指针；member 参数表示节点结构体中 struct list_head 成员的名称。

6. list_move，list_move_tail，list_bulk_move_tail

6.1 函数说明

函数声明	函数功能
`void list_move(struct list_head list, struct list_head head);`	用于将一个节点移动到另外一个链表的头部。
`void list_move_tail(struct list_head list, struct list_head head);`	用于将一个节点移动到另外一个链表的尾部。
`void list_bulk_move_tail(struct list_head list, int count, struct list_head head);`	用于将多个节点从一个链表移动到另一个链表的尾部。

参数：

list ： 要移动的节点指针
head ： 目标链表头部指针
count ： 要移动的节点数量

6.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include "list.h"

struct my_struct {
    int data;
    struct list_head list;
};

int main() {
    struct list_head a, b;
    struct my_struct s1, s2, s3, *pos, *tmp;

    // 初始化两个链表
    INIT_LIST_HEAD(&a);
    INIT_LIST_HEAD(&b);

    // 添加三个结构体到链表 a 中
    s1.data = 10;
    list_add_tail(&s1.list, &a);

    s2.data = 20;
    list_add_tail(&s2.list, &a);

    s3.data = 30;
    list_add_tail(&s3.list, &a);

    // 将节点 s1 移动到链表 b 的头部
    printf("Before move:\n");
    printf("List a: ");
    list_for_each_entry(pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    printf("List b: ");
    list_for_each_entry(pos, &b, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    list_move(&s1.list, &b);

    printf("After move:\n");
    printf("List a: ");
    list_for_each_entry(pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    printf("List b: ");
    list_for_each_entry(pos, &b, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    // 将节点 s2 移动到链表 b 的尾部
    printf("Before move_tail:\n");
    printf("List a: ");
    list_for_each_entry(pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    printf("List b: ");
    list_for_each_entry(pos, &b, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    list_move_tail(&s2.list, &b);

    printf("After move_tail:\n");
    printf("List a: ");
    list_for_each_entry(pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    printf("List b: ");
    list_for_each_entry(pos, &b, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    // 将链表 a 中的所有节点移动到链表 b 的尾部
    printf("Before bulk_move_tail:\n");
    printf("List a: ");
    list_for_each_entry(pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    printf("List b: ");
    list_for_each_entry(pos, &b, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    list_bulk_move_tail(&a, 3, &b);

    printf("After bulk_move_tail:\n");
    printf("List a: ");
    list_for_each_entry(pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    printf("List b: ");
    list_for_each_entry(pos, &b, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    // 释放内存
    list_for_each_entry_safe(pos, tmp, &a, list) {
        list_del(&pos->list);
        free(pos);
    }

    list_for_each_entry_safe(pos, tmp, &b, list) {
        list_del(&pos->list);
        free(pos);
    }

    return 0;
}

上述示例代码中，我们首先创建了两个链表 a 和 b，然后向链表 a 中添加三个结构体。接着，我们使用 list_move() 函数将节点 s1 从链表 a 移动到链表 b 的头部，使用 list_move_tail() 函数将节点 s2 从链表 a 移动到链表 b 的尾部，最后使用 list_bulk_move_tail() 函数将链表 a 中的所有节点都移动到链表 b 的尾部。

注意： 在上述演示代码的最后，我们需要手动释放所有节点的内存空间，以免造成内存泄漏。

7. list_replace，list_replace_init

7.1 函数说明

函数声明	函数功能
`void list_replace(struct list_head old, struct list_head new);`	用于用一个新节点替换指定节点。
`void list_replace_init(struct list_head old, struct list_head new);`	除了可以完成 list_replace 做的所有操作外，它还将原来的节点初始化为空。

参数：

old ： 要被替换的节点指针；
new ： 新节点的指针。

7.2 演示示例

#include <stdio.h>
#include "list.h"

struct my_struct {
    int data;
    struct list_head list;
};

int main() {
    struct list_head a;
    struct my_struct s1, s2, s3, s4;

    // 初始化链表
    INIT_LIST_HEAD(&a);

    // 添加三个结构体到链表中
    s1.data = 10;
    list_add_tail(&s1.list, &a);

    s2.data = 20;
    list_add_tail(&s2.list, &a);

    s3.data = 30;
    list_add_tail(&s3.list, &a);

    printf("Before replace:\n");
    list_for_each_entry(struct my_struct, pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    // 替换第二个节点
    s4.data = 40;
    list_replace(&s2.list, &s4.list);

    printf("After replace:\n");
    list_for_each_entry(struct my_struct, pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    // 替换第一个节点，并且清空原来的节点
    s4.data = 50;
    list_replace_init(&s1.list, &s4.list);

    printf("After replace_init:\n");
    list_for_each_entry(struct my_struct, pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    // 释放内存
    list_del(&s3.list);
    list_del(&s4.list);

    return 0;
}

在上面的示例代码中，我们首先创建了一个链表 a，然后向其中添加三个结构体。接着，我们使用 list_replace() 函数将第二个节点 s2 替换成新节点 s4，并打印出替换后的链表元素；然后，我们使用 list_replace_init() 函数将第一个节点 s1 替换成新节点 s4，并清空原来的节点，同样打印出替换后的链表元素。

8. list_rotate_left，list_rotate_to_front

8.1 函数说明

函数声明	函数功能
`static inline void list_rotate_left(struct list_head *head)`	用于将链表向左旋转一个位置。
`void list_rotate_to_front(struct list_head head, struct list_head pivot);`	用于将指定节点移到链表头部，并旋转链表使得该节点成为新的头部。

参数：

head ： 链表头部指针
pivot ： 要移到链表头部的节点指针。

8.2 演示示例

#include <stdio.h>
#include "list.h"

struct my_struct {
    int data;
    struct list_head list;
};

int main() {
    struct list_head a;
    struct my_struct s1, s2, s3;

    // 初始化链表
    INIT_LIST_HEAD(&a);

    // 添加三个结构体到链表中
    s1.data = 10;
    list_add_tail(&s1.list, &a);

    s2.data = 20;
    list_add_tail(&s2.list, &a);

    s3.data = 30;
    list_add_tail(&s3.list, &a);

    printf("Before rotate:\n");
    list_for_each_entry(struct my_struct, pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    // 将第二个节点移到链表头部，并旋转链表
    list_rotate_to_front(&a, &s2.list);

    printf("After rotate:\n");
    list_for_each_entry(struct my_struct, pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    // 向左旋转一个位置
    list_rotate_left(&a);

    printf("After rotate_left:\n");
    list_for_each_entry(struct my_struct, pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    // 释放内存
    list_del(&s1.list);
    list_del(&s2.list);
    list_del(&s3.list);

    return 0;
}

在上面的示例代码中，我们首先创建了一个链表 a，然后向其中添加三个结构体。接着，我们使用 list_rotate_to_front() 函数将第二个节点 s2 移到链表头部并旋转链表，打印出操作后的链表元素；然后，我们使用 list_rotate_left() 函数将链表向左旋转一个位置，同样打印出操作后的链表元素。

9. list_splice，list_splice_tail，list_splice_init，list_splice_tail_init

9.1 函数说明

函数声明	函数功能
`void list_splice(struct list_head list, struct list_head head);`	用于将一个链表中的所有节点插入到另一个链表的指定位置之前。
`void list_splice_tail(struct list_head list, struct list_head head);`	用于将一个链表中的所有节点插入到另一个链表的尾部。
`void list_splice_init(struct list_head list, struct list_head head);`	除了可以完成 `list_splice` 做的所有操作外，它还将原来的链表初始化为空。
`void list_splice_tail_init(struct list_head list, struct list_head head);`	除了可以完成 `list_splice_tail` 做的所有操作外，它还将原来的链表初始化为空。
参数：

list ： 要插入的链表头部指针
head ：
- list_splice() 和 list_splice_init() 中表示目标链表插入的位置
- list_splice_tail() 和 list_splice_tail_init() 中表示目标链表尾部的前一个节点

9.2 演示示例

#include <stdio.h>
#include "list.h"

struct my_struct {
    int data;
    struct list_head list;
};

int main() {
    struct list_head a, b;
    struct my_struct s1, s2, s3, s4, s5;

    // 初始化两个链表
    INIT_LIST_HEAD(&a);
    INIT_LIST_HEAD(&b);

    // 向链表 a 中添加三个结构体
    s1.data = 10;
    list_add_tail(&s1.list, &a);

    s2.data = 20;
    list_add_tail(&s2.list, &a);

    s3.data = 30;
    list_add_tail(&s3.list, &a);

    // 向链表 b 中添加两个结构体
    s4.data = 40;
    list_add_tail(&s4.list, &b);

    s5.data = 50;
    list_add_tail(&s5.list, &b);

    printf("Before splice:\n");
    printf("List a:\n");
    list_for_each_entry(struct my_struct, pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\nList b:\n");
    list_for_each_entry(struct my_struct, pos, &b, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    // 将链表 b 中的所有节点插入到链表 a 的头部
    list_splice(&b, &a);

    printf("After splice:\n");
    printf("List a:\n");
    list_for_each_entry(struct my_struct, pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\nList b:\n");
    list_for_each_entry(struct my_struct, pos, &b, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    // 将链表 b 中的所有节点插入到链表 a 的尾部
    list_splice_tail(&b, &a);

    printf("After splice tail:\n");
    printf("List a:\n");
    list_for_each_entry(struct my_struct, pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\nList b:\n");
    list_for_each_entry(struct my_struct, pos, &b, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    // 重新初始化链表 a 并将链表 b 中的所有节点插入到链表 a 的头部
    INIT_LIST_HEAD(&a);
    list_splice_init(&b, &a);

    printf("After splice init:\n");
    printf("List a:\n");
    list_for_each_entry(struct my_struct, pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\nList b:\n");
    list_for_each_entry(struct my_struct, pos, &b, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    // 将链表 b 中的所有节点插入到链表 a 的尾部，并初始化链表 b
    INIT_LIST_HEAD(&b);
    list_splice_tail_init(&a, &b);

    printf("After splice tail init:\n");
    printf("List a:\n");
    list_for_each_entry(struct my_struct, pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\nList b:\n");
    list_for_each_entry(struct my_struct, pos, &b, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    return 0;
}

上述演示代码中，我们创建了两个链表 a 和 b，并初始化为空。然后，我们向链表 a 中添加三个结构体，向链表 b 中添加两个结构体，并使用 list_for_each_entry 宏分别遍历两个链表并输出节点数据。

接着，我们使用 list_splice() 函数将链表 b 中的所有节点插入到链表 a 的头部，使用 list_splice_tail() 函数将链表 b 中的所有节点插入到链表 a 的尾部，并使用 list_for_each_entry 宏再次遍历两个链表并输出节点数据，可以看到链表 a 中包含了链表 b 中的所有节点。

接下来，我们使用 INIT_LIST_HEAD 宏重新初始化链表 a 并使用 list_splice_init() 函数将链表 b 中的所有节点插入到链表 a 的头部，使用 INIT_LIST_HEAD 宏重新初始化链表 b 并使用 list_splice_tail_init() 函数将链表 a 中的所有节点插入到链表 b 的尾部，并使用 list_for_each_entry 宏再次遍历两个链表并输出节点数据，可以看到两个链表中的节点顺序已经被重新排列。

10. list_swap

10.1 函数说明

函数声明	函数功能
`void list_swap(struct list_head list1, struct list_head list2);`	交换两个链表头部的位置。
参数：
list1 和 list2 分别指向两个要交换头部的链表。

10.2 演示示例

#include <stdio.h>
#include "list.h"

struct my_struct {
    int data;
    struct list_head list;
};

int main() {
    struct list_head a, b;
    struct my_struct s1, s2, s3, s4;

    // 初始化两个链表
    INIT_LIST_HEAD(&a);
    INIT_LIST_HEAD(&b);

    // 向链表 a 中添加三个结构体
    s1.data = 10;
    list_add_tail(&s1.list, &a);

    s2.data = 20;
    list_add_tail(&s2.list, &a);

    s3.data = 30;
    list_add_tail(&s3.list, &a);

    // 向链表 b 中添加一个结构体
    s4.data = 40;
    list_add_tail(&s4.list, &b);

    printf("Before swap:\n");
    printf("List a:\n");
    list_for_each_entry(struct my_struct, pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\nList b:\n");
    list_for_each_entry(struct my_struct, pos, &b, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    // 交换链表 a 和链表 b 的头部
    list_swap(&a, &b);

    printf("After swap:\n");
    printf("List a:\n");
    list_for_each_entry(struct my_struct, pos, &a, list) {
        printf("%d ", pos->data);
    }
    printf("\nList b:\n");
    list_for_each_entry(struct my_struct, pos, &b, list) {
        printf("%d ", pos->data);
    }
    printf("\n");

    return 0;
}

在上述示例中，我们创建了两个链表 a 和 b，并向链表 a 中添加三个节点，向链表 b 中添加一个节点。然后我们使用 list_for_each_entry 宏遍历两个链表并输出节点数据。

接着，我们使用 list_swap() 函数交换链表 a 和链表 b 的头部，并使用 list_for_each_entry 宏再次遍历两个链表并输出节点数据，可以看到链表 a 的头部变成了原来的链表 b 的头部，链表 b 的头部变成了原来的链表 a 的头部。

参考

[The Linux Kernel API]

C语言函数大全--l开头的函数

发表于 2023-04-17 更新于 2025-04-27 分类于开发语言-C

总览

函数声明	函数功能
`long labs(long n);`	计算长整型的绝对值
`long long int llabs(long long int n);`	计算long long int 类型整数的绝对值
`double ldexp(double x, int exp);`	计算 x 乘以 2 的指定次幂（double）
`float ldexpf(float x, int exp);`	计算 x 乘以 2 的指定次幂（float）
`long double ldexpl(long double x, int exp);`	计算 x 乘以 2 的指定次幂（long double）
`ldiv_t ldiv(long int numer, long int denom);`	计算两个 long int 类型整数的商和余数
`lldiv_t lldiv(long long int numer, long long int denom);`	计算两个 long long int 类型整数的商和余数
`void lfind(const void key, const void base, size_t nmemb, size_t size, int (compar)(const void , const void ));`	它是标准 C 库函数 `<search.h>` 中的一个函数，用于在一个数组中查找指定元素。
`void line( int x1, int y1, int x2, int y2);`	在指定两点间画一直线
`void linerel(int dx, int dy);`	从当前位置绘制一条指定长度和方向的线段。
`void lineto(int x, int y);`	从当前位置绘制一条直线到指定位置
`struct tm localtime(const time_t timep);`	将 UNIX 时间戳转换为本地时间
`int lock(int fd, int cmd, off_t len);`	它是标准 C 库函数 `<fcntl.h>` 中的一个函数，用于对文件进行加锁或解锁操作
`double log(double x);`	计算自然对数
`double log10(double x);`	计算以 10 为底的对数
`void longjmp(jmp_buf env, int val);`	跳转到指定的程序位置并恢复相应的上下文环境
`void lowvideo(void);`	用于将文本颜色设置为低对比度模式
`unsigned long _lrotl(unsigned long value, int shift);`	它是 Windows 系统特有的函数，用于将 32 位无符号整数按位循环左移。
`void lsearch(const void key, void base, size_t nelp, size_t width, int (compar)(const void , const void *));`	用于在指定的数组中查找指定元素，并返回该元素在数组中的地址
`long lseek(int handle, long offset, int fromwhere);`	设置文件操作指针，即改变文件读取或写入的位置
`char ltoa(long value, char str, int radix);`	用于将长整型数值转换为字符串格式
`char lltoa(long long value, char str, int radix);`	用于将长长整型数值转换为字符串格式

1. labs，llabs

1.1 函数说明

函数声明	函数功能
`long labs(long n);`	计算长整型的绝对值
`long long int llabs(long long int n);`	计算long long int 类型整数的绝对值

1.2 演示示例

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

int main(void)
{
    long result;
    long x = -12345678L;
    result= labs(x);
    printf("number: %ld , abs value: %ld\n", x, result);

    long long  resultL;
    long long int xL = -1234567890123456789;
    resultL = llabs(xL);
    printf("The absolute value of %lld is %lld\n", xL, resultL);

    return 0;
}

1.3 运行结果

2. ldexp，ldexpf，ldexpl

2.1 函数说明

函数声明	函数功能
`double ldexp(double x, int exp);`	计算 x 乘以 2 的指定次幂（double）
`float ldexpf(float x, int exp);`	计算 x 乘以 2 的指定次幂（float）
`long double ldexpl(long double x, int exp);`	计算 x 乘以 2 的指定次幂（long double）

2.2 演示示例

#include <stdio.h>
#include <math.h>

int main()
{
    int n = 3;
    double x = 3.5, result;
    result = ldexp(x, n);

    float xf = 3.5f, resultf;
    resultf = ldexpf(xf, n);

    long double xL = 3.5L, resultL;
    resultL = ldexpl(xL, n); 

    printf("ldexp(%lf, %d) = %lf\n", x, n, result);
    printf("ldexpf(%f, %d) = %f\n", xf, n, resultf);
    printf("ldexpl(%Lf, %d) = %Lf\n", xL, n, resultL);

    return 0;
}

注意：ldexp，ldexpf，ldexpl 函数会对参数进行溢出和下溢处理，因此可以处理很大或很小的数值。

2.3 运行结果

3. ldiv，lldiv

3.1 函数说明

函数声明	函数功能
`ldiv_t ldiv(long int numer, long int denom);`	计算两个 long int 类型整数的商和余数
`lldiv_t lldiv(long long int numer, long long int denom);`	计算两个 long long int 类型整数的商和余数

参数：

numer ： 被除数
denom ： 除数

ldiv 函数的返回值类型 ldiv_t 是一个结构体类型，定义如下：

typedef struct {
    long int quot;  // 商
    long int rem;   // 余数
} ldiv_t;

lldiv 函数的返回值类型 lldiv_t 是一个结构体类型，定义如下：

typedef struct {
    long long int quot;  // 商
    long long int rem;   // 余数
} lldiv_t;

3.2 演示示例

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

int main()
{
    long int numer = 1234567890;
    long int denom = 987654321;
    ldiv_t result;

    result = ldiv(numer, denom);

    printf("%ld / %ld = %ld, %ld %% %ld = %ld\n", numer, denom, 
        result.quot, numer, denom, result.rem);

    long long int numerL = 1234567890123456789LL;
    long long int denomL = 987654321LL;
    lldiv_t resultL;

    resultL = lldiv(numerL, denomL);

    printf("%lld / %lld = %lld, %lld %% %lld = %lld\n", numerL, denomL,
        resultL.quot, numerL, denomL, resultL.rem);

    return 0;
}

注意： 如果 denom 参数为零，则 ldiv() 函数会产生一个异常情况。此外，如果两个参数中有一个或两个都是负数，则商和余数的计算规则将根据 C 标准进行调整。

3.3 运行结果

4. lfind

4.1 函数说明

函数声明	函数功能
`void lfind(const void key, const void base, size_t nmemb, size_t size, int (compar)(const void , const void ));`	它是标准 C 库函数 `<search.h>` 中的一个函数，用于在一个数组中查找指定元素。

参数：

key ： 要查找的元素
base ： 要查找的数组的首地址
nmemb ： 数组元素个数
size ： 每个数组元素的大小（以字节为单位）
compar ： 比较函数，用于比较数组元素和要查找的元素。compar 函数需要返回一个整数值，表示两个元素之间的关系：
- 如果第一个元素小于第二个元素，则返回一个负数。
- 如果第一个元素等于第二个元素，则返回零。
- 如果第一个元素大于第二个元素，则返回一个正数。

4.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <search.h>

int compare(const void *a, const void *b)
{
    return (*(int*)a - *(int*)b);
}

int main()
{
    int arr[] = {1, 2, 3, 4, 5};
    int n = sizeof(arr) / sizeof(arr[0]);
    for (int i = 0; i < n; i++)
        printf("%d ", arr[i]);

    unsigned int * number = (unsigned int *)&n;
    int key = 2;
    int *result;

    result = (int *)lfind(&key, arr, number, sizeof(int), compare);

    if (result != NULL) {
        printf("\n%d is found at index %lld\n", key, result - arr);
    } else {
        printf("\n%d is not found in the array\n", key);
    }

    return 0;
}

注意： lfind() 函数使用线性搜索算法，因此对于大规模数据可能不太适用。除此之外，该函数还有一些变种函数，例如 bsearch() 和 tfind() 等，也可以用于在数组或树结构中查找元素。

4.3 运行结果

5. line

5.1 函数说明

函数声明	函数功能
`void line( int x1, int y1, int x2, int y2);`	在指定两点间画一直线
参数：

(x1, y1) ： 第一个点的坐标
(x2, y3) ： 第二个点的坐标

5.2 演示示例

#include <graphics.h>

int main(void)
{
    int gdriver = DETECT, gmode;
    int xmax, ymax;
    
    initgraph(&gdriver, &gmode, "");
    
    setcolor(getmaxcolor());
    xmax = getmaxx();
    ymax = getmaxy();

    // 在(0,0) 和(xmax, ymax)之间画一直线
    line(0, 0, xmax, ymax);

    // 在(0,ymax) 和(xmax, 0)之间画一直线
    line(0, ymax, xmax, 0);

    /* clean up */
    getch();
    closegraph();
    return 0;
}

5.3 运行结果

6. linerel

6.1 函数说明

函数声明	函数功能
`void linerel(int dx, int dy);`	从当前位置绘制一条指定长度和方向的线段。
参数：

dx ： 线段在 X 轴上的位移量
dy ： 线段在 Y 轴上的位移量

6.2 演示示例

#include <graphics.h>

int main()
{
    int gd = DETECT, gm;
    initgraph(&gd, &gm, "");

    moveto(100, 100);  // 将当前点移动到 (100, 100)
    linerel(50, 0);    // 绘制长度为 50，方向为水平（X 轴正方向）的线段
    linerel(0, 50);    // 绘制长度为 50，方向为垂直（Y 轴正方向）的线段
    linerel(-50, 0);    // 绘制长度为 50，方向为水平（X 轴反方向）的线段
    linerel(0, -50);    // 绘制长度为 50，方向为垂直（Y 轴反方向）的线段

    getch();
    closegraph();

    return 0;
}

6.3 运行结果

7. lineto

7.1 函数说明

函数声明	函数功能
`void lineto(int x, int y);`	从当前位置绘制一条直线到指定位置
参数：

x ： 线段终点的 X 坐标
y ： 线段终点的 Y 坐标

7.2 演示示例

#include <graphics.h>

int main()
{
    int gd = DETECT, gm;
    initgraph(&gd, &gm, "");

    moveto(100, 100);  // 将当前点移动到 (100, 100)
    lineto(150, 150);  // 绘制一条从当前点到 (150, 150) 的线段
    lineto(200, 100);  // 绘制一条从当前点到 (200, 100) 的线段
    lineto(150, 50);   // 绘制一条从当前点到 (150, 50) 的线段
    lineto(100, 100);   // 绘制一条从当前点到 (150, 50) 的线段

    getch();
    closegraph();

    return 0;
}

7.3 运行结果

8. localtime

8.1 函数说明

函数声明	函数功能
`struct tm localtime(const time_t timep);`	将 UNIX 时间戳转换为本地时间
参数：

timep ： 指向 time_t 类型的指针，表示要转换的 UNIX 时间戳

返回值：

struct tm * ： 一个指向 struct tm 类型的指针，该结构体包含了表示本地时间的各个字段，例如年、月、日、时、分、秒等。

8.2 演示示例

#include <stdio.h>
#include <time.h>

int main()
{
    time_t now;
    struct tm *local;

    now = time(NULL);       // 获取当前时间戳
    local = localtime(&now);  // 将当前时间戳转换为本地时间

    printf("Current date and time: %s\n", asctime(local));

    return 0;
}

注意： 在使用 localtime() 函数时需要注意结构体中的字段值是否正确，例如月份、星期等的表示方式可能因不同系统而异。

8.3 运行结果

9. lock

9.1 函数说明

函数声明	函数功能
`int lock(int fd, int cmd, off_t len);`	它是标准 C 库函数 `<fcntl.h>` 中的一个函数，用于对文件进行加锁或解锁操作
参数：

fd ： 文件描述符
cmd ： 要执行的加锁或解锁操作（例如 F_LOCK、F_ULOCK 等）
len ： 要锁定的字节数。

返回值：

返回一个整数值表示操作是否成功，若成功则返回 0，否则返回 -1

9.2 演示示例

#include <stdio.h>
#include <fcntl.h>

int main()
{
    int fd;
    char buf[128];
    int nbytes;

    fd = open("test.txt", O_RDWR | O_CREAT, 0666);
    if (fd == -1) {
        perror("open");
        return 1;
    }

    // 加锁
    if (lock(fd, F_LOCK, 0) == -1) {
        perror("lock");
        return 1;
    }

    // 写入数据
    sprintf(buf, "Hello, world!\n");
    nbytes = write(fd, buf, sizeof(buf));
    if (nbytes == -1) {
        perror("write");
        return 1;
    }

    // 解锁
    if (lock(fd, F_ULOCK, 0) == -1) {
        perror("unlock");
        return 1;
    }

    close(fd);

    return 0;
}

上述示例程序中，首先通过 open() 函数打开一个名为 test.txt 的文件，并设置文件访问模式为可读写。接着，调用 lock() 函数对该文件进行加锁操作，保护写入数据的过程。然后，通过 write() 函数将数据写入到文件中。最后，调用 lock() 函数对该文件进行解锁操作，释放锁定的资源。

注意： 在使用 lock() 函数时需要注意加锁和解锁的顺序、范围等问题，否则可能会造成死锁或其他问题。此外，该函数只适用于文件系统，不能用于套接字等其他类型的文件描述符。

10. log

10.1 函数说明

函数声明	函数功能
`double log(double x);`	计算自然对数
参数：

x ： 要计算自然对数的数字。

返回值：

x 的自然对数，即 ln(x)。

10.2 演示示例

#include <stdio.h>
#include <math.h>

int main()
{
    double x = 2.0;
    double result = log(x);

    printf("The natural logarithm of %lf is %lf.\n", x, result);

    return 0;
}

注意： 由于 log() 函数接受的参数和返回值都是 double 类型，因此在使用时需要保证传入的参数类型正确，避免发生精度损失等问题。同时， log() 函数的参数不能为负数或零，否则会产生不可预知的行为。

10.3 运行结果

11. log10

11.1 函数说明

函数声明	函数功能
`double log10(double x);`	计算以 10 为底的对数
参数：

x ： 要计算以 10 为底的对数的数字

返回值：

x 的以 10 为底的对数，即 log10(x)

11.2 演示示例

#include <stdio.h>
#include <math.h>

int main()
{
    double x = 100.0;
    double result = log10(x);

    printf("The logarithm base 10 of %lf is %lf.\n", x, result);

    return 0;
}

11.3 运行结果

12. longjmp

12.1 函数说明

函数声明	函数功能
`void longjmp(jmp_buf env, int val);`	跳转到指定的程序位置并恢复相应的上下文环境
参数：

env ： 保存上下文环境的缓冲区
val ： 跳转时返回的值

注意：在使用 longjmp() 函数之前，需要先调用 setjmp() 函数来设置上下文环境，并将其保存在 jmp_buf 数据类型中。然后，在程序执行过程中，如果需要跳转到之前设定的位置，就可以使用 longjmp() 函数进行跳转和上下文恢复。

12.2 演示示例

#include <stdio.h>
#include <setjmp.h>

jmp_buf buf;

void do_something()
{
    printf("do_something() start.\n");

    // 跳转到 setjmp() 处
    longjmp(buf, 1);

    printf("do_something() end.\n");
}

int main()
{
    int val = 0;

    // 设置上下文环境
    if (setjmp(buf) == 0) {
        printf("setjmp() called.\n");
        do_something();
    } else {
        printf("longjmp() called.\n");
        val = 1;
    }

    printf("Program ends with value %d.\n", val);

    return 0;
}

上述示例程序中，首先在主函数中调用 setjmp() 函数设置上下文环境，并将其保存在 buf 变量中。然后，程序调用 do_something() 函数，在其中调用 longjmp() 函数跳转到之前设定的位置，并返回值为 1。

由于 longjmp() 调用后不会返回到调用它的位置，因此 do_something() 函数在被调用后并未执行完毕，而是直接跳转到了 setjmp() 所在的位置。当程序回到 setjmp() 处时，检测到了从 longjmp() 跳转过来的信号，并返回值为 1，表示跳转成功。

最后，程序输出 "Program ends with value 1."，结束运行。

注意： 使用 longjmp() 和 setjmp() 函数进行跳转时，必须保证跳转的目标位置和之前设置的上下文环境是兼容的，否则可能会导致程序崩溃或其他严重问题。同时，尽管 longjmp() 可以快速跳出当前函数或代码块，但在实际应用中应该尽量避免使用它，以免造成代码逻辑混乱和难以调试的问题。

12.3 运行结果

13. lowvideo

13.1 函数说明

函数声明	函数功能
`void lowvideo(void);`	用于将文本颜色设置为低对比度模式

13.2 演示示例

#include <conio.h>

int main(void)
{
    clrscr(); // 清空屏幕
    highvideo(); // 将文本颜色设置为高对比度模式
    cprintf("High Intesity Text\r\n");
    lowvideo(); // 将文本颜色设置为低对比度模式
    gotoxy(1,2); // 将光标移动到指定的坐标 (x, y)，其中 x 和 y 分别为列和行数
    cprintf("Low Intensity Text\r\n");

    return 0;
}

当该程序运行时，首先清空了控制台屏幕，然后将文本颜色设置为高对比度模式并输出一段文本。接着，将文本颜色设置为低对比度模式，并将光标移动到第二行第一个字符位置，输出另外一段文本。最后，程序执行结束，并返回 0。

注意： <conio.h> 头文件中的函数在不同的操作系统和编译器下可能会有所不同，并且并非所有的平台都支持低对比度文本模式。在实际应用中，应该避免过度使用低对比度模式，以免影响用户体验和可读性。

14. _lrotl

14.1 函数说明

函数声明	函数功能
`unsigned long _lrotl(unsigned long value, int shift);`	它是 Windows 系统特有的函数，用于将 32 位无符号整数按位循环左移。
参数：

value ： 要进行循环左移的 32 位无符号整数
shift ： 左移的位数

返回值：

左移后的结果。

14.2 演示示例

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

int main()
{
   unsigned long result;
   unsigned long value = 2;

   result = _lrotl(value, 2);
   printf("The value %lu rotated left one bit is: %lu\n", value, result);

   return 0;
}

注意： _lrotl() 函数是 Windows 系统特有的函数，在其他操作系统或编译器下可能不可用或使用方式有所不同。此外，由于该函数只适用于 32 位无符号整数，如果需要对 64 位整数进行位移操作，则需要使用其他函数。

14.3 运行结果

15. lsearch

15.1 函数说明

函数声明	函数功能
`void lsearch(const void key, void base, size_t nelp, size_t width, int (compar)(const void , const void *));`	用于在指定的数组中查找指定元素，并返回该元素在数组中的地址
参数：

key ： 要查找的元素指针
base ： 要进行查找的数组首地址
nelp ： 当前数组中元素的个数
width ： 数组中每个元素所占用的字节数
compar ： 比较函数指针，用于比较两个元素的大小关系。

15.2 演示示例

#include <stdio.h>
#include <stdlib.h>
#include <search.h>

int compare(const void *a, const void *b)
{
    return *(int *)a - *(int *)b;
}

int main()
{
    int arr[] = { 3, 1, 4, 1, 5, 9, 2, 6, 5 };
    int len = sizeof(arr) / sizeof(int);

    int key = 5;
    int *result = lsearch(&key, arr, &len, sizeof(int), compare);

    if (result != NULL) {
        printf("Found %d at index %ld.\n", *result, result - arr);
    } else {
        printf("%d not found in the array.\n", key);
    }

    return 0;
}

上述示例程序中，首先定义了一个整型数组 arr 并初始化为 { 3, 1, 4, 1, 5, 9, 2, 6, 5 }。然后，将要查找的元素值 key 设置为 5，并调用 lsearch() 函数在数组中查找该元素。如果找到了，则输出该元素在数组中的下标；否则输出未找到的提示。

注意： lsearch() 函数在查找数组元素时，只能够找到第一个匹配的元素，并返回其地址。如果数组中存在多个相同的元素，则无法区分它们的位置。此外，使用 lsearch() 函数进行查找时，必须保证数组已经按照指定的比较函数从小到大排好序，否则可能会导致查找失败或找到错误的元素。

15.3 运行结果

16. lseek

16.1 函数说明

函数声明	函数功能
`long lseek(int handle, long offset, int fromwhere);`	设置文件操作指针，即改变文件读取或写入的位置
参数：

handle ： 文件描述符
offset ： 偏移量
whence ： 偏移量的参考位置
- SEEK_SET： 从文件开头开始计算偏移量（即绝对位置）
- SEEK_CUR： 从当前位置开始计算偏移量（即相对位置）
- SEEK_END： 从文件结尾开始计算偏移量（即反向偏移）

返回值：

如果成功，则返回新的文件指针位置（即距离文件开头的字节数）；
- 如果发生错误，则返回 -1。

16.2 演示示例

#include <stdio.h>
#include <unistd.h>
#include <fcntl.h>

int main()
{
    int fd = open("temp.txt", O_RDWR);
    if (fd == -1) {
        printf("Failed to open the file.\n");
        return -1;
    }

    off_t pos = lseek(fd, 5, SEEK_SET);
    if (pos == -1) {
        printf("Failed to seek the file.\n");
        close(fd);
        return -1;
    }

    char buf[10];
    ssize_t nread = read(fd, buf, 5);
    if (nread == -1) {
        printf("Failed to read the file.\n");
        close(fd);
        return -1;
    }

    buf[nread] = '\0';
    printf("Read %ld bytes from position %ld: %s\n", nread, pos, buf);

    close(fd);
    return 0;
}

上述示例程序中，首先使用 open() 函数打开名为 "temp.txt" 的文件，并获取其文件描述符。然后，调用 lseek() 函数将文件指针移动到距离文件开头 5 个字节处。接着，调用 read() 函数从该位置开始读取 5 个字节的数据，并输出读取结果。

注意： lseek() 函数只能够对可寻址的文件进行操作，如磁盘文件、终端设备等，而不能对无法随机访问的流式数据进行操作，如管道、套接字等。同时，在使用 lseek() 函数时应该注意文件操作模式和文件共享模式，以免影响其他进程或线程的文件访问。

16.3 运行结果

17. ltoa

17.1 函数说明

函数声明	函数功能
`char ltoa(long value, char str, int radix);`	用于将长整型数值转换为字符串格式
参数：

value ： 要转换的长整型数值
str ： 保存转换结果的字符缓冲区指针
radix ： 要转换的进制数（如2进制、 10 进制、16 进制等），取值范围为 2～36

返回值：

指向转换结果的指针（即 str 参数的值）

17.2 演示示例

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

int main()
{
    long value = 123456789L;
    char str[20];

    ltoa(value, str, 2);
    printf("The result of converting %ld to binary string is: %s\n", value, str);

    ltoa(value, str, 10);
    printf("The result of converting %ld to decimal string is: %s\n", value, str);

    ltoa(value, str, 16);
    printf("The result of converting %ld to hexadecimal string is: %s\n", value, str);

    return 0;
}

注意： ltoa() 函数在将长整型数值转换为字符串时，会将负数转换为相应的带符号字符串。如果要对无符号长整型进行转换，则需要使用其他函数或技巧。此外，由于 ltoa() 函数没有对输出缓冲区溢出进行检查，因此在使用时应该确保缓冲区足够大，以免发生错误。

17.3 运行结果

18. lltoa

18.1 函数说明

函数声明	函数功能
`char lltoa(long long value, char str, int radix);`	用于将长长整型数值转换为字符串格式
参数：

value ： 要转换的长长整型数值
str ： 保存转换结果的字符缓冲区指针
radix ： 要转换的进制数（如 2进制、10 进制、16 进制等），取值范围为 2～36

返回值：

指向转换结果的指针（即 str 参数的值）

18.2 演示示例

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

int main()
{
    long long value = 123456789012345LL;
    char str[20];

    lltoa(value, str, 2);
    printf("The result of converting %lld to binary string is: %s\n", value, str);

    lltoa(value, str, 10);
    printf("The result of converting %lld to decimal string is: %s\n", value, str);

    lltoa(value, str, 16);
    printf("The result of converting %lld to hexadecimal string is: %s\n", value, str);

    return 0;
}

18.3 运行结果

参考

[API Reference Document]