C语言函数大全
本篇介绍C语言函数大全-- s 开头的函数（2）
1. setlinestyle
1.1 函数说明
| 函数声明 | 函数功能 |
|---|---|
void setlinestyle( int linestyle, unsigned upattern, int thickness ); |
设置当前绘图窗口的线条样式、线型模式和线条宽度 |
参数：
- linestyle ： 线条样式，取值范围为 0 到 4，不同的值对应着不同的线条样式，详见如下表格
- upattern ： 线型模式，它是一个
16位的无符号整数，用二进制位表示线型模式，其中1表示绘制线条，0表示空白。例如，如果upattern的值是0x00FF，则表示绘制一段线条，然后空白一段，重复这个过程直到结束。如果upattern的值是0x5555，则表示绘制一段虚线。- thickness ： 线条宽度，取值范围为 1 到 10，表示线条的像素宽度
| 线条样式 | 值 | 描述 |
|---|---|---|
| SOLID_LINE | 实线 | |
| DOTTED_LINE | 1 | 虚线 |
| CENTER_LINE | 2 | 点线 |
| DASHED_LINE | 3 | 长短线 |
| USERBIT_LINE | 4 | 双点线 |
1.2 演示示例
#include <graphics.h>
#include <string.h>
/* the names of the line styles supported */
char *lname[] = {
"SOLID_LINE",
"DOTTED_LINE",
"CENTER_LINE",
"DASHED_LINE",
"USERBIT_LINE"
};
int main(void)
{
int gdriver = DETECT, gmode;
int style, midx, midy, userpat;
char stylestr[40];
initgraph(&gdriver, &gmode, "");
midx = getmaxx() / 2;
midy = getmaxy() / 2;
userpat = 1;
for (style=SOLID_LINE; style<=USERBIT_LINE; style++)
{
setlinestyle(style, userpat, 1);
strcpy(stylestr, lname[style]);
line(0, 0, midx-10, midy);
rectangle(100, 100, getmaxx() - 100, getmaxy() - 100);
outtextxy(midx, midy, stylestr);
getch();
cleardevice();
}
closegraph();
return 0;
}
1.3 运行结果
2. setmem
2.1 函数说明
| 函数声明 | 函数功能 |
|---|---|
void *setmem(void *dest, size_t n, int c); |
用于将指定内存区域的每个字节都设置为指定的值 |
参数：
- dest ： 要设置的内存区域的指针
- n ： 要设置的字节数
- c ： 要设置的值
·注意： setmem() 并不是标准 C 函数，而是 POSIX 标准库函数，因此可能并不被所有平台所支持。如果您的编译器或操作系统不支持 setmem() 函数，可以使用标准 C 库函数 memset() 来代替
2.2 演示示例
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
int main()
{
char *str = (char *)malloc(10); // 分配 10 字节的内存空间
// 将 str 中的每个字节都设置为 'A'
setmem(str, 10, 'A');
printf("%s\n", str);
free(str);
return 0;
}
在上面的示例程序中，
- 我们首先使用
malloc()函数分配了10字节的内存空间，并将其赋值给指针变量 str。 - 然后，我们使用
setmem()函数将str指向的内存区域的每个字节都设置为'A'。 - 最后，我们输出
str的内容并使用free()函数释放了分配的内存空间。
3. setmode
3.1 函数说明
| 函数声明 | 函数功能 |
|---|---|
int setmode(int fd, int mode); |
它是 Windows 系统下的特定库函数，用于将指定文件的 I/O 模式设置为文本模式或二进制模式 |
参数：
- fd ： 要设置模式的文件描述符，通常使用
fileno()函数将文件指针转换为文件描述符- mode ： 要设置的模式，它可以取以下两个值中的一个：
_O_BINARY：二进制模式_O_TEXT：文本模式
注意： 在
Windows系统中，文本模式和二进制模式之间的区别在于换行符的处理方式。在文本模式下，Windows将回车符（\r）和换行符（\n）组成的字符序列映射为单个换行符（\n），因此在读取文本文件时可以正确处理换行符。在二进制模式下，Windows不对回车符和换行符做任何转换，因此在读取文本文件时可能会出现问题。
3.2 演示示例
#include <stdio.h>
#include <fcntl.h>
int main()
{
int result;
result = setmode(fileno(stdin), O_TEXT);
if (result == -1)
perror("Mode not available\n");
else
printf("Mode successfully switched\n");
return 0;
}
在上面的示例程序中，我们首先使用 setmode() 函数将标准输入流的模式从二进制模式切换到文本模式；如果调用成功，则返回 0，否则返回 -1，并将错误信息存储在全局变量 errno 中。在程序中，我们使用 perror() 函数来输出错误信息。如果调用成功，则输出一条提示信息。
注意：
setmode()函数只适用于Windows系统下的C/C++编程，并且不是标准库函数，因此在跨平台编程时应该避免使用它。在Unix/Linux系统下，也可以使用fcntl()函数来设置文件描述符的模式。
3.3 运行结果
4. setpalette
4.1 函数说明
| 函数声明 | 函数功能 |
|---|---|
void setpalette(int colornum, int color); |
设置调色板的颜色 |
参数：
- colornum ： 要设置的调色板中的颜色数量
- color ： 是一个整数类型的值，用于表示调色板中的颜色。这个参数可以是一个
RGB值，也可以是一个预定义颜色名称，例如RED或BLUE。
4.2 演示示例
#include <graphics.h>
int main()
{
int gd = DETECT, gm;
initgraph(&gd, &gm, "");
// 将第 5 种颜色设置为红色
setpalette(5, RED);
// 绘制一条红色的直线
setcolor(5);
line(100, 100, 200, 100);
getch();
closegraph();
return 0;
}
4.3 运行结果
5. setrgbpalette
5.1 函数说明
| 函数声明 | 函数功能 |
|---|---|
void setrgbpalette(int colornum, int red, int green, int blue); |
用于设置当前绘图窗口的调色板中某个颜色的 RGB 值 |
参数：
- colornum ： 要修改的颜色索引，取值范围为
0~255。- red、green 和 blue 要设置的
RGB值，取值范围为0~255。
5.2 演示示例
#include <graphics.h>
int main()
{
int gd = DETECT, gm;
initgraph(&gd, &gm, "");
setbkcolor(WHITE);
cleardevice();
// 将第 5 种颜色设置为蓝绿色
setrgbpalette(5, 0, 128, 128);
// 绘制一条蓝绿色的斜线
setcolor(5);
line(100, 100, 200, 200);
getch();
closegraph();
return 0;
}
在上述的这个示例程序中，
- 我们首先使用
setbkcolor()函数设置背景颜色为白色，然后清除原有屏幕使前面设置生效。 - 接着我们使用
setrgbpalette()函数将第5种颜色设置为蓝绿色，并使用setcolor()函数将绘图颜色设为索引值5（即蓝绿色）； - 最后使用
line()函数绘制了一条斜线。
5.3 运行结果
6. settextjustify
6.1 函数说明
| 函数声明 | 函数功能 |
|---|---|
void settextjustify(int horiz, int vert); |
用于设置文本输出的对齐方式 |
参数：
- horiz ： 水平对齐方式，可以取以下值：
LEFT_TEXT：左对齐CENTER_TEXT：居中对齐RIGHT_TEXT：右对齐- vert ： 垂直对齐方式，可以取以下值：
TOP_TEXT：顶部对齐CENTER_TEXT：居中对齐BOTTOM_TEXT：底部对齐
6.2 演示示例
#include <graphics.h>
int main()
{
int gd = DETECT, gm;
initgraph(&gd, &gm, "");
// 设置文本输出的对齐方式为居中对齐
settextjustify(CENTER_TEXT, CENTER_TEXT);
// 输出一行居中对齐的文本
outtextxy(getmaxx() / 2, getmaxy() / 2, "Hello, world!");
getch();
closegraph();
return 0;
}
在上述的示例程序中，我们使用 settextjustify() 函数将文本输出的对齐方式设置为居中对齐，然后使用 outtextxy() 函数在窗口的中心输出一行文本。
注意： 在使用
settextjustify()函数设置对齐方式时，必须指定正确的参数值，并且同时考虑水平和垂直方向的对齐方式，否则可能会导致文本输出位置错误。
6.3 运行结果
7. settextstyle
7.1 函数说明
| 函数声明 | 函数功能 |
|---|---|
void settextstyle(int font, int direction, int charsize); |
用于设置当前文本输出的字体、方向和大小 |
参数：
- font ： 要使用的字体编号，可以取以下值：
DEFAULT_FONT：默认字体TRIPLEX_FONT：粗体三线字体SMALL_FONT：小号字体SANS_SERIF_FONT：无衬线字体GOTHIC_FONT：哥特式字体SCRIPT_FONT：手写字体- direction ： 文本输出的方向，可以取以下值：
HORIZ_DIR：水平方向（从左到右）VERT_DIR：垂直方向（从下到上）- horiz ： 水平对齐方式，可以取以下值：
DEFAULT_WIDTH和DEFAULT_HEIGHT：默认大小TRIPLEX_WIDTH和TRIPLEX_HEIGHT：大号尺寸SMALL_WIDTH和SMALL_HEIGHT：小号尺寸
7.2 演示示例
#include <graphics.h>
int main()
{
int gd = DETECT, gm;
initgraph(&gd, &gm, "");
// 设置文本输出的字体、方向和大小
settextstyle(TRIPLEX_FONT, HORIZ_DIR, 4);
// 输出一行文本
outtextxy(100, 100, "Hello, world!");
getch();
closegraph();
return 0;
}
在上述的示例程序中，我们使用 settextstyle() 函数将文本输出的字体设置为粗体三线字体、方向设置为水平方向、大小设置为大号尺寸，然后使用 outtextxy() 函数在窗口的指定位置输出一行文本。
注意： 在使用
settextstyle()函数设置文本样式时，必须指定正确的参数值，并且根据具体需求灵活选择字体、方向和大小，否则可能会导致文本输出不符合预期。
7.3 运行结果
8. settime
8.1 函数说明
| 函数声明 | 函数功能 |
|---|---|
void settime(struct time *timep); |
设置当前系统时间 |
参数：
- timep ： 用于存储当前系统时间的结构体变量
8.2 演示示例
#include <stdio.h>
#include <dos.h>
int main(void)
{
struct time t;
gettime(&t);
printf("The current minute is: %d\n", t.ti_min);
printf("The current hour is: %d\n", t.ti_hour);
printf("The current hundredth of a second is: %d\n", t.ti_hund);
printf("The current second is: %d\n", t.ti_sec);
t.ti_min++;
settime(&t);
return 0;
}
在上述的程序中，
- 我们首先定义了一个
struct time类型的变量t，用于存储当前系统时间。然后使用gettime()函数获取当前时间，并将小时、分钟、秒和百分之一秒等信息存储到t变量的对应成员变量中。 - 接着，程序使用
printf()函数输出了当前的分钟数、小时数、百分之一秒数和秒数。这里使用了%d占位符来指定输出整数类型的值。 - 最后，程序将 t 变量的分钟数加上了 1，然后使用 settime() 函数将修改后的时间写入系统时钟中。
注意 ： 这个程序依赖于
DOS系统提供的日期和时间相关函数，可能无法在其他操作系统或环境下运行。此外，直接修改系统时间可能会对计算机的正常运行产生影响，因此应该谨慎使用。 在现代的Windows操作系统中，DOS环境已经被废弃，因此这个程序可能无法正常工作。如果要获取和修改当前系统时间，可以使用操作系统提供的相关API或系统调用接口实现。例如，在Windows平台上，可以使用GetSystemTime()和SetSystemTime()等函数来获取和设置系统时间。
9. setusercharsize
9.1 函数说明
| 函数声明 | 函数功能 |
|---|---|
void setusercharsize(int multx, int dirx, int multy, int diry); |
用于设置用户定义的字符大小 |
参数：
- multx ： 水平放大倍数，取值为正整数
- dirx ： 水平方向，取值为
1或-1。当dirx的值为1时，字符不进行左右翻转；当dirx的值为-1时，字符进行左右翻转- multy ： 垂直放大倍数，取值为正整数
- diry ： 垂直方向，取值为
1或-1。当diry的值为1时，字符不进行上下翻转；当diry的值为-1时，字符进行上下翻转。
9.2 演示示例
#include <graphics.h>
int main()
{
int gd = DETECT, gm;
initgraph(&gd, &gm, "");
// 设置字符的大小为水平方向放大 2 倍、垂直方向放大 3 倍
setusercharsize(2, 1, 3, 1);
// 输出一行文本
outtextxy(100, 100, "Hello, world!");
getch();
closegraph();
return 0;
}
在上述这个示例程序中，我们使用 setusercharsize() 函数将当前字符的大小设置为水平方向放大 2 倍、垂直方向放大 3 倍，然后使用 outtextxy() 函数在窗口的指定位置输出一行文本。
注意： 在使用
setusercharsize()函数设置字符大小时，必须指定正确的参数值，并且考虑到水平和垂直方向的缩放倍数，否则可能会导致字符输出不符合预期。
9.3 运行结果
10. setvbuf
10.1 函数说明
| 函数声明 | 函数功能 |
|---|---|
int setvbuf(FILE *stream, char *buf, int type, unsigned size); |
用于设置文件流的缓冲方式 |
参数：
- stream ： 要设置缓冲方式的文件指针，可以是标准输入流（
stdin）、标准输出流（stdout）或标准错误流（stderr），也可以是通过fopen()函数打开的文件指针- buf ： 缓冲区指针，可以是一个已经分配好的缓冲区，也可以是
NULL。如果buf参数为NULL，则setvbuf()函数将自动为文件流分配一块缓冲区- type ： 缓冲类型，可以取以下值：
_IONBF：不使用缓冲区，直接从或向设备读写数据_IOLBF：行缓冲，每行数据结束后刷新缓冲区_IOFBF：全缓冲，填满缓冲区后才进行读写操作- size： 缓冲区大小，如果
buf参数不为NULL，则size参数指定了缓冲区大小；如果buf参数为NULL，则size参数指定了系统为缓冲区分配的大小。size参数只对全缓冲方式有效，行缓冲和无缓存方式忽略该参数
10.2 演示示例
#include <stdio.h>
int main(void)
{
FILE *input, *output;
char bufr[512];
input = fopen("file.in", "r+b");
output = fopen("file.out", "w");
if (setvbuf(input, bufr, _IOFBF, 512) != 0)
printf("failed to set up buffer for input file\n");
else
printf("buffer set up for input file\n");
if (setvbuf(output, NULL, _IOLBF, 132) != 0)
printf("failed to set up buffer for output file\n");
else
printf("buffer set up for output file\n");
fclose(input);
fclose(output);
return 0;
}
在上述的示例程序中，
- 我们首先定义了两个文件指针变量
input和output，分别表示输入文件和输出文件。 - 然后调用
fopen()函数打开输入文件和输出文件，并将返回的文件指针保存到对应的变量中。 - 接着，程序使用
setvbuf()函数分别为输入文件和输出文件设置缓冲方式。对于输入文件，使用_IOFBF缓冲类型和大小为512字节的缓冲区；对于输出文件，使用_IOLBF缓冲类型和大小为132字节的缓冲区（此处bufr缓冲区为空指针）。在设置完缓冲方式后，程序根据setvbuf()函数的返回值判断是否设置成功，如果返回值不为 0，则说明设置失败，否则说明设置成功，并输出相应的提示信息。 - 最后，程序使用
fclose()函数关闭输入文件和输出文件。
注意： 在使用文件流进行读写操作时，必须在适当的时候进行缓冲区清理操作，以避免数据丢失或者读取到过期数据等问题。另外，需要根据具体需求选择合适的缓冲方式和缓冲区大小，以实现最优的性能和稳定性。
10.3 运行结果
