天天看點

golang os/exec 執行外部指令

exec包執行外部指令,它将os.StartProcess進行包裝使得它更容易映射到stdin和stdout,并且利用pipe連接配接i/o.

func LookPath(file string) (string, error) //LookPath在環境變量中查找科執行二進制檔案,如果file中包含一個斜杠,則直接根據絕對路徑或者相對本目錄的相對路徑去查找

[html] view plain copy

  1. func main() {  
  2.     f, err := exec.LookPath("ls")  
  3.     if err != nil {  
  4.         fmt.Println(err)  
  5.     }  
  6.     fmt.Println(f) //  /bin/ls  
  7. }  

type Cmd   //表示一個正在準備或者正在運作的外部指令

[html] view plain copy

  1. type Cmd struct {  
  2.     Path         string   //運作指令的路徑,絕對路徑或者相對路徑  
  3.     Args         []string   // 指令參數  
  4.     Env          []string         //程序環境,如果環境為空,則使用目前程序的環境  
  5.     Dir          string   //指定command的工作目錄,如果dir為空,則comman在調用程序所在目前目錄中運作  
  6.     Stdin        io.Reader  //标準輸入,如果stdin是nil的話,程序從null device中讀取(os.DevNull),stdin也可以時一個檔案,否則的話則在運作過程中再開一個goroutine去  
  7.              //讀取标準輸入  
  8.     Stdout       io.Writer       //标準輸出  
  9.     Stderr       io.Writer  //錯誤輸出,如果這兩個(Stdout和Stderr)為空的話,則command運作時将響應的檔案描述符連接配接到os.DevNull  
  10.     ExtraFiles   []*os.File     
  11.     SysProcAttr  *syscall.SysProcAttr  
  12.     Process      *os.Process    //Process是底層程序,隻啟動一次  
  13.     ProcessState *os.ProcessState  //ProcessState包含一個退出程序的資訊,當程序調用Wait或者Run時便會産生該資訊.  
  14. }  

func Command(name string, arg ...string) *Cmd    //command傳回cmd結構來執行帶有相關參數的指令,它僅僅設定cmd結構中的Path和Args參數,如果name參數中不包含路徑分隔符,command使用LookPath來解決路徑問題,否則的話就直接使用name;Args直接跟在command指令之後,是以在Args中不許要添加指令.

[html] view plain copy

  1. func main() {  
  2.     cmd := exec.Command("tr", "a-z", "A-Z")  
  3.     cmd.Stdin = strings.NewReader("some input")  
  4.     var out bytes.Buffer  
  5.     cmd.Stdout = &out  
  6.     err := cmd.Run()  
  7.     if err != nil {  
  8.         log.Fatal(err)  
  9.     }  
  10.     fmt.Printf("in all caps: %q\n", out.String())  //in all caps: "SOME INPUT"  
  11. }  

func (c *Cmd) CombinedOutput() ([]byte, error) //運作指令,并傳回标準輸出和标準錯誤

[html] view plain copy

  1. func main() {  
  2.     cmd := exec.Command("ls")  //檢視目前目錄下檔案  
  3.     out, err := cmd.CombinedOutput()  
  4.     if err != nil {  
  5.         fmt.Println(err)  
  6.     }  
  7.     fmt.Println(string(out))  
  8. }  

func (c *Cmd) Output() ([]byte, error)     //運作指令并傳回其标準輸出

[html] view plain copy

  1. func main() {  
  2.     cmd := exec.Command("ls") ///檢視目前目錄下檔案  
  3.     out, err := cmd.Output()  
  4.     if err != nil {  
  5.         fmt.Println(err)  
  6.     }  
  7.     fmt.Println(string(out))  
  8. }  

注意:Output()和CombinedOutput()不能夠同時使用,因為command的标準輸出隻能有一個,同時使用的話便會定義了兩個,便會報錯

func (c *Cmd) Run() error          //開始指定指令并且等待他執行結束,如果指令能夠成功執行完畢,則傳回nil,否則的話邊會産生錯誤

func (c *Cmd) Start() error          //使某個指令開始執行,但是并不等到他執行結束,這點和Run指令有差別.然後使用Wait方法等待指令執行完畢并且釋放響應的資源

[html] view plain copy

  1. func main() {  
  2.     cmd := exec.Command("ls")  
  3.     cmd.Stdout = os.Stdout //  
  4.     cmd.Run()  
  5.     fmt.Println(cmd.Start()) //exec: already started  
  6. }  

注:一個command隻能使用Start()或者Run()中的一個啟動指令,不能兩個同時使用.

func (c *Cmd) StderrPipe() (io.ReadCloser, error)  //StderrPipe傳回一個pipe,這個管道連接配接到command的标準錯誤,當command指令退出時,Wait将關閉這些pipe

func (c *Cmd) StdinPipe() (io.WriteCloser, error)   //StdinPipe傳回一個連接配接到command标準輸入的管道pipe

[html] view plain copy

  1. package main  
  2. import (  
  3.     "fmt"  
  4.     "os"  
  5.     "os/exec"  
  6. )  
  7. func main() {  
  8.     cmd := exec.Command("cat")  
  9.     stdin, err := cmd.StdinPipe()  
  10.     if err != nil {  
  11.         fmt.Println(err)  
  12.     }  
  13.     _, err = stdin.Write([]byte("tmp.txt"))  
  14.     if err != nil {  
  15.         fmt.Println(err)  
  16.     }  
  17.     stdin.Close()  
  18.     cmd.Stdout = os.Stdout     //終端标準輸出tmp.txt  
  19.     cmd.Start()  
  20. }  

func (c *Cmd) StdoutPipe() (io.ReadCloser, error)        //StdoutPipe傳回一個連接配接到command标準輸出的管道pipe

[html] view plain copy

  1. func main() {  
  2.     cmd := exec.Command("ls")  
  3.     stdout, err := cmd.StdoutPipe()  //指向cmd指令的stdout  
  4.     cmd.Start()  
  5.     content, err := ioutil.ReadAll(stdout)  
  6.     if err != nil {  
  7.         fmt.Println(err)  
  8.     }  
  9.     fmt.Println(string(content))     //輸出ls指令檢視到的内容  
  10. }  

func (c *Cmd) Wait() error             //Wait等待command退出,他必須和Start一起使用,如果指令能夠順利執行完并順利退出則傳回nil,否則的話便會傳回error,其中Wait會是放掉所有與cmd指令相關的資源

type Error    //Error傳回科執行二進制檔案名字不能夠執行的原因的錯誤

[html] view plain copy

  1. type Error struct {  
  2.     Name string  
  3.     Err  error  
  4. }  

func (e *Error) Error() string

type ExitError  //一個command不能夠正常退出的error

[html] view plain copy

  1. type ExitError struct {  
  2.     *os.ProcessState  
  3. }  

func (e *ExitError) Error() string

轉載于:https://www.cnblogs.com/zhangym/p/6257415.html