13
13
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:lang="en" xml:id="input">
15
<refname>input</refname>
16
<refpurpose> prompt for user input</refpurpose>
19
<title>Calling Sequence</title>
20
<synopsis>x = input(message [, "string"])</synopsis>
23
<title>Arguments</title>
28
<para>character string</para>
32
<term>"string" </term>
35
the character string <literal>"string"</literal> (may be
36
abbreviated to <literal>"s"</literal>)
43
<para>real number (or character string if
44
<literal>"string"</literal> is in the calling sequence)
51
<title>Description</title>
53
<literal>input(message)</literal> gives the user the prompt in the text string and
54
then waits for input from the keyboard.
55
The input can be expression which is evaluated by <link linkend="evstr">evstr</link>.
56
If nothing but a carriage return is
57
entered at the prompt <literal>input(message)</literal> returns an empty matrix
60
Invoked with two arguments, the output is a character string which is the
61
expression entered at keyboard. If nothing but a carriage return is
62
entered at the prompt <literal>input(message)</literal> returns a single white
63
space <literal>" "</literal>.
67
<title>Examples</title>
68
<programlisting role="example"><![CDATA[
15
<refname>input</refname>
16
<refpurpose> prompt for user input</refpurpose>
19
<title>Calling Sequence</title>
20
<synopsis>x = input(message [, "string"])</synopsis>
23
<title>Arguments</title>
28
<para>character string</para>
32
<term>"string" </term>
35
the character string <literal>"string"</literal> (may be
36
abbreviated to <literal>"s"</literal>)
43
<para>real number (or character string if
44
<literal>"string"</literal> is in the calling sequence)
51
<title>Description</title>
53
<literal>input(message)</literal> gives the user the prompt in the text string and
54
then waits for input from the keyboard.
55
The input can be expression which is evaluated by <link linkend="evstr">evstr</link>.
56
If nothing but a carriage return is
57
entered at the prompt <literal>input(message)</literal> returns an empty matrix
60
Invoked with two arguments, the output is a character string which is the
61
expression entered at keyboard. If nothing but a carriage return is
62
entered at the prompt <literal>input(message)</literal> returns a single white
63
space <literal>" "</literal>.
67
<title>Examples</title>
68
<programlisting role="example"><![CDATA[
69
69
//x=input("How many iterations?")
70
70
//x=input("What is your name?","string")
71
71
]]></programlisting>
73
<refsection role="see also">
74
<title>See Also</title>
75
<simplelist type="inline">
77
<link linkend="evstr">evstr</link>
80
<link linkend="x_dialog">x_dialog</link>
83
<link linkend="x_mdialog">x_mdialog</link>
73
<refsection role="see also">
74
<title>See Also</title>
75
<simplelist type="inline">
77
<link linkend="evstr">evstr</link>
80
<link linkend="x_dialog">x_dialog</link>
83
<link linkend="x_mdialog">x_mdialog</link>