[doc] misc. fix & improvements
[scilab.git] / scilab / modules / core / help / ru_RU / error_handling / error_table.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C)             - INRIA
5  * Copyright (C) 2012 - 2016 - Scilab Enterprises
6  * Copyright (C) 2018 - Samuel GOUGEON
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
18           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
19           xmlns:scilab="http://www.scilab.org" xml:id="error_table" xml:lang="ru">
20     <refnamediv>
21         <refname>Таблица ошибок</refname>
22         <refpurpose>список сообщений главных стандартных ошибок</refpurpose>
23     </refnamediv>
24     <refsection>
25         <title>Содержание</title>
26         <para>
27             <itemizedlist>
28                 <listitem>
29                     Сообщения
30                     <itemizedlist>
31                         <listitem>
32                             <link linkend="error_table_arg_number">Проверка количества аргументов</link>
33                         </listitem>
34                         <listitem>
35                             <link linkend="error_table_type_checking">
36                                 Проверка типов и кодировки контейнера и содержимого
37                             </link>
38                         </listitem>
39                         <listitem>
40                             <link linkend="error_table_sizes_checking">
41                                 Проверка размеров
42                             </link>
43                         </listitem>
44                         <listitem>
45                             <link linkend="error_table_values_checking">Проверка значений</link>
46                         </listitem>
47                         <listitem>
48                             <link linkend="error_table_interarguments_constrains">
49                                 Связи между аргументами
50                             </link>
51                         </listitem>
52                         <listitem>
53                             <link linkend="error_table_files_directories">Файлы, папки</link>
54                         </listitem>
55                         <listitem>
56                             <link linkend="error_table_dynamical_systems">Динамические системы</link>
57                         </listitem>
58                         <listitem>
59                             <link linkend="error_table_miscellaneous">Разное</link>
60                         </listitem>
61                     </itemizedlist>
62                 </listitem>
63                 <listitem>
64                     <link linkend="error_table_examples">Примеры</link>
65                 </listitem>
66                 <listitem>
67                     <link linkend="error_table_seealso">См. также</link>
68                 </listitem>
69             </itemizedlist>
70         </para>
71     </refsection>
72     <refsection>
73         <title>Описание</title>
74         <para>
75             Эта страница даёт неполный список главных стандартных предопределённых сообщений об ошибках,
76             исползуемых в самом Scilab. Эти сообщения так же могут быть использованы во внешнем коде.
77         </para>
78         <para>
79             Какой бы ни был язык текущей сессии Scilab, используется английская версия сообщений в
80             качестве идентификатора сообщения с помощью системы перевода <link linkend="gettext">gettext</link>().
81             В самом Scilab используются перечисленные сообщения.
82             <note>
83                 Пожалуйста, избегайте использования двойных кавычек " внутри сообщения: вместо них должны
84                 использоваться одинарные кавычки '.
85             </note>
86         </para>
87         <para>
88             Сообщение может включать в себя некоторые метки, начинающиеся с символа "%". Эти метки соответствуют
89             Си-подобному синтаксису (см. <link linkend="printf_conversion">правила преобразования printf()</link>).
90             Они предназначены для замены настраиваемым содержимым для того, чтобы настроить стандарт под
91             локальные данные благодаря  <link linkend="msprintf">msprintf</link>. Чтобы включить в такое
92             сообщение собственном символ "%" используйте "%%".
93         </para>
94         <para>
95             Стандартные сообщения должны начинаться с "%s" и заканчиваться "\n". Стоящее впереди "%s"
96             будет заменено именем функции, в которой произошла ошибка.
97         </para>
98         <refsect2 id="error_table_arg_number">
99             <title>Проверка количества аргументов</title>
100             <para>
101                 <emphasis role="bold">Входные аргументы:</emphasis>
102             </para>
103             <screen><![CDATA[
104 "%s: Wrong number of input arguments.\n"
105 "%s: Wrong number of input arguments: %d expected.\n"
106 "%s: Wrong number of input arguments: %d or %d expected.\n"
107 "%s: Wrong number of input arguments: %d to %d expected.\n"
108 "%s: Wrong number of input arguments: At least %d expected.\n"
109 "%s: Wrong number of input arguments: At most %d expected.\n"
110 ]]></screen>
111             <para>
112                 <emphasis role="bold">Выходные аргументы:</emphasis>
113             </para>
114             <screen><![CDATA[
115 "%s: Wrong number of output arguments: %d expected.\n"
116 "%s: Wrong number of output arguments: %d to %d expected.\n"
117 ]]></screen>
118         </refsect2>
119         <!-- ====================================================== -->
120         <refsect2 id="error_table_type_checking">
121             <title>Проверка типов контейнера и содержимого</title>
122             <para>
123                 <emphasis role="bold">Неверный тип содержимого:</emphasis>
124             </para>
125             <screen><![CDATA[
126 "%s: Argument #%d: Boolean(s) expected.\n"
127
128 "%s: Argument #%d: Encoded integer expected.\n"
129 "%s: Argument #%d: Encoded integer of type (%s) expected.\n"
130 "%s: Argument #%d: Integer expected.\n"         // целочисленное или десятичное кодирование
131 "%s: Argument #%d: Decimal integer expected.\n"
132 "%s: Argument #%d: Decimal number expected.\n"
133 "%s: Argument #%d: Decimal or complex number expected.\n"
134 "%s: Argument #%d: Complex number expected.\n"
135 "%s: Argument #%d: Complex number not supported.\n"
136
137 "%s: Argument #%d: Polynomial expected.\n"
138 "%s: Argument #%d: Rational fraction expected.\n"
139 "%s: Argument #%d: Polynomial or rational expected.\n"
140 "%s: Argument #%d: Real polynomial expected.\n"
141 "%s: Argument #%d: Real rational expected.\n"
142
143 "%s: Argument #%d: Text(s) expected.\n"
144
145 "%s: Argument #%d: Graphic handle expected.\n"
146 "%s: Argument #%d: Graphic handle of type ''%s'' expected.\n"
147
148 "%s: Argument #%d: Function expected.\n"
149 "%s: Argument #%d: Transfer function expected.\n"
150 "%s: Argument #%d: Linear state space expected.\n"
151 "%s: Argument #%d: %s expected.\n"
152
153 "%s: Type %s is not implemented.\n"
154 ]]></screen>
155             <para>
156                 <emphasis role="bold">Неверный контейнер:</emphasis>
157             </para>
158             <screen><![CDATA[
159 "%s: Argument #%d: List expected.\n"
160 "%s: Argument #%d: Cell expected.\n"
161 "%s: Argument #%d: Structure expected.\n"
162 "%s: Argument #%d: M-list expected.\n"
163 "%s: Argument #%d: T-list of type %s expected.\n"
164 "%s: Argument #%d: %s expected.\n"
165 ]]></screen>
166             <para>
167                 <emphasis role="bold">Неверное кодирование:</emphasis>
168             </para>
169             <screen><![CDATA[
170 "%s: Argument #%d: Sparse matrix expected.\n"
171 "%s: Argument #%d: Dense matrix expected.\n"
172 ]]></screen>
173         </refsect2>
174         <!-- ====================================================== -->
175         <refsect2 id="error_table_sizes_checking">
176             <title>Проверка размерности и размеров контейнера</title>
177             <para>
178                 <emphasis role="bold">Размерности / размеры / форма контейнера:</emphasis>
179                 <itemizedlist>
180                     <listitem>
181                         "Массив" применяется к селл-массивам и структурам
182                     </listitem>
183                     <listitem>
184                         "Скаляр", "Строка", "Столбец" применяются к матрицам и некоторым другим
185                         массивам (селл-массивам и структурам)
186                     </listitem>
187                 </itemizedlist>
188             </para>
189             <screen><![CDATA[
190 "%s: Argument #%d: Non-empty matrix expected.\n"
191 "%s: Argument #%d: Empty matrix expected.\n"
192 "%s: Argument #%d: Scalar (1 element) expected.\n"
193 "%s: Argument #%d: Row expected.\n"
194 "%s: Argument #%d: Column expected.\n"
195 "%s: Argument #%d: Vector expected.\n"
196 "%s: Argument #%d: Row with %d elements expected.\n"
197 "%s: Argument #%d: Column with %d elements expected.\n"
198 "%s: Argument #%d: Vector with %d elements expected.\n"
199
200 "%s: Argument #%d: Matrix expected.\n"
201 "%s: Argument #%d: Square matrix expected.\n"
202 "%s: Argument #%d: %d-by-%d matrix expected.\n"
203 "%s: Argument #%d: Matrix with %d rows expected.\n"
204 "%s: Argument #%d: Matrix with %d columns expected.\n"
205 "%s: Argument #%d: Matrix with %s rows expected.\n"    // %s является наиболее общей; она может использоваться для диапазона
206 "%s: Argument #%d: Matrix with %s columns expected.\n" // то же самое
207 "%s: Argument #%d: 2D-array expected.\n"
208
209 "%s: Argument #%d: Hypermatrix expected.\n"
210 "%s: Argument #%d: %dD hypermatrix expected.\n"
211 "%s: Argument #%d: %dD array expected.\n"
212
213 "%s: Argument #%d: %d-element list expected.\n"
214 "%s: Argument #%d: List of %d to %d elements expected.\n"
215
216 "%s: Argument #%d: %s expected.\n"
217 "%s: Implicit size not supported.\n"
218 "%s: Hypermatrix not supported.\n"
219 ]]></screen>
220             <para>
221                 <emphasis role="bold">Строковые значения</emphasis>
222             </para>
223             <screen><![CDATA[
224 "%s: Argument #%d: string length %s %d characters expected.\n" // '='|'>'|'>='|'<' ...etc
225 ]]></screen>
226         </refsect2>
227         <!-- ====================================================== -->
228         <refsect2 id="error_table_values_checking">
229             <title>Проверка значений</title>
230             <para>
231                 <emphasis role="bold">Неверные значения:</emphasis>
232             </para>
233             <screen><![CDATA[
234 "%s: Argument #%d: Must be in the interval [%s, %s].\n"
235 "%s: Argument #%d: Must be in the interval [%d, %d].\n"
236 "%s: Argument #%d: Must be in the interval %s.\n"
237 "%s: Argument #%d: Must be < %d.\n"
238 "%s: Argument #%d: Must be > %d.\n"
239 "%s: Argument #%d: Must be <= %d.\n"
240 "%s: Argument #%d: Must be >= %d.\n"
241 "%s: Argument #%d: Inf value forbidden.\n"
242 "%s: Argument #%d: Nan value forbidden.\n"
243 "%s: Argument #%d: Inf and Nan values forbidden.\n"
244 "%s: Argument #%d: ''%s'' expected .\n"
245 "%s: Argument #%d: Must be in the set {%s}.\n"
246 "%s: Argument #%d: Non-negative integers expected.\n"
247 "%s: Argument #%d: Elements must be in increasing order.\n"
248 "%s: Argument #%d: Elements must be in decreasing order.\n"
249 "%s: Argument #%d: Elements must be in strictly increasing order.\n"
250 "%s: Argument #%d: Elements must be in strictly decreasing order.\n"
251 "%s: Argument #%d: An integer value expected.\n"
252
253 "%s: Argument #%d: Unknown or unexpected property name ''%s''.\n"
254 "%s: Argument #%d: Wrong type of graphic handle: ''%s'' expected.\n"
255 "%s: Argument #%d: The %s handle is no longer valid.\n"  // графики, XML, lu и другие указатели
256 "%s: Argument #%d: Wrong color specification.\n"
257 ]]></screen>
258         <para>
259             Обратите внимание, что сообщение об ошибке для интервалов является особым: любой тип интервала
260             наподобие [#, #], (#, #], [#, #), (#, #) (-oo, #], [#, oo) и др. может без труда определён
261             внутри того же унифицированного сообщения. Должны быть выполнены границы форматирования и
262             замещения с помощью msprintf(..)
263         </para>
264         </refsect2>
265         <!-- ====================================================== -->
266         <refsect2 id="error_table_interarguments_constrains">
267             <title>Проверка связи между аргументами:</title>
268             <screen><![CDATA[
269 "%s: Arguments #%d and #%d: Incompatible sizes.\n"
270 "%s: Arguments #%d and #%d: Same sizes expected.\n"
271 "%s: Arguments #%d and #%d: Same numbers of columns expected.\n"
272 "%s: Arguments #%d and #%d: Same numbers of rows expected.\n"
273 "%s: Arguments #%d and #%d: Same numbers of elements expected.\n"
274 "%s: Arguments #%d and #%d: Same types expected.\n"
275 "%s: Arguments #%d and #%d: Same formal variable expected.\n"  // полиномы и рациональные значения
276 ]]></screen>
277         </refsect2>
278         <!-- ====================================================== -->
279         <refsect2 id="error_table_files_directories">
280             <title>Файлы, папки</title>
281             <screen><![CDATA[
282 "%s: Cannot open file ''%s''.\n"
283 "%s: The file ''%s'' does not exist.\n"
284 "%s: File ''%s'': Read access denied.\n"
285 "%s: File ''%s'' already exists or directory write access denied.\n"
286 "%s: Error while copying the file ''%s'' to the directory ''%s''.\n"
287 "%s: The file ''%s'' cannot be written.\n"
288 "%s: The file ''%s'' is not well formated at line %d\n"
289 "%s: Cannot close the file ''%s''.\n"
290 "%s: End of file at line %d.\n"
291 "%s: Binary direct access files must be opened by ''file''.\n"
292 "%s: C file logical unit not allowed here.\n"
293 "%s: Fortran file logical unit not allowed here.\n"
294 "%s: No input file associated to logical unit %d.\n"
295 ]]></screen>
296         </refsect2>
297         <!-- ====================================================== -->
298         <refsect2 id="error_table_dynamical_systems">
299             <title>Динамические системы</title>
300         <screen><![CDATA[
301 "%s: Argument #%d: Transfer matrix expected.\n"
302 "%s: Argument #%d: In state space form expected.\n"
303 "%s: Argument #%d: In continuous time expected.\n"
304 "%s: Argument #%d: In discrete time expected.\n"
305 "%s: Argument #%d: SISO expected.\n"
306 "%s: Argument #%d: Undefined time domain.\n"
307 "%s: Argument #%d: Invalid state space representation.\n"
308 "%s: Argument #%d: A system in state space or transfer matrix form expected.\n"
309 ]]></screen>
310         </refsect2>
311         <!-- ====================================================== -->
312         <refsect2 id="error_table_miscellaneous">
313             <title>Разное</title>
314             <screen><![CDATA[
315 "%s: No more memory.\n"
316 "%s: No more memory: %d requested, %d available.\n"
317 "%s: Non implemented feature.\n"
318 "%s: Inconsistent addition.\n"
319 "%s: Inconsistent multiplication.\n"
320 "%s: The problem is singular.\n"
321 "%s: Division by 0...\n"
322 "%s: Invalid index.\n"
323 "%s: ''%s'' expected instead of ''%s''.\n"
324 "%s: Recursion limit reached.\n"
325 "%s: Recursion problems. Sorry...\n"
326 "%s: Convergence problem...\n"
327
328 "%s: Incorrect syntax.\n"
329 "%s: Incorrect assignment.\n"
330 "%s: Subroutine ''%s'' not found.\n"
331 "%s: Bad call to primitive ''%s''.\n"
332 "%s: Dot cannot be used as modifier for this operator.\n"
333 "%s: Problem with comparison symbol...\n"
334 "%s: Missing operator, comma, or semicolon.\n"
335 ]]></screen>
336         </refsect2>
337     </refsection>
338     <refsection id="error_table_examples">
339         <title>Примеры</title>
340         <programlisting role="example"><![CDATA[
341 lang0 = getlanguage();
342 setlanguage fr;
343
344 msg = _("%s: Wrong number of input arguments: %d or %d expected.\n")
345 error(msprintf(msg, "myfun", 2, 3))
346
347 msg = _("%s: Argument #%d: Must be in the set {%s}.\n")
348 error(msprintf(msg, "myfun", 2, "''r'' ''c''"))
349
350 msg = _("%s: Non implemented feature.\n")
351 error(msprintf(msg, "myfun"))
352
353 setlanguage(lang0);
354
355 msg = _("%s: Argument #%d: Encoded integer of type (%s) expected.\n")
356 error(msprintf(msg, "myfun", 1, "uint16"))
357
358 msg = _("%s: Argument #%d: The %s handle is no longer valid.\n")
359 error(msprintf(msg, "myfun", 3, _("graphic")))
360  ]]></programlisting>
361     <screen><![CDATA[
362 --> msg = _("%s: Wrong number of input arguments: %d or %d expected.\n")
363  msg  =
364  %s : Nombre erroné d'arguments d'entrée : %d ou %d attendus.\n
365
366 --> error(msprintf(msg, "myfun", 2, 3))
367 myfun : Nombre erroné d'arguments d'entrée : 2 ou 3 attendus.
368
369
370 --> msg = _("%s: Argument #%d: Must be in the set {%s}.\n")
371  msg  =
372  %s : Argument #%d : doit être dans l'ensemble {%s}.\n
373
374 --> error(msprintf(msg, "myfun", 2, """r"" ""c"""))
375 myfun : Argument #2 : doit être dans l'ensemble {"r" "c"}.
376
377
378 --> msg = _("%s: Non implemented feature.\n")
379  msg  =
380  %s : Fonction non implémentée\n
381
382 --> error(msprintf(msg, "myfun"))
383 myfun : Fonction non implémentée
384
385 --> setlanguage(lang0);
386
387 --> msg = _("%s: Argument #%d: Encoded integer of type (%s) expected.\n");
388 --> error(msprintf(msg, "myfun", 1, "uint16"))
389
390 myfun: Argument #1: Encoded integer of type (uint16) expected.
391
392 --> msg = _("%s: Argument #%d: The %s handle is no longer valid.\n");
393 --> error(msprintf(msg, "myfun", 3, _("graphic")))
394
395 myfun: Argument #3: The graphic handle is no longer valid.
396 ]]></screen>
397     </refsection>
398     <refsection role="see also" id="error_table_seealso">
399         <title>See also</title>
400         <simplelist type="inline">
401             <member>
402                 <link linkend="error">error</link>
403             </member>
404             <member>
405                 <link linkend="gettext">gettext</link>
406             </member>
407             <member>
408                 <link linkend="msprintf">msprintf</link>
409             </member>
410             <member>
411                 <link linkend="printf_conversion">printf_conversion</link>
412             </member>
413             <member>
414                 <link linkend="warning">warning</link>
415             </member>
416             <member>
417                 <link linkend="lasterror">lasterror</link>
418             </member>
419         </simplelist>
420     </refsection>
421     <refsection>
422         <title>История</title>
423         <revhistory>
424             <revision>
425                 <revnumber>6.0.0</revnumber>
426                 <revremark>
427                     Нельзя больше использовать номера ошибок. Теперь есть необязателные (по умолчанию
428                     = 10000) и локальные (устанавилвается при каждом вызове error()).
429                 </revremark>
430             </revision>
431         </revhistory>
432     </refsection>
433 </refentry>