setenv

设置环境变量

全页折叠

语法

setenv(varname,varvalue)
setenv(varname)
setenv(d)

说明

setenv(varname,varvalue) 设置操作系统环境变量的值。如果 varname 已作为环境变量存在，则 setenv 会将其当前值替换为 varvalue。如果 varname 不存在，则 setenv 会创建一个名为 varname 的环境变量，并将 varvalue 赋给该变量。

setenv 将 varname 和 varvalue 原样传递给操作系统。特殊字符（如 ;、/、:、$%）在 varvalue 中未展开。

使用 MATLAB® system、unix、dos 或 ! 函数启动的进程会读取使用 setenv 函数赋给变量的值。对环境变量的更改不会在 MATLAB 会话之间持久保留。

示例

setenv(varname) 将空值赋给 varname。此语法等效于 setenv(varname,"")。在大多数 UNIX® 平台上，环境变量可以空值 ("") 形式存在。在 Microsoft® Windows® 平台上，此语法等同于删除该变量。

setenv(d) 将所有字典值赋给其关联的环境变量名称。 (自 R2023a 起)

示例

全部折叠

setenv("TEMP","C:\TEMP");
getenv("TEMP")

ans = 'C:\TEMP'

setenv("PATH",getenv("PATH") + ";D:\myfolder");
打开实时脚本

创建多个环境变量，然后检查它们是否存在。

setenv(["Var1" "Var2" "Var3" "Var4"],["Val1" "Val2" "Val3" "Val4"]);
isenv(["Var1" "Var2"; "Var3" "Var4"])
ans = 2×2 logical array

   1   1
   1   1

使用 unsetenv 删除两个环境变量，然后检查它们是否不再存在。

unsetenv(["Var1" "Var4"]);
isenv(["Var1" "Var2"; "Var3" "Var4"])
ans = 2×2 logical array

   0   1
   1   0

您还可以使用 setenv 和 missing 来删除环境变量。更改一个环境变量的值并删除另一个。 

setenv(["Var2" "Var3"],["ValB" missing]);
isenv(["Var1" "Var2"; "Var3" "Var4"])
ans = 2×2 logical array

   0   1
   0   0

输入参数

全部折叠

环境变量名称，指定为字符串数组、字符向量或字符向量元胞数组。

varname 中的最大字符数为 215 - 2，即 32,766。如果 varname 包含 = 字符，则 setenv 会抛出错误。名称中包含 = 的环境变量的行为未明确定义。

示例: "PATH"

环境变量值，指定为字符串数组、字符向量、字符向量元胞数组、数值标量或 missing。通过将环境变量的值设置为 missing 来删除该环境变量。

示例: "C:\TEMP"

环境变量名称和值，指定为字典。指定的字典可以包含字符串数组或字符向量元胞数组。

示例: dictionary(["varname1","varname2"],["varvalue1","varvalue2"])

示例: dictionary({'varname1','varname2'},{'varvalue1','varvalue2'})

扩展功能

全部展开

版本历史记录

在 R2006a 之前推出

全部展开

另请参阅

函数

主题