go package學習——os/exec

這是一個建立於 的文章，其中的資訊可能已經有所發展或是發生改變。

package exec用於運行外部命令，它封裝了os.StartProcess，從而使操作更容易。

Index 

• Variables
• func LookPath(file string) (string, error)
• type Cmd
  • func Command(name string, arg ...string) *Cmd
  • func (c *Cmd) CombinedOutput() ([]byte, error)
  • func (c *Cmd) Output() ([]byte, error)
  • func (c *Cmd) Run() error
  • func (c *Cmd) Start() error
  • func (c *Cmd) StderrPipe() (io.ReadCloser, error)
  • func (c *Cmd) StdinPipe() (io.WriteCloser, error)
  • func (c *Cmd) StdoutPipe() (io.ReadCloser, error)
  • func (c *Cmd) Wait() error
• type Error
  • func (e *Error) Error() string
• type ExitError
  • func (e *ExitError) Error() string

Examples 

• Cmd.Output
• Cmd.Start
• Cmd.StdoutPipe
• Command
• LookPath

Package Files 

exec.go lp_unix.go

1. 基本函數

func LookPath

func LookPath(file string) (string, error)

LookPath根據所給的二進位檔案名file在PATH環境變數中尋找此二進位檔案所在的路徑資訊：

path, err := exec.LookPath("fortune")if err != nil {    log.Fatal("installing fortune is in your future")}fmt.Printf("fortune is available at %s\n", path)

2. type Cmd

type Cmd struct {        Path string    Args []string    Dir string    Stdin io.Reader    Stdout io.Writer    Stderr io.Writer    ExtraFiles []*os.File    SysProcAttr *syscall.SysProcAttr    Process *os.Process    ProcessState *os.ProcessState}

Cmd代表一個外部命令，此外部命令已準備好或已經在run。

func Command

func Command(name string, arg ...string) *Cmd

Command返回用於執行name代表的命令的Cmd結構，Cmd中設定了Path和Args，其它fields都為空白。例子如下：

cmd := exec.Command("tr", "a-z", "A-Z")cmd.Stdin = strings.NewReader("some input")var out bytes.Buffercmd.Stdout = &outerr := cmd.Run()if err != nil {    log.Fatal(err)}fmt.Printf("in all caps: %q\n", out.String())

func (*Cmd) CombinedOutput

func (c *Cmd) CombinedOutput() ([]byte, error)

運行命令c，並返回combined output和error。

func (*Cmd) Output

func (c *Cmd) Output() ([]byte, error)

運行命令c，並返回標準輸出，例子如下：

out, err := exec.Command("date").Output()if err != nil {    log.Fatal(err)}fmt.Printf("The date is %s\n", out)

func (*Cmd) Run

func (c *Cmd) Run() error

Run運行指定的命令c，並等待其完成。

func (*Cmd) Start

func (c *Cmd) Start() error

Start也運行一個指定的命令c，但不等待其完成。例子如下：

cmd := exec.Command("sleep", "5")err := cmd.Start()if err != nil {    log.Fatal(err)}log.Printf("Waiting for command to finish...")err = cmd.Wait()log.Printf("Command finished with error: %v", err)

func (*Cmd) Wait

func (c *Cmd) Wait() error

Wait等待命令c退出，命令c必須是由Start方法啟動並執行。會阻塞在那裡？