C语言函数大全

本篇介绍C语言函数大全-- _w 开头的函数

1. _wspawnl

1.1 函数说明

函数声明	函数功能
int _wspawnl(int mode, const wchar_t* cmdname, const wchar_t* arglist, ...);	启动一个新的进程并运行指定的可执行文件

参数：

• mode ： 启动命令的模式，可以是 _P_WAIT 或 _P_NOWAIT 的任意一种：
  • _P_WAIT ：等待新进程结束之后才继续执行当前进程
  • _P_NOWAIT ：不等待新进程结束，立即返回并继续执行当前进程
• cmdname ： 要执行的可执行文件的名称，可以包含完整路径或者只有文件名。如果只有文件名，则将从当前工作目录中查找可执行文件。如果当前工作目录中没有找到该文件，则将失败并返回错误代码。
• arglist ： 可选，传递给子进程的命令行参数字符串。多个参数以空格分隔
• … ： 可选，用于传递命令行参数的可变参数列表，必须以一个 NULL 结尾

1.2 演示示例

1.2.1 SubTest.c

#include <stdio.h>
int main(int argc, char *argv[])
{
	printf("exec %s, Hello, %s", argv[0], argv[1]);
 	return 0;
} 

1.2.2 Test.c

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

int main()
{
    const wchar_t* cmdname = L"SubTest.exe";
    const wchar_t* arglist = L"SubTest.exe huazie";

    // 同步启动新进程，等待子进程完成
    int mode = _P_WAIT;

    // 启动新进程
    int result = _wspawnl(mode, cmdname, arglist, NULL);

    // 打印子进程的退出代码
    printf("\nChild process exited with code %d\n", result);

    return 0;
}

注意： 上述示例是一个同步（阻塞）调用。如果你想启动一个异步进程（不等待它结束），则可以将 mode 参数设置为 _P_NOWAIT。在这种情况下，函数会立即返回，父进程不会等待新进程完成。

1.3 运行结果

2. _wspawnle

2.1 函数说明

函数声明	函数功能
int _wspawnle(int mode, const wchar_t* cmdname, const wchar_t* arglist, ... , const wchar_t* envptr[]);	启动一个新的进程并通过指定的环境变量传递参数，来运行指定的可执行文件

参数：

• mode ： 启动命令的模式，可以是 _P_WAIT 或 _P_NOWAIT 的任意一种：
  • _P_WAIT ：等待新进程结束之后才继续执行当前进程
  • _P_NOWAIT ：不等待新进程结束，立即返回并继续执行当前进程
• cmdname ： 要执行的可执行文件的名称，可以包含完整路径或者只有文件名。如果只有文件名，则将从当前工作目录中查找可执行文件。如果当前工作目录中没有找到该文件，则将失败并返回错误代码。
• arglist ： 可选，传递给子进程的命令行参数字符串。多个参数以空格分隔
• … ： 可选，用于传递命令行参数的可变参数列表，必须以一个 NULL 结尾
• envptr： 可选，包含所有需要在子进程中使用的环境变量。如果为 NULL，则子进程使用调用进程的当前环境

2.2 演示示例

2.2.1 SubEnvTest.c

#include <process.h>
#include <processenv.h>
#include <stdio.h>

int main(int argc, char *argv[], char **envp)
{
	printf("SubEnvTest Command line arguments:\n");
	for (int i=0; i<argc; i++)
        printf("[%d] : %s\n", i, argv[i]);
	printf("exec %s, Hello, %s\n", argv[0], argv[1]);

	for (int i = 0; envp[i] != NULL; i++)
	{
		printf("%s\n", envp[i]);
	}

	// while(*envp != NULL)
 	//    printf("  %s\n", *(envp++));

 	return 0;
} 

2.2.2 Test.c

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

int main()
{
    const wchar_t* cmdname = L"SubEnvTest.exe";
    const wchar_t* arglist[] = { L"SubEnvTest.exe", L"Huazie", NULL };
    const wchar_t* envptr[] = { L"Hello=world", NULL };

    // 同步启动新进程，等待子进程完成
    int mode = _P_WAIT;

    // 启动新进程
    int result = _wspawnle(mode, cmdname, arglist[0], arglist[1], NULL, envptr);

    // 打印子进程的退出代码
    printf("\nChild process exited with code %d\n", result);

    return 0;
}

2.3 运行结果

3. _wspawnlp

3.1 函数说明

函数声明	函数功能
int _wspawnl(int mode, const wchar_t* cmdname, const wchar_t* arg0, ...);	启动一个新的进程并运行指定的可执行文件。它与 _wspawnl 函数类似，但参数列表略有不同

参数：

• mode ： 启动命令的模式，可以是 _P_WAIT 或 _P_NOWAIT 的任意一种：
  • _P_WAIT ：等待新进程结束之后才继续执行当前进程
  • _P_NOWAIT ：不等待新进程结束，立即返回并继续执行当前进程
• cmdname ： 要执行的可执行文件的名称，可以包含完整路径或者只有文件名。如果只有文件名，则会在环境变量 PATH 指定的目录中查找可执行文件
• arg0 ： 可选，第一个命令行参数字符串
• … ： 可选，用于传递命令行参数的可变参数列表，必须以一个 NULL 结尾

3.2 演示示例

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

int main()
{
    const wchar_t* cmdname = L"java.exe";
    const wchar_t* arg0 = L"java.exe";
    const wchar_t* arg1 = L"-version";

    // 同步启动新进程，等待子进程完成
    int mode = _P_WAIT;

    // 启动新进程
    int result = _wspawnlp(mode, cmdname, arg0, arg1, NULL);

    // 打印子进程的退出代码
    printf("\nChild process exited with code %d\n", result);

    return 0;
}

3.3 运行结果

4. _wspawnlpe

4.1 函数说明

函数声明	函数功能
int _wspawnlpe(int mode, const wchar_t* cmdname, const wchar_t* arg0, ... , const wchar_t* envptr[]);	用于启动一个新进程并运行指定的可执行文件。它与 _wspawnle 函数类似，但参数列表略有不同

参数：

• mode ： 启动命令的模式，可以是 _P_WAIT 或 _P_NOWAIT 的任意一种：
  • _P_WAIT ：等待新进程结束之后才继续执行当前进程
  • _P_NOWAIT ：不等待新进程结束，立即返回并继续执行当前进程
• cmdname ： 要执行的可执行文件的名称，可以包含完整路径或者只有文件名。如果只有文件名，则会在环境变量 PATH 指定的目录中查找可执行文件
• arg0 ： 可选，第一个命令行参数字符串
• … ： 可选，用于传递命令行参数的可变参数列表，必须以一个 NULL 结尾
• envptr： 可选，包含所有需要在子进程中使用的环境变量。如果为 NULL，则子进程使用调用进程的当前环境

4.2 演示示例

4.2.1 SubEnvTest.c

参考 2.2.1 中所示即可，不再赘述

4.2.2 Test.c

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

int main()
{
    const wchar_t* cmdname = L"SubEnvTest.exe";
    const wchar_t* arg0 = L"SubEnvTest.exe";
    const wchar_t* arg1 = L"Huazie";
    const wchar_t* arg2 = L"helloworld";
    const wchar_t* envp[] = { L"key=value", NULL };

    // 同步启动新进程，等待子进程完成
    int mode = _P_WAIT;

    // 启动新进程
    int result = _wspawnlpe(mode, cmdname, arg0, arg1, arg2, NULL, envp);

    // 打印子进程的退出代码
    printf("Child process exited with code %d\n", result);

    return 0;
}

4.3 运行结果

5. _wspawnv

5.1 函数说明

函数声明	函数功能
int _wspawnv(int mode, const wchar_t* cmdname, const wchar_t* const argv[]);	用于启动一个新进程并运行指定的可执行文件

参数：

• mode ： 启动命令的模式，可以是 _P_WAIT 或 _P_NOWAIT 的任意一种：
  • _P_WAIT ：等待新进程结束之后才继续执行当前进程
  • _P_NOWAIT ：不等待新进程结束，立即返回并继续执行当前进程
• cmdname ： 要执行的可执行文件的名称，可以包含完整路径或者只有文件名。如果只有文件名，则将从当前工作目录中查找可执行文件。如果当前工作目录中没有找到该文件，则将失败并返回错误代码。
• argv ： 要传递给子进程的命令行参数。该数组中最后一个元素必须是 NULL

5.2 演示示例

5.2.1 SubTest.c

参考 1.2.1 中所示即可，不再赘述

5.2.2 Test.c

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

int main()
{
    const wchar_t* cmdname = L"SubTest.exe";
    const wchar_t* argv[] = { L"SubTest.exe", L"Huazie", NULL };

    // 同步启动新进程，等待子进程完成
    int mode = _P_WAIT;

    // 启动新进程
    int result = _wspawnv(mode, cmdname, argv);

    // 打印子进程的退出代码
    printf("\nChild process exited with code %d\n", result);

    return 0;
}

5.3 运行结果

6. _wspawnve

6.1 函数说明

函数声明	函数功能
int _wspawnve(int mode, const wchar_t* cmdname, const wchar_t* const argv[], const wchar_t* const envp[]);	用于启动一个新进程并运行指定的可执行文件

参数：

• mode ： 启动命令的模式，可以是 _P_WAIT 或 _P_NOWAIT 的任意一种：
  • _P_WAIT ：等待新进程结束之后才继续执行当前进程
  • _P_NOWAIT ：不等待新进程结束，立即返回并继续执行当前进程
• cmdname ： 要执行的可执行文件的名称，可以包含完整路径或者只有文件名。如果只有文件名，则将从当前工作目录中查找可执行文件。如果当前工作目录中没有找到该文件，则将失败并返回错误代码。
• argv ： 要传递给子进程的命令行参数。该数组中最后一个元素必须是 NULL
• envp： 可选，包含所有需要在子进程中使用的环境变量。如果为 NULL，则子进程使用调用进程的当前环境

6.2 演示示例

6.2.1 SubEnvTest.c

参考 2.2.1 中所示即可，不再赘述

6.2.2 Test.c

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

int main()
{
    const wchar_t* cmdname = L"SubEnvTest.exe";
    const wchar_t* argv[] = { L"SubEnvTest.exe", L"Huazie", L"helloworld", NULL };
    const wchar_t* envp[] = { L"key=value", NULL };

    // 同步启动新进程，等待子进程完成
    int mode = _P_WAIT;

    // 启动新进程
    int result = _wspawnve(mode, cmdname, argv, envp);

    // 打印子进程的退出代码
    printf("Child process exited with code %d\n", result);

    return 0;
}

6.3 运行结果

7. _wspawnvp

7.1 函数说明

函数声明	函数功能
int _wspawnvp(int mode, const wchar_t* cmdname, const wchar_t* const argv[]);	用于启动一个新进程并运行指定的可执行文件

参数：

• mode ： 启动命令的模式，可以是 _P_WAIT 或 _P_NOWAIT 的任意一种：
  • _P_WAIT ：等待新进程结束之后才继续执行当前进程
  • _P_NOWAIT ：不等待新进程结束，立即返回并继续执行当前进程
• cmdname ： 要执行的可执行文件的名称，可以包含完整路径或者只有文件名。如果只有文件名，则会在环境变量 PATH 指定的目录中查找可执行文件
• argv ： 要传递给子进程的命令行参数。该数组中最后一个元素必须是 NULL

7.2 演示示例

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

int main()
{
    const wchar_t* cmdname = L"java.exe";
    const wchar_t* argv[] = { L"java.exe", L"-version", NULL };

    // 同步启动新进程，等待子进程完成
    int mode = _P_WAIT;

    // 启动新进程
    int result = _wspawnvp(mode, cmdname, argv);

    // 打印子进程的退出代码
    printf("\nChild process exited with code %d\n", result);

    return 0;
}

7.3 运行结果

8. _wspawnvpe

8.1 函数说明

函数声明	函数功能
int _wspawnvpe(int mode, const wchar_t* cmdname, const wchar_t* const argv[], const wchar_t* const envp[]);	用于启动一个新进程并运行指定的可执行文件

参数：

• mode ： 启动命令的模式，可以是 _P_WAIT 或 _P_NOWAIT 的任意一种：
  • _P_WAIT ：等待新进程结束之后才继续执行当前进程
  • _P_NOWAIT ：不等待新进程结束，立即返回并继续执行当前进程
• cmdname ： 要执行的可执行文件的名称，可以包含完整路径或者只有文件名。如果只有文件名，则会在环境变量 PATH 指定的目录中查找可执行文件
• argv ： 要传递给子进程的命令行参数。该数组中最后一个元素必须是 NULL
• envp： 可选，包含所有需要在子进程中使用的环境变量。如果为 NULL，则子进程使用调用进程的当前环境

8.2 演示示例

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

int main()
{
    const wchar_t* cmdname = L"java.exe";
    const wchar_t* argv[] = { L"java.exe", L"-version", NULL };
    const wchar_t* envp[] = { L"key=value", NULL };

    // 同步启动新进程，等待子进程完成
    int mode = _P_WAIT;

    // 启动新进程
    int result = _wspawnvpe(mode, cmdname, argv, envp);

    // 打印子进程的退出代码
    printf("Child process exited with code %d\n", result);

    return 0;
}

8.3 运行结果

9. _wsystem

9.1 函数说明

函数声明	函数功能
int _wsystem(const wchar_t* command);	用于执行操作系统命令。它会启动一个新进程来执行指定的命令，并等待该进程完成。在命令执行过程中，父进程将会被阻塞。

参数：

• command： 要执行的命令字符串，可以是一个简单的命令名或者是一个完整的命令行

返回值：

• 如果命令执行成功，则返回执行命令后的退出代码；
• 如果命令执行失败，则返回一个负数。

9.2 演示示例

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

int main()
{
    const wchar_t* command = L"cmd /c copy file1.txt file2.txt";

    // 执行命令
    int result = _wsystem(command);

    // 检查命令是否执行成功
    if (result == -1) {
        wprintf(L"Failed to run command.\n");
        return 1;
    }

    // 打印命令的退出代码
    wprintf(L"Command exited with code %d\n", result);

    return 0;
}

9.3 运行结果

运行前：

运行后：

10. _wsearchenv

10.1 函数说明

函数声明	函数功能
int _wsearchenv(const wchar_t* file, const wchar_t* envvar, wchar_t* pathname);	用于在指定的路径中查找指定的文件名

参数：

• file ： 要查找的文件名
• envvar： 可选参数，可以用来指定一个环境变量名，该环境变量包含一个路径列表，其中包括要搜索的文件所在的路径。如果未提供环境变量名，则函数将仅搜索当前工作目录。
• pathname ： 存储找到的文件的完整路径的缓冲区。如果找到了文件，则将完整路径复制到这个缓冲区中

返回值：

• 如果找到了指定的文件，则返回一个非零值；
• 否则返回 0

注意： 该函数会先在当前工作目录中搜索指定的文件名，如果找不到，则按照提供的路径列表逐一搜索，直到找到为止。

10.2 演示示例

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

#define MAX_PATH 200

int main()
{
    const wchar_t* file = L"notepad.exe";
    wchar_t path[MAX_PATH];

    // 在 PATH 环境变量中查找文件
    _wsearchenv(file, L"PATH", path);

    // 打印文件的完整路径
    wprintf(L"Found file at: %ls\n", path);

    return 0;
}

10.3 运行结果

11. _wsplitpath

11.1 函数说明

函数声明	函数功能
void _wsplitpath(const wchar_t* path, wchar_t* drive, wchar_t* dir, wchar_t* fname, wchar_t* ext);	用于将路径名分解为其组成部分：驱动器、目录、文件名和扩展名

参数：

• path ： 要分解的路径名
• drive ： 用于存储驱动器号的缓冲区。如果路径名没有驱动器号，则该缓冲区将包含空字符串
• dir ： 用于存储目录部分的缓冲区。如果路径名中不包含目录，则该缓冲区将包含空字符串
• fname ： 用于存储文件名部分的缓冲区。如果路径名中既不包含文件名也不包含扩展名，则该缓冲区将包含空字符串
• ext ： 用于存储扩展名部分的缓冲区。如果路径名中不包含扩展名，则该缓冲区将包含空字符串

11.2 演示示例

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

int main()
{
    const wchar_t* path = L"C:\\Windows\\system32\\notepad.exe";
    wchar_t drive[_MAX_DRIVE];
    wchar_t dir[_MAX_DIR];
    wchar_t fname[_MAX_FNAME];
    wchar_t ext[_MAX_EXT];

    _wsplitpath(path, drive, dir, fname, ext);

    wprintf(L"Drive: %ls\n", drive);
    wprintf(L"Directory: %ls\n", dir);
    wprintf(L"Filename: %ls\n", fname);
    wprintf(L"Extension: %ls\n", ext);

    return 0;
}

11.3 运行结果

12. _wunlink

12.1 函数说明

函数声明	函数功能
int _wunlink(const wchar_t* filename);	用于删除指定的文件

参数：

• filename ： 要删除的文件的完整路径名

返回值：

• 如果删除成功，则返回值为 0；
• 如果删除失败，则返回值为 -1 ，并且设置了全局变量 errno 来指示错误原因。

12.2 演示示例

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

int main()
{
    const wchar_t* filename = L"myfile.txt";
	// const wchar_t* filename = L"file1.txt";
    int result = _wunlink(filename);

    if (result != 0) 
    {
        perror("Failed to delete file ");
        return 1;
    }

    printf("File deleted successfully.\n");

    return 0;
}

注意： 在实际应用中，我们需要小心谨慎使用 _wunlink() 函数，因为它会永久性地删除文件，而且无法撤销。

12.3 运行结果