Update dot help pages
[scilab.git] / scilab / modules / core / help / ru_RU / 1_keywords / dot.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:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="dot" xml:lang="ru">
3     <refnamediv>
4         <refname>точка</refname>
5         <refpurpose>(.) символ точка</refpurpose>
6     </refnamediv>
7     <refsynopsisdiv>
8         <title>Последовательность вызова</title>
9         <synopsis>
10             123.33
11
12             a.*b
13             a .*. b
14
15             %pi * (%e + ..
16             %i)
17
18             cd ..
19             dir ..
20         </synopsis>
21     </refsynopsisdiv>
22     <refsection>
23         <title>Описание</title>
24         <variablelist>
25             <varlistentry>
26                 <term>.</term>
27                 <listitem>
28                     <para>
29                         Точка используется для обозначения десятичной запятой для чисел: 3.25 и
30                         0.001
31                     </para>
32                 </listitem>
33             </varlistentry>
34             <varlistentry>
35                 <term>.&lt;оператор&gt;</term>
36                 <listitem>
37                     <para>
38                         используется в сочетании с другими символами операторов (<literal>*/ \ ^ '</literal>) 
39                         для формирования других операторов. Операторы поэлементного умножения, деления и 
40                         возведения в степень и транспонирования получаются с помощью
41                         <literal> .*, ./, .\, .^ </literal>; транспонирование без комплексного сопряжения 
42                         получается с помощью <literal>.'</literal> . Например,  <literal>C = A ./ B</literal> 
43                         является матрицей с элементами <literal>c(i,j) = a(i,j)/b(i,j)</literal>. Произведение 
44                         Кронекера обозначается <literal>.*.</literal> . Заметьте, что когда точка стоит
45                         сразу после числа, то она всегда является частью числа, так что <literal>2.*x</literal> 
46                         вычисляется как <literal>2.0*x</literal>, а <literal>2 .*x</literal> вычисляется как 
47                         <literal>(2).*x</literal>. 
48                     </para>
49                 </listitem>
50             </varlistentry>
51             <varlistentry>
52                 <term>..</term>
53                 <listitem>
54                     <para>
55                         Обозначение продолжения. Две или более точек в конце строки
56                         (или с последующим комментарием) приводит к тому, что следующая
57                         строка будет продолжением.
58                     </para>
59                     <para>
60                         Строки продолжения обрабатываются предпроцессором, который строит длинную логическую
61                         линию из последовательности строк продолжения. Так что обозначения продолжения
62                         могут использоваться для разрезания строки во многих местах.
63                     </para>
64                     <para>
65                         Следующая функция <literal>foo</literal>:
66                     </para>
67                     <programlisting role=""><![CDATA[ 
68 function foo()
69     plot2d()
70     xtitle(["Общий заголовок"; "Он может быть многострочным и достаточно длинным"], ..
71             "Это название оси X", "Название оси Y")
72 endfunction
73  ]]></programlisting>
74                     <para>эквивалентна:</para>
75                     <programlisting role=""><![CDATA[ 
76 function foo()
77     plot2d()
78
79     xtitle(["Общий заголовок"; "Он может быть многострочным и достаточно длинным"],  "Это название оси X", "Название оси Y")
80 endfunction
81  ]]></programlisting>
82                     <para>
83                         Логическая строка, сформированная физической строкой №3 и физической строкой №4, 
84                         построена так, как если бы она была полностью написана на физической строке №4, а 
85                         физическая строка №3 была бы пустой. Так сделано для того, чтобы обозначения 
86                         конкатенации можно было помещать куда угодно внутри выражения.
87                         <note>
88                             Разница между логическими и физическими строками важна, когда идёт редактирование (scinotes, edit) профилирование (<function>profile</function>, <function>showprofile</function>, <function>plotprofile</function>) и в сообщениях об ошибках (<function>whereami</function>), когда номер строки указывается или отображается.
89                         </note>
90                     </para>
91                 </listitem>
92             </varlistentry>
93             <varlistentry>
94                 <term>параметр ".."</term>
95                 <listitem>
96                     <para>
97                         Когда функции используются способом, ориентированным на рабочее окно, <literal>..</literal> рассматривается не как знак продолжения, а как обычный аргумент. Наиболее общее использование - это <literal>cd ..</literal>, <literal>dir ..</literal>
98                         или <literal>ls ..</literal> вместо <literal>cd("..")</literal> и т. д.
99                     </para>
100                 </listitem>
101                 </varlistentry>
102             </variablelist>
103     </refsection>
104     <refsection>
105         <title>Примеры</title>
106         <programlisting role="example"><![CDATA[ 
107 //десятичная запятая
108 1.345
109  
110 //используется как часть оператора
111 x=[1 2 3];x.^2 .*x // требуется пробел между 2 и точкой
112  
113 // При записи строк матрицы на разных строчках ".." можно использовать, но не обязательно
114 N = [   ..
115     63.    89.    3.   ..
116     91.    56.    22.  ..
117     15.    64.    40.  ..
118     ]
119 // Можно просто вставлять (или копировать/вставлять из/в рабоче окно или сценарий),
120 // без добавления ".." вручную в конце строки
121 N = [
122     63.    89.    3.
123     91.    56.    22.
124     15.    64.    40.
125     ]
126
127 // Внутри очень длинных инструкций, таких как создание объекта пользовательского интерфейса, где необходимо
128 // установить много свойств,знаки продолжения являются почти обязательными и позволяют писать и устанавливать
129 // одно свойство на строчку в удобочитаемом виде. Одиночная огромная строчка может не соответствовать
130 // стилю написания кода в Scilab:
131 fig = figure("figure_name", "FIGURE", ..
132              "dockable",    "off", ..
133              "axes_size",   [990,670], ..
134              "infobar_visible", "off", ..
135              "toolbar",     "none", ..
136              "menubar_visible", "on", ..
137              "menubar",     "none", ..
138              "default_axes","off", ..
139              "layout",      "border", ..
140              "background",  color(244,244,244), ..
141              "tag",         "figure_1", ..
142              "visible",     "on");
143
144 // Вызовы, ориентированные на рабочее окно с аргументом ".."
145 d = pwd(); cd SCI/contrib
146 cd ..   // заменяет cd("..") и ничего не ожидает на следующей строчке
147 cd(d)   // переход назад в вашу рабочую директорию
148
149 // Это выражение больше не будет работать в Scilab 6
150 a = "здесь я начинаю очень длинную строку...  //но не в настроении продолжать
151      - а здесь продолжаю"
152 // Теперь эта строка является корректным выражением
153 a = "здесь я начинаю очень длинную строку"+...  //но не в настроении продолжать
154 "    - а здесь продолжаю"
155 // Это выражение в Scilab 6 более не разрешено: скалярное число должно быть написано в одной строчке
156 y = 12..
157 45
158  ]]></programlisting>
159     </refsection>
160     <refsection role="see also">
161         <title>Смотрите также</title>
162         <simplelist type="inline">
163             <member>
164                 <link linkend="star">звёздочка</link>
165             </member>
166             <member>
167                 <link linkend="hat">крышечка</link>
168             </member>
169             <member>
170                 <link linkend="slash">слэш</link>
171             </member>
172             <member>
173                 <link linkend="backslash">обратный слэш</link>
174             </member>
175             <member>
176                 <link linkend="whereami">whereami</link>
177             </member>
178             <member>
179                 <link linkend="showprofile">showprofile</link>
180             </member>
181             <member>
182                 <link linkend="edit">edit</link>
183             </member>
184         </simplelist>
185     </refsection>
186     <refsection>
187         <title>История</title>
188         <revhistory>
189             <revision>
190                 <revnumber>6.0.0</revnumber>
191                 <revremark>
192                     <para>
193                         Больше нельзя разрезать скалярные числа.
194                     </para>
195                     <para>
196                         Чтобы разрезать одиночную строку, необходимо использовать операторы "+..".
197                     </para>
198                     <para>
199                         В вызовах, ориентированных на рабочее окно, <literal>myfun ..</literal> больше не ожидает продолжения на следующей строчке.
200                     </para>
201                 </revremark>
202             </revision>
203         </revhistory>
204     </refsection>
205 </refentry>