env.el 2.49 KB
Newer Older
1
;;; env.el --- functions to manipulate environment variables.
Eric S. Raymond's avatar
Eric S. Raymond committed
2

Richard M. Stallman's avatar
Richard M. Stallman committed
3
;;; Copyright 1991, 1994 Free Software Foundation, Inc.
Eric S. Raymond's avatar
Eric S. Raymond committed
4

Eric S. Raymond's avatar
Eric S. Raymond committed
5
;; Maintainer: FSF
6
;; Keywords: processes, unix
Eric S. Raymond's avatar
Eric S. Raymond committed
7

Jim Blandy's avatar
Jim Blandy committed
8 9 10 11
;;; This file is part of GNU Emacs.

;;; GNU Emacs is free software; you can redistribute it and/or modify
;;; it under the terms of the GNU General Public License as published by
Eric S. Raymond's avatar
Eric S. Raymond committed
12
;;; the Free Software Foundation; either version 2, or (at your option)
Jim Blandy's avatar
Jim Blandy committed
13 14 15 16 17 18 19 20 21 22 23
;;; any later version.

;;; GNU Emacs is distributed in the hope that it will be useful,
;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;;; GNU General Public License for more details.

;;; You should have received a copy of the GNU General Public License
;;; along with GNU Emacs; see the file COPYING.  If not, write to
;;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.

24 25 26 27 28 29 30
;;; Commentary:

;; UNIX processes inherit a list of name-to-string associations from
;; their parents called their `environment'; these are commonly used
;; to control program options.  This package permits you to set
;; environment variables to be passed to any sub-process run under Emacs.

Eric S. Raymond's avatar
Eric S. Raymond committed
31 32
;;; Code:

33
;;;###autoload
34
(defun setenv (variable &optional value unset)
Jim Blandy's avatar
Jim Blandy committed
35
  "Set the value of the environment variable named VARIABLE to VALUE.
36 37
VARIABLE should be a string.  VALUE is optional; if not provided or is
`nil', the environment variable VARIABLE will be removed.  
38 39

Interactively, a prefix argument means to unset the variable.
Richard M. Stallman's avatar
Richard M. Stallman committed
40
This function works by modifying `process-environment'."
41 42 43 44 45 46
  (interactive
   (if current-prefix-arg
       (list (read-string "Clear environment variable: ") nil t)
     (let ((var (read-string "Set environment variable: ")))
       (list var (read-string (format "Set %s to value: " var))))))
  (if unset (setq value nil))
Jim Blandy's avatar
Jim Blandy committed
47
  (if (string-match "=" variable)
48
      (error "Environment variable name `%s' contains `='" variable)
Eric S. Raymond's avatar
Eric S. Raymond committed
49
    (let ((pattern (concat "\\`" (regexp-quote (concat variable "="))))
50
	  (case-fold-search nil)
51 52 53 54 55 56 57 58 59 60 61 62
	  (scan process-environment)
	  found)
      (while scan
	(cond ((string-match pattern (car scan))
	       (setq found t)
	       (if (eq nil value)
		   (setq process-environment (delq (car scan) process-environment))
		 (setcar scan (concat variable "=" value)))
	       (setq scan nil)))
	(setq scan (cdr scan)))
      (or found
	  (if value
63
	      (setq process-environment
64 65
		    (cons (concat variable "=" value)
			  process-environment)))))))
Jim Blandy's avatar
Jim Blandy committed
66

67 68 69
(provide 'env)

;;; env.el ends here