7dda5d8dc40b8774339588932e047300b1a3935d
[scilab.git] / scilab / modules / core / help / en_US / 1_keywords / left.xml
1 <?xml version="1.0" encoding="UTF-8"?>
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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="left">
3     <refnamediv>
4         <refname>left</refname>
5         <refpurpose>([) left bracket</refpurpose>
6     </refnamediv>
7     <refsynopsisdiv>
8         <title>Calling Sequence</title>
9         <synopsis>[a11,a12,...;a21,a22,...;...]
10             [s1,s2,...]=func(...)
11         </synopsis>
12     </refsynopsisdiv>
13     <refsection>
14         <title>Arguments</title>
15         <variablelist>
16             <varlistentry>
17                 <term>a11,a12,...  </term>
18                 <listitem>
19                     <para>matrix of any compatibles types with compatibles dimensions s1,s2,... : any possible variable name</para>
20                 </listitem>
21             </varlistentry>
22         </variablelist>
23     </refsection>
24     <refsection>
25         <title>Description</title>
26         <para>
27             Left and right brackets are used for vector and matrix concatenation.
28             These symbols are also used to denote a multiple left-hand-side for a function call
29         </para>
30         <para>
31             Inside concatenation brackets blank or comma characters mean "column concatenation", 
32             semicolon and carriage-return mean "row concatenation".
33         </para>
34         <para>
35             Note : to avoid confusions it is safer to use comma instead of blank to
36             separate columns.
37         </para>
38         <para>
39             Within multiple lhs brackets variable names must be separated by comma.
40         </para>
41     </refsection>
42     <refsection>
43         <title>Examples</title>
44         <programlisting role="example"><![CDATA[ 
45 [6.9,9.64; sqrt(-1) 0]
46 [1 +%i  2 -%i  3]
47 []
48 ['this is';'a string';'vector']
49 s=poly(0,'s');[1/s,2/s]
50 [tf2ss(1/s),tf2ss(2/s)]
51
52 [u,s]=schur(rand(3,3))
53  ]]></programlisting>
54     </refsection>
55     <refsection role="see also">
56         <title>See Also</title>
57         <simplelist type="inline">
58             <member>
59                 <link linkend="comma">comma</link>
60             </member>
61             <member>
62                 <link linkend="semicolon">semicolon</link>
63             </member>
64         </simplelist>
65     </refsection>
66 </refentry>