X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=System%2FEnvironment.hs;h=3271e29422e0adaf98c46412597bc8744a3d8940;hb=bb534f206682be14daf72b33c6105ab27295c6ac;hp=19bccf35453b7ae01fbcdf97292685251d03a6e0;hpb=75ea0fa2485c169f0546d5d40477d2f6747efe29;p=ghc-base.git diff --git a/System/Environment.hs b/System/Environment.hs index 19bccf3..3271e29 100644 --- a/System/Environment.hs +++ b/System/Environment.hs @@ -17,20 +17,21 @@ module System.Environment getArgs, -- :: IO [String] getProgName, -- :: IO String getEnv, -- :: String -> IO String -#ifdef __GLASGOW_HASKELL__ +#ifndef __NHC__ withArgs, withProgName, #endif +#ifdef __GLASGOW_HASKELL__ + getEnvironment, +#endif ) where import Prelude -#ifndef __NHC__ -import Control.Exception ( bracket ) -#endif #ifdef __GLASGOW_HASKELL__ import Foreign import Foreign.C +import Control.Exception ( bracket ) import Control.Monad import GHC.IOBase #endif @@ -50,7 +51,7 @@ import System -- --------------------------------------------------------------------------- -- getArgs, getProgName, getEnv --- Computation `getArgs' returns a list of the program's command +-- | Computation 'getArgs' returns a list of the program's command -- line arguments (not including the program name). #ifdef __GLASGOW_HASKELL__ @@ -100,17 +101,19 @@ unpackProgName argv = do isPathSeparator :: Char -> Bool isPathSeparator '/' = True -#ifdef mingw32_TARGET_OS +#ifdef mingw32_HOST_OS isPathSeparator '\\' = True #endif isPathSeparator _ = False --- Computation `getEnv var' returns the value --- of the environment variable {\em var}. - --- This computation may fail with --- NoSuchThing: The environment variable does not exist. +-- | Computation 'getEnv' @var@ returns the value +-- of the environment variable @var@. +-- +-- This computation may fail with: +-- +-- * 'System.IO.Error.isDoesNotExistError' if the environment variable +-- does not exist. getEnv :: String -> IO String getEnv name = @@ -125,17 +128,19 @@ foreign import ccall unsafe "getenv" c_getenv :: CString -> IO (Ptr CChar) {-| -@withArgs args act@ - while executing action @act@, have 'System.getArgs' -return @args@ (GHC only). +'withArgs' @args act@ - while executing action @act@, have 'getArgs' +return @args@. -} +withArgs :: [String] -> IO a -> IO a withArgs xs act = do p <- System.Environment.getProgName withArgv (p:xs) act {-| -@withProgName name act@ - while executing action @act@, -have 'System.getProgName' return @name@ (GHC only). +'withProgName' @name act@ - while executing action @act@, +have 'getProgName' return @name@. -} +withProgName :: String -> IO a -> IO a withProgName nm act = do xs <- System.Environment.getArgs withArgv (nm:xs) act @@ -143,6 +148,7 @@ withProgName nm act = do -- Worker routine which marshals and replaces an argv vector for -- the duration of an action. +withArgv :: [String] -> IO a -> IO a withArgv new_args act = do pName <- System.Environment.getProgName existing_args <- System.Environment.getArgs @@ -164,4 +170,26 @@ setArgs argv = do foreign import ccall unsafe "setProgArgv" setArgsPrim :: Int -> Ptr CString -> IO () + +-- |'getEnvironment' retrieves the entire environment as a +-- list of @(key,value)@ pairs. +-- +-- If an environment entry does not contain an @\'=\'@ character, +-- the @key@ is the whole entry and the @value@ is the empty string. + +getEnvironment :: IO [(String, String)] +getEnvironment = do + pBlock <- getEnvBlock + if pBlock == nullPtr then return [] + else do + stuff <- peekArray0 nullPtr pBlock >>= mapM peekCString + return (map divvy stuff) + where + divvy str = + case break (=='=') str of + (xs,[]) -> (xs,[]) -- don't barf (like Posix.getEnvironment) + (name,_:value) -> (name,value) + +foreign import ccall unsafe "__hscore_environ" + getEnvBlock :: IO (Ptr CString) #endif /* __GLASGOW_HASKELL__ */