File: exec.xml

package info (click to toggle)
scilab 4.1.2-6
  • links: PTS, VCS
  • area: non-free
  • in suites: lenny
  • size: 113,992 kB
  • ctags: 65,732
  • sloc: ansic: 406,468; fortran: 242,412; xml: 223,812; tcl: 46,703; sh: 10,945; ml: 9,441; makefile: 4,697; cpp: 1,354; java: 926; csh: 260; yacc: 247; perl: 130; lex: 126; asm: 72; lisp: 30
file content (138 lines) | stat: -rw-r--r-- 5,045 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?> 
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
<MAN>
  <LANGUAGE>fr</LANGUAGE>
  <TITLE>exec  </TITLE>
  <TYPE>Scilab Function  </TYPE>
  <DATE>April 1993  </DATE>
  <SHORT_DESCRIPTION name="exec"> excution d&apos;un script (fichier de commandes)  </SHORT_DESCRIPTION>
  <CALLING_SEQUENCE>
    <CALLING_SEQUENCE_ITEM>exec(path [,mode])  </CALLING_SEQUENCE_ITEM>
    <CALLING_SEQUENCE_ITEM>exec(fun [,mode])  </CALLING_SEQUENCE_ITEM>
    <CALLING_SEQUENCE_ITEM>ierr=exec(path,&apos;errcatch&apos; [,mode])  </CALLING_SEQUENCE_ITEM>
    <CALLING_SEQUENCE_ITEM>ierr=exec(fun,&apos;errcatch&apos; [,mode])  </CALLING_SEQUENCE_ITEM>
  </CALLING_SEQUENCE>
  <PARAM>
    <PARAM_INDENT>
      <PARAM_ITEM>
	<PARAM_NAME>path  </PARAM_NAME>
	<PARAM_DESCRIPTION>
	  <SP>
	    : chane de caractres, le chemin du script  excuter
	  </SP>
	</PARAM_DESCRIPTION> 
      </PARAM_ITEM>
      <PARAM_ITEM>
	<PARAM_NAME>mode  </PARAM_NAME>
	<PARAM_DESCRIPTION>
	  <SP>
	    : entier, prcisant le mode d&apos;excution (voir plus bas)
	  </SP>
	</PARAM_DESCRIPTION> 
      </PARAM_ITEM>
      <PARAM_ITEM>
	<PARAM_NAME>fun  </PARAM_NAME>
	<PARAM_DESCRIPTION>
	  <SP>
	    : identificateur d&apos;une fonction scilab
	  </SP>
	</PARAM_DESCRIPTION> 
      </PARAM_ITEM>
      <PARAM_ITEM>
	<PARAM_NAME>ierr  </PARAM_NAME>
	<PARAM_DESCRIPTION>
	  <SP>
	    : entier, 0 ou numro d&apos;erreur 
	  </SP>
	</PARAM_DESCRIPTION> 
      </PARAM_ITEM>
    </PARAM_INDENT>
  </PARAM>
  <DESCRIPTION>
    <P>
      <VERB>exec(path [,mode])</VERB> excute squentiellement les instructions
      Scilab contenues dans le fichier spcifi par <VERB>path</VERB> avec le
      mode d&apos;excution optionnel <VERB>mode</VERB> .
    </P>
    <P>Les diffrentes valeurs de <VERB>mode</VERB> sont :</P>
    <DESCRIPTION_INDENT>
      <DESCRIPTION_ITEM label='0'>
	<SP>: valeur par dfaut</SP>
      </DESCRIPTION_ITEM>
      <DESCRIPTION_ITEM label='-1'>
	<SP>: rien n&apos;est affich</SP>
      </DESCRIPTION_ITEM>
      <DESCRIPTION_ITEM label='1'>
	<SP>: chaque ligne de commande est affiche</SP>
      </DESCRIPTION_ITEM>
      <DESCRIPTION_ITEM label='2'>
	<SP>: l&apos;invite de commande <VERB>--&gt;</VERB> est affich</SP>
      </DESCRIPTION_ITEM>
      <DESCRIPTION_ITEM label='3'>
	<SP>: lignes de commandes + invite de commande</SP>
      </DESCRIPTION_ITEM>
      <DESCRIPTION_ITEM label='4'>
	<SP>: pause dans l&apos;excution au dbut de chaque ligne. L&apos;excution
	reprend aprs un appui sur la touche entre/return. </SP>
      </DESCRIPTION_ITEM>
      <DESCRIPTION_ITEM label='7'>
	<SP>: pause + invite + affichage : ce mode est utile pour les dmonstrations.</SP>
      </DESCRIPTION_ITEM>
    </DESCRIPTION_INDENT>
    <P>
      <VERB>exec(fun [,mode])</VERB> excute la fonction <VERB>fun</VERB> comme
      un script : aucun argument n&apos;est utilis en entre ou en sortie, et
      l&apos;excution se fait dans l&apos;environnement courant (les variables
      cres dans la fonction sont conserves aprs l&apos;excution). Cette
      forme est plus efficace, car ainsi les instructions du script peuvent
      tre pr-compiles (voir getf, comp). Cette mthode d&apos;excution des
      scripts permet aussi de stocker des scripts comme des fonctions dans des
      librairies. 
    </P>
    <P>
      Si une erreur se produit pendant l&apos;excution, si la chane de
      caractres &apos;errcatch&apos; est prsente, <VERB>exec</VERB> ne
      produit pas de message d&apos;erreur, mais stoppe l&apos;excution du
      script et renvoie une valeur de <VERB>ierr</VERB> gale au numro de
      l&apos;erreur. Si la chane &apos;errcatch&apos; n&apos;est pas prsente,
      la gestion habituelle des erreurs est utilise.
    </P>
    
  </DESCRIPTION>
  <SECTION label='REMARQUE'>
    <SP>
      Les scripts peuvent maintenant contenir des dfinitions de fonctions en
      ligne (voir fonction). 
    </SP>
  </SECTION>
  <EXAMPLE><![CDATA[
    // cration d'un script
    mputl('a=1;b=2',TMPDIR+'/myscript')
    // on l'excute
    exec(TMPDIR+'/myscript')
    whos -name "a "

    // cration d'une function
    function y=foo(x),a=x+1;y=a^2,endfunction
    clear a b
    // appel  la fonction
    foo(1)
    // a est une variable cre dans l'environnement de la fonction foo
    // elle est dtruite  la sortie de la fonction.
    whos -name "a "

    x=1 // on cre la variable x pour qu'elle soit connue  l'excution de foo
    exec(foo)
    // a et y ont t cres dans l'environnement courant
    whos -name "a "
    ]]></EXAMPLE>
  <SEE_ALSO>
    <SEE_ALSO_ITEM> <LINK>getf</LINK> </SEE_ALSO_ITEM> 
    <SEE_ALSO_ITEM> <LINK>execstr</LINK> </SEE_ALSO_ITEM> 
    <SEE_ALSO_ITEM> <LINK>evstr</LINK> </SEE_ALSO_ITEM> 
    <SEE_ALSO_ITEM> <LINK>comp</LINK> </SEE_ALSO_ITEM> 
    <SEE_ALSO_ITEM> <LINK>mode</LINK> </SEE_ALSO_ITEM> 
    <SEE_ALSO_ITEM> <LINK>chdir</LINK> </SEE_ALSO_ITEM> 
    <SEE_ALSO_ITEM> <LINK>getcwd</LINK> </SEE_ALSO_ITEM>
  </SEE_ALSO>
</MAN>