Spec-Zone.ru › Haskell 8

System.Environment.Blank

Авторские права (c) Habib Alamin 2017
Лицензия BSD-style (см. файл libraries/base/LICENSE)
Поддерживающий libraries@haskell.org
Устойчивость предварительная
Переносимость переносимый
Безопасный Haskell Безопасный
Язык Haskell2010

Описание

Реализация setEnv, которая позволяет использовать пустые переменные окружения. Имитирует модуль Env из пакета unix, но с поддержкой Windows.

Матрица платформ, которые:

  • поддерживают putenv(FOO) для удаления переменных окружения,
  • поддерживают putenv("FOO=") для удаления переменных окружения или установки их в пустые значения,
  • поддерживают unsetenv для удаления переменных окружения,
  • поддерживают setenv для установки переменных окружения,
  • и т.д.

является очень сложной. Некоторые платформы вообще не поддерживают удаление переменных окружения.

getExecutablePath :: IO FilePath Исходный код

Возвращает абсолютный путь к текущему исполняемому файлу.

Обратите внимание, что для скриптов и интерактивных сессий это путь к интерпретатору (например, ghci).

С версии base 4.11.0.0, getExecutablePath разрешает символьные ссылки в Windows. Если исполняемый файл запущен через символическую ссылку, getExecutablePath возвращает абсолютный путь к исходному исполняемому файлу.

С версии: base-4.6.0.0

getArgs :: IO [Строка] Исходный код

Вычисление getArgs возвращает список аргументов командной строки программы (без имени программы).

getProgName :: IO Строка Исходный код

Вычисление getProgName возвращает имя программы в соответствии с тем, как она была вызвана.

Однако это сложно или невозможно реализовать на некоторых не-Unix системах, поэтому для максимальной переносимости мы возвращаем только имя файла программы, как она была вызвана. Даже тогда есть некоторые различия между платформами: например, в Windows программа, вызванная как foo, вероятно, фактически FOO.EXE, и именно это getProgName вернёт.

withArgs :: [Строка] -> IO a -> IO a Исходный код

withArgs args act - во время выполнения действия act, имеем getArgs возвращать args.

withProgName :: Строка -> IO a -> IO a Исходный код

withProgName name act - во время выполнения действия act, имеем getProgName возвращать name.

getEnvironment :: IO [(Строка, Строка)] Исходный код

getEnvironment получает всё окружение в виде списка пар (key,value).

Если запись окружения не содержит символа '=', то key — вся запись, а value — пустая строка.

getEnv :: Строка -> IO (Возможность Строка) Исходный код

Аналогично lookupEnv.

getEnvDefault Исходный код

Аргументы

:: Строка

имя переменной

-> Строка

значение по умолчанию

-> IO Строка

значение переменной или значение по умолчанию

Получение значения переменной окружения или значения по умолчанию.

setEnv Исходный код

Аргументы

:: Строка

имя переменной

-> Строка

значение переменной

-> Bool

перезапись

-> IO ()

Подобно setEnv, но допускает пустые значения переменных окружения и имитирует сигнатуру функции setEnv из пакета unix.

unsetEnv :: Строка -> IO () Исходный код

Подобно unsetEnv, но позволяет удалять пустые переменные окружения. Может выбросить исключение, если платформа не поддерживает удаление переменных окружения.

© The University of Glasgow and others
Licensed under a BSD-style license (see top of the page).
https://downloads.haskell.org/~ghc/8.10.2/docs/html/libraries/base-4.14.1.0/System-Environment-Blank.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API