get_environment_variable按名称读取进程环境变量,并可返回完整值长度、状态以及是否保留变量名尾部空格的控制项。它常用于读取数据目录、线程数和运行模式等外部配置;适合部署环境提供的可选设置,程序应为变量缺失、接收区过短和平台不支持准备明确处理。
语法结构
call get_environment_variable(name [, value, length, status, trim_name])
- name与value是默认character标量;length报告完整环境变量值需要的字符数。
- 正常读取时status为0。接收value过短或变量不存在时status非零,具体失败应按标准接口和处理器文档处理。
- 默认忽略name尾部空格;trim_name=.false.时尾部空格也属于环境变量名。环境变量值始终是文本。
本文代码
! 读取运行配置环境变量,并处理变量不存在的情况。
program envVarsDemo
implicit none
character(len=64) :: value
integer :: valueLength, status
call get_environment_variable("FORTRAN_CASE", value, &
length=valueLength, status=status)
if (status == 0) then
print "(A,A)", "FORTRAN_CASE:", trim(value)
print "(A,I0)", "值长度:", valueLength
else if (status == -1) then
print "(A,I0)", "接收变量过短,需要长度:", valueLength
else
print "(A,I0)", "FORTRAN_CASE不可用,状态码:", status
end if
call get_environment_variable("FORTRAN_NOT_SET", value, &
length=valueLength, status=status)
if (status /= 0) then
print "(A,I0)", "FORTRAN_NOT_SET不存在,状态码:", status
end if
end program envVarsDemo
编译运行
(base) hong@hongdeMacBook-Pro 071.envVars % gfortran -Wall -Wextra -std=f2018 exampleEnvVars.f90 -o envVarsDemo
(base) hong@hongdeMacBook-Pro 071.envVars % FORTRAN_CASE=diffusion ./envVarsDemo
FORTRAN_CASE:diffusion
值长度:9
FORTRAN_NOT_SET不存在,状态码:1
现象分析
shell在启动程序前设置FORTRAN_CASE=diffusion,所以程序读取成功,status为0,valueLength为9,并输出完整字符串。
FORTRAN_NOT_SET没有设置。本机gfortran把status设为1、length设为0,程序依据非零状态进入缺失处理,而不是继续使用旧的value内容。
环境变量来自程序外部,同一可执行文件在不同终端、服务或作业系统中可能读到不同值。关键配置应在输出中记录,并提供默认值或明确报错。
核心知识点
- get_environment_variable读取当前进程继承的环境变量。
- 必须检查status和length,不能只检查value是否为空。
- 环境变量是字符数据,数值或逻辑配置仍需解析和验证。
- 环境变量适合部署配置,不应隐藏程序正确性所必需但未记录的参数。