next | previous | forward | backward | up | top | index | toc | Macaulay2 website
Macaulay2Doc :: runProgram

runProgram -- run an external program

Synopsis

Description

This method runs an external program which has already been loaded using findProgram. The results of this run are available in a ProgramRun object.

i1 : gfan = findProgram("gfan", "gfan --help")

o1 = gfan

o1 : Program
i2 : runProgram(gfan, "_version")

o2 = 0

o2 : ProgramRun
i3 : oo#"output"

o3 = Gfan version:
     gfan0.5

     Forked from source tree on:
     1295969599 Tue Jan 25 16:33:19 2011

     Linked libraries:
     GMP 6.1.2
     Cddlib       YES
     SoPlex        NO
     Singular      NO
i4 : runProgram(gfan, "_foo", RaiseError => false)

o4 = 0

o4 : ProgramRun
i5 : oo#"error"

o5 = UNKNOWN OPTION: _foo.
     USE --help AS A SINGLE OPTION TO VIEW THE HELP TEXT.

See also

Ways to use runProgram :

For the programmer

The object runProgram is a method function with options.