批处理脚本 - 函数

你好，有抱负的程序员们！今天，我们将深入批处理脚本的奇妙世界，探索函数。作为你友好的邻居电脑老师，我很高兴能引导你完成这次旅程。那么，拿起你最喜欢的饮料，我们开始吧！

Batch Script - Functions

函数是什么？

在我们深入了解之前，先来了解一下函数是什么。可以把函数想象成你脚本中的小助手。它们就像是你主程序中的小程序，执行特定的任务。就像你可能请朋友帮你做某个家务一样，你可以调用这些函数在脚本中执行特定的作业。

函数定义

现在，让我们来学习如何创建这些有用的助手。在批处理脚本中，我们使用标签来定义函数。以下是基本结构：

:functionName
REM 你的函数代码放在这里
REM ...
REM ...
goto :eof

让我们分解一下：

:functionName 是标记函数开始的标签。
标签后面的行包含你的函数实际代码。
goto :eof 告诉脚本跳到文件末尾，实际上结束了函数。

这里有一个简单的例子：

:sayHello
echo Hello, World!
goto :eof

这个函数在被调用时，会简单地在控制台打印 "Hello, World!"。

调用函数

现在我们已经创建了一个函数，我们如何使用它呢？我们使用 call 命令。下面是如何操作的：

@echo off
call :sayHello
pause

:sayHello
echo Hello, World!
goto :eof

当你运行这个脚本时，它会输出：

Hello, World!
按任意键继续 . . .

call 命令告诉脚本执行我们的 sayHello 函数。

带参数的函数

当我们可以向函数传递信息时，函数变得更有力。这些信息片段被称为参数。让我们修改一下 sayHello 函数，让它向特定的人打招呼：

@echo off
call :sayHello John
pause

:sayHello
echo Hello, %~1!
goto :eof

输出：

Hello, John!
按任意键继续 . . .

在这个例子中，%~1 代表传递给函数的第一个参数。当我们调用 sayHello John 时，"John" 变成了第一个参数。

带多个参数的函数

我们可以向函数传递多个参数。让我们创建一个函数来相加两个数字：

@echo off
call :addNumbers 5 3
pause

:addNumbers
set /a result=%~1 + %~2
echo The sum of %~1 and %~2 is %result%
goto :eof

输出：

The sum of 5 and 3 is 8
按任意键继续 . . .

在这里，%~1 代表第一个参数（5），%~2 代表第二个参数（3）。

从函数返回值

在批处理脚本中，函数不会以传统意义上的返回值。然而，我们可以使用环境变量来模拟这种行为：

@echo off
call :multiply 6 7
echo The result is %result%
pause

:multiply
set /a result=%~1 * %~2
goto :eof

输出：

The result is 42
按任意键继续 . . .

在这个例子中，multiply 函数设置了一个变量 result，然后我们可以在主脚本中使用它。

函数中的局部变量

在处理函数时，通常使用局部变量是个好主意，以避免干扰主脚本中的变量。我们可以使用 setlocal 和 endlocal 命令来实现：

@echo off
set globalVar=I'm global
call :localVarDemo
echo After function call: %globalVar%
pause

:localVarDemo
setlocal
set globalVar=I'm local
echo Inside function: %globalVar%
endlocal
goto :eof

输出：

Inside function: I'm local
After function call: I'm global
按任意键继续 . . .

setlocal 命令为函数创建了一个新的环境，而 endlocal 在函数结束时丢弃它，保留 globalVar 的原始值。

函数库

随着你的脚本变得越来越复杂，你可能会发现自己需要在多个脚本中使用相同的函数。而不是在每个脚本中复制和粘贴这些函数，你可以创建一个函数库：

创建一个新文件，我们称之为 myFunctions.bat
在这个文件中放置你常用的函数
在你的主脚本中，使用 call 命令来运行这个文件，然后使用它的函数

myFunctions.bat:

:sayHello
echo Hello, %~1!
goto :eof

:addNumbers
set /a result=%~1 + %~2
goto :eof

mainScript.bat:

@echo off
call myFunctions.bat

call :sayHello World
call :addNumbers 10 20
echo The sum is %result%
pause

这种方法有助于保持代码的组织性和可重用性。

常见的函数方法

下面是批处理脚本中常见的函数相关方法表：

方法	描述
call	调用函数
goto :eof	结束函数
%~1, %~2, 等.	访问函数参数
setlocal	为变量创建本地环境
endlocal	结束本地环境

记住，熟能生巧！不要害怕尝试这些概念。创建你自己的函数，玩转参数，看看你能构建什么。在你意识到之前，你将能够轻松编写复杂的批处理脚本！

祝编程愉快，未来的程序员们！

Credits: Image by storyset