1
1
<?xml version="1.0" encoding="UTF-8"?>
2
2
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:id="setbpt" xml:lang="en">
4
<refname>setbpt</refname>
5
<refpurpose>set breakpoints</refpurpose>
8
<title>Calling Sequence</title>
9
<synopsis>setbpt(macroname [,linenumb])</synopsis>
12
<title>Arguments</title>
15
<term>macroname</term>
23
<para>a scalar integer or a vector of integers</para>
29
<title>Description</title>
31
<literal>setbpt</literal> interactively inserts a breakpoint in the
32
line number <literal>linenumb</literal> (default value is 1) of the
33
function <literal>macroname</literal>.
36
<literal>linenumb</literal> can be a line or column vector of line
37
numbers, or a single scalar line number.
40
Line numbers in <literal>linenumb</literal> are
41
<emphasis>physical</emphasis> line numbers in function
42
<literal>macroname</literal>. Note that Scilab versions before 5.0 used
43
<emphasis>logical</emphasis> line numbers. The difference between physical
44
and logical line numbers is the number of <emphasis>continued
47
(see <link linkend="dot">dot</link>).
49
<para>When reaching a breakpoint, Scilab evaluates the specified physical
50
line and stops the execution flow. If the function is not compiled (see
51
<link linkend="comp">comp</link>) the line is printed on the screen. Then
52
Scilab goes into a <link linkend="pause">pause</link> mode in which the
53
user can check current values. The <link linkend="pause">pause</link> is
54
exited with <link linkend="resume">resume</link> or <link linkend="abort">abort</link>.
56
<para>Redefining the function does not clear the breakpoints, the user
57
must explicitly delete breakpoints using <link linkend="delbpt">delbpt</link>. The maximum number of functions with
58
breakpoints enabled must be less than 100 and the overall maximum number
59
of breakpoints is set to 1000.
63
<title>Examples</title>
64
<programlisting role="example"><![CDATA[
4
<refname>setbpt</refname>
5
<refpurpose>set breakpoints</refpurpose>
8
<title>Calling Sequence</title>
9
<synopsis>setbpt(macroname [,linenumb])</synopsis>
12
<title>Arguments</title>
15
<term>macroname</term>
23
<para>a scalar integer or a vector of integers</para>
29
<title>Description</title>
31
<literal>setbpt</literal> interactively inserts a breakpoint in the
32
line number <literal>linenumb</literal> (default value is 1) of the
33
function <literal>macroname</literal>.
36
<literal>linenumb</literal> can be a line or column vector of line
37
numbers, or a single scalar line number.
40
Line numbers in <literal>linenumb</literal> are
41
<emphasis>physical</emphasis> line numbers in function
42
<literal>macroname</literal>. Note that Scilab versions before 5.0 used
43
<emphasis>logical</emphasis> line numbers. The difference between physical
44
and logical line numbers is the number of <emphasis>continued
47
(see <link linkend="dot">dot</link>).
49
<para>When reaching a breakpoint, Scilab evaluates the specified physical
50
line and stops the execution flow. If the function is not compiled (see
51
<link linkend="comp">comp</link>) the line is printed on the screen. Then
52
Scilab goes into a <link linkend="pause">pause</link> mode in which the
53
user can check current values. The <link linkend="pause">pause</link> is
54
exited with <link linkend="resume">resume</link> or <link linkend="abort">abort</link>.
56
<para>Redefining the function does not clear the breakpoints, the user
57
must explicitly delete breakpoints using <link linkend="delbpt">delbpt</link>. The maximum number of functions with
58
breakpoints enabled must be less than 100 and the overall maximum number
59
of breakpoints is set to 1000.
63
<title>Examples</title>
64
<programlisting role="example"><![CDATA[
65
65
setbpt('foo'),setbpt('foo',10),dispbpt()
68
68
setbpt('foo',[1,2,5,6]),dispbpt()
69
69
]]></programlisting>
71
<refsection role="see also">
72
<title>See Also</title>
73
<simplelist type="inline">
75
<link linkend="delbpt">delbpt</link>
78
<link linkend="dispbpt">dispbpt</link>
81
<link linkend="pause">pause</link>
84
<link linkend="resume">resume</link>
87
<link linkend="abort">abort</link>
90
<link linkend="quit">quit</link>
71
<refsection role="see also">
72
<title>See Also</title>
73
<simplelist type="inline">
75
<link linkend="delbpt">delbpt</link>
78
<link linkend="dispbpt">dispbpt</link>
81
<link linkend="pause">pause</link>
84
<link linkend="resume">resume</link>
87
<link linkend="abort">abort</link>
90
<link linkend="quit">quit</link>