D Programming Language 2.0

- Comments
- D
- Search
- Home

Last update Sun Jul 10 10:47:31 2011

# std.process

License:
Boost License 1.0.

Authors:
Walter Bright, Andrei Alexandrescu

Source:
std/process.d

int system(string command);
  Execute command in a command shell.

  Returns:
  If command is null, returns nonzero if the command interpreter is found, and zero otherwise. If command is not null, returns -1 on error, or the exit status of command (which may in turn signal an error in command's execution).

  Note:
  On Unix systems, the homonym C function (which is accessible to D programs as std.c.system) returns a code in the same format as waitpid, waitpid, meaning that C programs must use the WEXITSTATUS macro to extract the actual exit code from the system call. D's system automatically extracts the exit status.

int execv(in string pathname, in string[] argv);
int execve(in string pathname, in string[] argv, in string[] envp);
int execvp(in string pathname, in string[] argv);
int execvpe(in string pathname, in string[] argv, in string[] envp);
  Execute program specified by pathname, passing it the arguments (argv) and the environment (envp), returning the exit status. The 'p' versions of exec search the PATH environment variable setting for the program.

alias getpid;
  Returns the process ID of the calling process, which is guaranteed to be unique on the system. This call is always successful.

  Example:

       writefln("Current process id: %s", getpid());

string shell(string cmd);
  Runs cmd in a shell and returns its standard output. If the process could not be started or exits with an error code, throws an exception.

  Example:

         auto tempFilename = chomp(shell("mcookie"));
         auto f = enforce(fopen(tempFilename), "w");
         scope(exit)
         {
             fclose(f) == 0 || assert(false);
             system("rm " ~ tempFilename);
         }
         ... use f ...

string getenv(in char[] name);
  Gets the value of environment variable name as a string. Calls std.c.stdlib.getenv internally.

alias environment;
  Manipulates environment variables using an associative-array-like interface.

  Examples:

          // Return variable, or throw an exception if it doesn't exist.
          auto path = environment["PATH"];

          // Add/replace variable.
          environment["foo"] = "bar";

          // Remove variable.
          environment.remove("foo");

          // Return variable, or null if it doesn't exist.
          auto foo = environment.get("foo");

          // Return variable, or a default value if it doesn't exist.
          auto foo = environment.get("foo", "default foo value");

          // Return an associative array of type string[string] containing
          // all the environment variables.
          auto aa = environment.toAA();

Copyright Digital Mars 2007 - 2009. | Page generated by Ddoc.