diff options
| author | Shashank | 2017-05-29 12:40:26 +0530 |
|---|---|---|
| committer | Shashank | 2017-05-29 12:40:26 +0530 |
| commit | 0345245e860375a32c9a437c4a9d9cae807134e9 (patch) | |
| tree | ad51ecbfa7bcd3cc5f09834f1bb8c08feaa526a4 /modules/output_stream/help | |
| download | scilab_for_xcos_on_cloud-0345245e860375a32c9a437c4a9d9cae807134e9.tar.gz scilab_for_xcos_on_cloud-0345245e860375a32c9a437c4a9d9cae807134e9.tar.bz2 scilab_for_xcos_on_cloud-0345245e860375a32c9a437c4a9d9cae807134e9.zip | |
CMSCOPE changed
Diffstat (limited to 'modules/output_stream/help')
20 files changed, 2082 insertions, 0 deletions
diff --git a/modules/output_stream/help/en_US/addchapter.sce b/modules/output_stream/help/en_US/addchapter.sce new file mode 100755 index 000000000..a1a12c00c --- /dev/null +++ b/modules/output_stream/help/en_US/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Output functions",SCI+"/modules/output_stream/help/en_US",%T); + diff --git a/modules/output_stream/help/en_US/disp.xml b/modules/output_stream/help/en_US/disp.xml new file mode 100755 index 000000000..5c37e5da0 --- /dev/null +++ b/modules/output_stream/help/en_US/disp.xml @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) XXXX-2008 - INRIA + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="disp"> + <refnamediv> + <refname>disp</refname> + <refpurpose>displays variables</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>disp(x1,[x2,...xn])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para> + displays <literal>xi</literal> with the current format. <literal>xi</literal>'s are arbitrary + objects (matrices of constants, strings, functions, lists, ...) + </para> + <para> + Display of objects defined by <literal>tlist</literal> may be overloaded by the + definition of a function. This function must have no output argument a + single input argument ant it's name is formed as follow + <literal>%<tlist_type>_p</literal> where <literal>%<tlist_type></literal> stands for the first + entry of the tlist type component. + </para> + <para> + The <link linkend="lines">lines</link> function may be used to control the output. + </para> + <para> + <literal>disp("a",1,"c")</literal> display order: last input argument will be the first displayed (LIFO). + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +disp([1 2],3) +disp("a",1,"c") +deff('[]=%t_p(l)','disp(l(3),l(2))') +disp(tlist('t',1,2)) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="lines">lines</link> + </member> + <member> + <link linkend="write">write</link> + </member> + <member> + <link linkend="read">read</link> + </member> + <member> + <link linkend="print">print</link> + </member> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="tlist">tlist</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/en_US/mprintf.xml b/modules/output_stream/help/en_US/mprintf.xml new file mode 100755 index 000000000..3ae1b6846 --- /dev/null +++ b/modules/output_stream/help/en_US/mprintf.xml @@ -0,0 +1,81 @@ +<?xml version="1.0" encoding="windows-1251"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 2008 - INRIA + * ... + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="mprintf" xml:lang="en"> + <refnamediv> + <refname>mprintf</refname> + <refpurpose>converts, formats, and writes data to the main scilab + window + </refpurpose> + </refnamediv> + <refnamediv xml:id="printf"> + <refname>printf</refname> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>mprintf(format,a1,...,an);</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>format</term> + <listitem> + <para>a Scilab string describing the format to use to write the + remaining operands. The format operand follows, as close as + possible, the C printf format operand syntax. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>a1,...,an</term> + <listitem> + <para>Specifies the data to be converted and printed according to + the format parameter. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + The <literal>mprintf</literal> function is a interface for C-coded version of + <literal>printf</literal> function. + </para> + <para> + The <literal>mprintf</literal> function writes formatted operands to + the standard Scilab output (i.e the Scilab window). The argument operands + are formatted under control of the format operand. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +mprintf('At iteration %i, Result is:\nalpha=%f',33,0.535) +mprintf('%e ', [1; 2; 3]) +mprintf('%d %d\n', [1, 2; 3, 4]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="disp">disp</link> + </member> + <member> + <link linkend="printf_conversion">printf_conversion</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/en_US/msprintf.xml b/modules/output_stream/help/en_US/msprintf.xml new file mode 100755 index 000000000..9cd8a53cd --- /dev/null +++ b/modules/output_stream/help/en_US/msprintf.xml @@ -0,0 +1,88 @@ +<?xml version="1.0" encoding="windows-1251"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 2008 - INRIA + * ... + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="msprintf" xml:lang="en"> + <refnamediv> + <refname>msprintf</refname> + <refpurpose>converts, formats, and writes data in a string</refpurpose> + </refnamediv> + <refnamediv xml:id="sprintf"> + <refname>sprintf</refname> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>str=msprintf(format,a1,...,an);</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>format</term> + <listitem> + <para>a Scilab string describing the format to use to write the + remaining operands. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>str</term> + <listitem> + <para>a character string.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>a1,...,an</term> + <listitem> + <para>Specifies the data to be converted and printed according to + the format parameter. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + The <literal>msprintf</literal> writes formatted operands in its + returned value (a Scilab string). The argument operands are formatted + under control of the format operand. + </para> + <para> + <note> + Note that, in this case, the escape sequences (<literal>"\n"</literal>) (in format) + split string to a matrix of string (see example). + </note> + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +msprintf('%5.3f %5.3f',123,0.732) +msprintf('%5.3f\n%5.3f',123,0.732) +msprintf('--%s-\n-%d--',"hello",3) +msprintf('%e ', [1;2;3]) +msprintf('%d %d\n', [1, 2; 3, 4]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="mprintf">mprintf</link> + </member> + <member> + <link linkend="printf_conversion">printf_conversion</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/en_US/prettyprint.xml b/modules/output_stream/help/en_US/prettyprint.xml new file mode 100755 index 000000000..48f080b60 --- /dev/null +++ b/modules/output_stream/help/en_US/prettyprint.xml @@ -0,0 +1,158 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * + * This help file was generated from prettyprint.sci using help_from_sci(). + * + --> +<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="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="prettyprint" xml:lang="en"> + <refnamediv> + <refname>prettyprint</refname> + <refpurpose>From any Scilab datatype and provide a representation to the TeX, LaTeX or MathML formats</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis> + str = prettyprint(a) // Show the variable a with the default format (LaTeX) + str = prettyprint(a, exportFormat) // Show the variable a with the specified format + str = prettyprint(a, exportFormat, delim) // As above but change the delimiter + str = prettyprint(a, exportFormat, delim, processByElement) // As above but process each element independently + str = prettyprint(a,exportFormat, delim, processByElement, isWrapped) // As above Add the special keyword of Tex or LaTeX export + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>a</term> + <listitem> + <para> is a Scilab variable</para> + </listitem> + </varlistentry> + <varlistentry> + <term>exportFormat</term> + <listitem> + <para> is the format, if omitted 'latex' is used by default, + it can be 'latex', 'tex' or 'mathml'. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>delimiter</term> + <listitem> + <para> is a string indicating the delimiter to use for the + resulting matrix, it's only used if isWrapped is true. The + delimiter can be '(', '{', '[', '|', '||' or ')' + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>processByElement</term> + <listitem> + <para> is a boolean to indicate if the resulting matrix must + be converted into a single string. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>isWrapped</term> + <listitem> + <para> is a boolean to indicate if the result must be wrapped + inside delimiters ('$' for latex and tex or nothing for + mathml) to be used with xstring or xtitle + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>str</term> + <listitem> + <para> the representation of the variable a</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + Taking a variable, the prettyprint function will provide a formated representation of it. + Formats can be TeX, LaTeX or MathML. + They can be used in third party applications but also within Scilab with the most of the + <link linkend="math_rendering_features_in_graphic">Scilab graphic features</link>. + The following types are handled by this function: + </para> + <itemizedlist> + <listitem> + <para>Real / Complex matrices</para> + </listitem> + <listitem> + <para>Polynomial types</para> + </listitem> + <listitem> + <para>Boolean</para> + </listitem> + <listitem> + <para>Integer</para> + </listitem> + <listitem> + <para>String</para> + </listitem> + <listitem> + <para>Tlist</para> + </listitem> + <listitem> + <para>Rationnal</para> + </listitem> + <listitem> + <para>Cell</para> + </listitem> + </itemizedlist> + <para/> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +str = prettyprint(rand(3,3)) // Return the LaTeX representation of a 3,3 matrix +xstring(0.2,0.2,str) // Show the representation in a graphic Windows + +prettyprint(rand(3,4),"mathml") // Return the MathML representation of a 3,4 matrix +prettyprint(rand(3,4),"mathml","[") // Return the MathML representation of a 3,4 matrix with '[' as delimiter + +s=poly(0,'s'); G=[1,s;1+s^2,3*s^3]; +xstring(0.2,0.2,prettyprint(G*s-1)); // Show a polynomial through a LaTeX representation + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="math_rendering_features_in_graphic">math_rendering_features_in_graphic</link> + </member> + <member> + <link linkend="xtitle">xtitle</link> + </member> + <member> + <link linkend="axes_properties">axes_properties</link> + </member> + <member> + <link linkend="label_properties">label_properties</link> + </member> + <member> + <link linkend="legend_properties">legend_properties</link> + </member> + <member> + <link linkend="sci2exp">sci2exp</link> + </member> + <member> + <link linkend="text_properties">text_properties</link> + </member> + <member> + <link linkend="xstringb">xstringb</link> + </member> + <member> + <link linkend="xstringl">xstringl</link> + </member> + <member> + <link linkend="xstring">xstring</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/en_US/print.xml b/modules/output_stream/help/en_US/print.xml new file mode 100755 index 000000000..491b395c6 --- /dev/null +++ b/modules/output_stream/help/en_US/print.xml @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) XXXX-2008 - INRIA + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="print"> + <refnamediv> + <refname>print</refname> + <refpurpose>prints variables in a file</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>print('file-name',x1,[x2,...xn])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para> + prints <literal>xi</literal> on file <literal>'file-name'</literal> + with the current format, i.e. the format used by scilab to display + the variables. All types of variables may be "<literal>print</literal>"'ed + </para> + <para> + <note> + Note : <literal>xi</literal> must be a named variable, with expressions variable + name part of the display is unpredictable. + </note> + </para> + <para> + <literal>print(%io(2),...)</literal> prints on Scilab's window. this syntax may be + used to display variables within a macro. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +a=rand(3,3);p=poly([1,2,3],'s');l=list(1,'asdf',[1 2 3]); +print(%io(2),a,p,l) +write(%io(2),a) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="write">write</link> + </member> + <member> + <link linkend="read">read</link> + </member> + <member> + <link linkend="format">format</link> + </member> + <member> + <link linkend="mprintf">mprintf</link> + </member> + <member> + <link linkend="disp">disp</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/en_US/printf_conversion.xml b/modules/output_stream/help/en_US/printf_conversion.xml new file mode 100755 index 000000000..9bfa2407c --- /dev/null +++ b/modules/output_stream/help/en_US/printf_conversion.xml @@ -0,0 +1,336 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) XXXX-2008 - INRIA + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="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="printf_conversion" xml:lang="en"> + <refnamediv> + <refname>printf_conversion</refname> + <refpurpose>mprintf, msprintf, mfprintf conversion + specifications + </refpurpose> + </refnamediv> + <refsection> + <title>Description</title> + <para> + Each conversion specification in the <literal>mprintf</literal> , + <literal>msprintf</literal> , <literal>mfprintf</literal> + <literal>format</literal> parameter has the following syntax: + </para> + <itemizedlist> + <listitem> + <para>A % (percent) sign.</para> + </listitem> + <listitem> + <para> + Zero or more <literal>options</literal>, which modify the + meaning of the conversion specification. The following list contains + the <literal>option</literal> characters and their meanings: + </para> + <itemizedlist> + <listitem> + <para>- : Left align, within the field, the result of the + conversion. + </para> + </listitem> + <listitem> + <para>+ : Begin the result of a signed conversion with a sign (+ + or -). + </para> + </listitem> + <listitem> + <para>'space' : Prefix a space character to the result if the + first character of a signed conversion is not a sign. If both the + (space) and + options appear, the (space) option is ignored + </para> + </listitem> + <listitem> + <para># : Convert the value to an alternate form. For + <literal>c</literal>, <literal>d</literal>, <literal>i</literal>, + <literal>s</literal>, and <literal>u</literal> conversions, the + <literal>#</literal> option has no effect. For + <literal>o</literal> conversion, <literal>#</literal> increases + the precision to force the first digit of the result to be a 0 + (zero). For <literal>x</literal> and <literal>X</literal> + conversions, a nonzero result has 0x or 0X prefixed to it. For + <literal>e, E, f, g,</literal> and <literal>G</literal> + conversions, the result always contains a decimal point, even if + no digits follow it. For <literal>g</literal> and + <literal>G</literal> conversions, trailing zeros are not removed + from the result. + </para> + </listitem> + <listitem> + <para>0 : Pad to the field width, using leading zeros (following + any indication of sign or base) for <literal>d</literal>, + <literal>i</literal>, <literal>o</literal>, <literal>u</literal>, + <literal>x</literal>, <literal>X</literal>, <literal>e</literal>, + <literal>E</literal>, <literal>f</literal>, <literal>g</literal>, + and <literal>G</literal> conversions; no space padding is + performed. If the <literal>0</literal> and <literal>\-</literal> + (dash) flags both appear, the <literal>0</literal> flag is + ignored. For <literal>d</literal>, <literal>i</literal>, + <literal>o</literal> <literal>u</literal>, <literal>x</literal>, + and <literal>X</literal> conversions, if a precision is specified, + the <literal>0</literal> flag is also ignored. + </para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para>An optional decimal digit string that specifies the minimum field + width. If the converted value has fewer characters than the field width, + the field is padded on the left to the length specified by the field + width. If the left-adjustment option is specified, the field is padded on + the right. + </para> + </listitem> + <listitem> + <para> + An optional precision. The precision is given by a dot<literal>.</literal> + followed by a decimal digit string. If no precision is given, the + parameter is treated as 0 (zero). The precision specifies: + </para> + <itemizedlist> + <listitem> + <para> + The minimum number of digits to appear for <literal>d</literal>, + <literal>u</literal>, <literal>o</literal>, <literal>x</literal>, or + <literal>X</literal> conversions + </para> + </listitem> + <listitem> + <para>The number of digits to appear after the decimal point for + <literal>e</literal>, <literal>E</literal>, and <literal>f</literal> + conversions + </para> + </listitem> + <listitem> + <para>The maximum number of significant digits for + <literal>g</literal> and <literal>G</literal> conversions + </para> + </listitem> + <listitem> + <para>The maximum number of characters to be printed from a string in + an <literal>s</literal> conversion + </para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para>A character that indicates the type of conversion to be + applied: + </para> + <itemizedlist> + <listitem> + <para>% : Performs no conversion. Displays %.</para> + </listitem> + <listitem> + <para> + d,i: Accepts an integer <literal>value</literal> and + converts it to signed decimal notation. The precision specifies + the minimum number of digits to appear. If the value being + converted can be represented in fewer digits, it is expanded with + leading zeros. The default precision is 1. The result of + converting a zero value with a precision of zero is a null string. + Specifying a field width with a zero as a leading character causes + the field width value to be padded with leading zeros. + </para> + </listitem> + <listitem> + <para> + u : Accepts an integer <literal>value</literal> and converts + it to unsigned decimal notation. The precision specifies the + minimum number of digits to appear. If the value being converted + can be represented in fewer digits, it is expanded with leading + zeros. The default precision is 1. The result of converting a zero + value with a precision of zero is a null string. Specifying a + field width with a zero as the leading character causes the field + width value to be padded with leading zeros. + </para> + </listitem> + <listitem> + <para> + o : Accepts an integer <literal>value</literal> and converts + it to unsigned octal notation. The precision specifies the minimum + number of digits to appear. If the value being converted can be + represented in fewer digits, it is expanded with leading zeros. + The default precision is 1. The result of converting a zero value + with a precision of zero is a null string. Specifying a field + width with a zero as the leading character causes the field width + value to be padded with leading zeros. An octal value for field + width is not implied. + </para> + </listitem> + <listitem> + <para> + x, X : Accepts an integer <literal>value</literal> and + converts it to unsigned hexadecimal notation. The letters + ``abcdef'' are used for the <literal>x</literal> conversion; the + letters ``ABCDEF'' are used for the <literal>X</literal> + conversion. The precision specifies the minimum number of digits + to appear. If the value being converted can be represented in + fewer digits, it is expanded with leading zeros. The default + precision is 1. The result of converting a zero value with a + precision of zero is a null string. Specifying a field width with + a zero as the leading character causes the field width value to be + padded with leading zeros. + </para> + </listitem> + <listitem> + <para> + f : Accepts a float or double <literal>value</literal> and + converts it to decimal notation in the format + %[\-]<literal>ddd.ddd</literal>. The number of digits after the + decimal point is equal to the precision specification. + </para> + <itemizedlist> + <listitem> + <para>If no precision is specified, six digits are + output. + </para> + </listitem> + <listitem> + <para>If the precision is zero, no decimal point appears and + the system outputs a number rounded to the integer nearest to + <literal>value</literal>. + </para> + </listitem> + <listitem> + <para>If a decimal point is output, at least one digit is + output before it. + </para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para>e, E : Accepts a real and converts it to the exponential + form %[\-]<literal>d.ddde</literal>+/\-<literal>dd</literal>. + There is one digit before the decimal point, and the number of + digits after the decimal point is equal to the precision + specification. + </para> + <itemizedlist> + <listitem> + <para>If no precision is specified, six digits are + output. + </para> + </listitem> + <listitem> + <para>If the precision is zero, , no decimal point + appears. + </para> + </listitem> + <listitem> + <para> + The <literal>E</literal> conversion character produces a + number with E instead of e before the exponent. The exponent + always contains at least two digits. If the value is zero, the + exponent is zero. + </para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para>g, G : Accepts a real and converts it in the style of the + <literal>e</literal>, <literal>E</literal>, or + <literal>f</literal> conversion characters, with the precision + specifying the number of significant digits. Trailing zeros are + removed from the result. A decimal point appears only if it is + followed by a digit. The style used depends on the value + converted. Style <literal>e</literal> (<literal>E</literal>, if + <literal>G</literal> is the flag used) results only if the + exponent resulting from the conversion is less than -4, or if it + is greater or equal to the precision. + </para> + </listitem> + <listitem> + <para>c : Accepts and displays an integer value converted to a + character. + </para> + </listitem> + <listitem> + <para> + s : Accepts a string <literal>value</literal> and displays + characters from the string to the end or the number of characters + indicated by the precision is reached. If no precision is + specified, all characters up to the end are displayed. + </para> + </listitem> + </itemizedlist> + </listitem> + </itemizedlist> + <para>A field width or precision can be indicated by an + <literal>*</literal> (asterisk) instead of a digit string. In this case, + an integer <literal>value</literal> parameter supplies the field width or + precision. The <literal>value</literal> parameter converted for output is + not fetched until the conversion letter is reached, so the parameters + specifying field width or precision must appear before the value to be + converted (if any). + </para> + <para>If the result of a conversion is wider than the field width, the + field is expanded to contain the converted result. + </para> + <para>The representation of the plus sign depends on whether the + <literal>+</literal> or (space) formatting option is specified. + </para> + <para>display of exponential form %e is platform dependent with a different number of digits in exponent.</para> + <informaltable border="1"> + <tr> + <td>Platform</td> + <td>Example: msprintf("%e",1.23e4)</td> + </tr> + <tr> + <td>Windows</td> + <td>1.23000e+004</td> + </tr> + <tr> + <td>Linux/Mac OS</td> + <td>1.23000e+04</td> + </tr> + </informaltable> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +mprintf('a string: %s\n', 'Scilab'); +mprintf('an integer: %d\n', 10); +mprintf('an integer: %4d\n', 10); +mprintf('a left justified integer: %-4d\n', 10); +mprintf('an integer converted to float: %#fd\n',10); +mprintf('an integer with a sign: %+4d\n', 10); +mprintf('an integer with a sign: %+4d\n', -10); +mprintf('an integer padded with zeros: %04d\n', 10); +mprintf('an unsigned integer: %u\n', 10); +mprintf('an unsigned integer: %4u\n', -10); +mprintf('an integer converted to hexadecimal: %x\n', 10); +mprintf('a float: %d\n', %pi); +mprintf('a float: %3.2d\n', %pi); +mprintf('a float (exponential form): %3.2e\n', %pi); +mprintf('a float (exponential form): %3.2g\n', %pi); +mprintf('a character: %c\n', 'a'); +mprintf('a character: %c\n', 'aaa'); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="mprintf">mprintf</link> + </member> + <member> + <link linkend="mfprintf">mfprintf</link> + </member> + <member> + <link linkend="msprintf">msprintf</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/fr_FR/addchapter.sce b/modules/output_stream/help/fr_FR/addchapter.sce new file mode 100755 index 000000000..924550581 --- /dev/null +++ b/modules/output_stream/help/fr_FR/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Sorties",SCI+"/modules/output_stream/help/fr_FR",%T); + diff --git a/modules/output_stream/help/ja_JP/addchapter.sce b/modules/output_stream/help/ja_JP/addchapter.sce new file mode 100755 index 000000000..a2fcf81c5 --- /dev/null +++ b/modules/output_stream/help/ja_JP/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Output functions",SCI+"/modules/output_stream/help/ja_JP",%T); + diff --git a/modules/output_stream/help/ja_JP/disp.xml b/modules/output_stream/help/ja_JP/disp.xml new file mode 100755 index 000000000..f94000036 --- /dev/null +++ b/modules/output_stream/help/ja_JP/disp.xml @@ -0,0 +1,78 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) XXXX-2008 - INRIA + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="ja" xml:id="disp"> + <refnamediv> + <refname>disp</refname> + <refpurpose>変数を表示</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>disp(x1,[x2,...xn])</synopsis> + </refsynopsisdiv> + <refsection> + <title>説明</title> + <para> + カレントのフォーマットで<literal>xi</literal>を表示します. + <literal>xi</literal>は任意のオブジェクト(定数の行列,文字列,関数,リスト,...) + です. + </para> + <para> + <literal>tlist</literal>により定義されたオブジェクトの表示は, + ある関数を定義することにより上書きすることができます. + この関数は出力引数がなく,入力引数を一つ有し,その名前は + <literal>%<tlist_type>_p</literal>のようである必要があります. + ただし,<literal>%<tlist_type></literal> はtlist type要素の最初のエントリを + 意味します. + </para> + <para> + 出力を制御するために<link linkend="lines">lines</link> 関数を + 使用することができます. + </para> + <para> + <literal>disp("a",1,"c")</literal> 表示の順序: + 最後の入力引数が最初に表示されます (LIFO). + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +disp([1 2],3) +disp("a",1,"c") +deff('[]=%t_p(l)','disp(l(3),l(2))') +disp(tlist('t',1,2)) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="lines">lines</link> + </member> + <member> + <link linkend="write">write</link> + </member> + <member> + <link linkend="read">read</link> + </member> + <member> + <link linkend="print">print</link> + </member> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="tlist">tlist</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/ja_JP/mprintf.xml b/modules/output_stream/help/ja_JP/mprintf.xml new file mode 100755 index 000000000..42b81a5de --- /dev/null +++ b/modules/output_stream/help/ja_JP/mprintf.xml @@ -0,0 +1,79 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 2008 - INRIA + * ... + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="mprintf" xml:lang="ja"> + <refnamediv> + <refname>mprintf</refname> + <refpurpose> + 変換, 整形し, + Scilab主ウインドウにデータを書き込む + </refpurpose> + </refnamediv> + <refnamediv xml:id="printf"> + <refname>printf</refname> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>mprintf(format,a1,...,an);</synopsis> + </refsynopsisdiv> + <refsection> + <title>パラメータ</title> + <variablelist> + <varlistentry> + <term>format</term> + <listitem> + <para> + 残りのオペランドを書く際のフォーマットを定義するScilab文字列. + formatオペランドは,C言語のprintfのformatオペランドと + 構文にできるだけ近くなるよう作成されています. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>a1,...,an</term> + <listitem> + <para>formatパラメータに基づき変換,出力されるデータを定義します.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>説明</title> + <para> + <literal>mprintf</literal>関数はC言語の<literal>printf</literal>へ + のインターフェイスです. + </para> + <para> + <literal>mprintf</literal>関数は整形されたオペランドを + Scilab標準出力(すなわち,Scilabウインドウ)に書き込みます. + argumentオペランドはformatオペランドの制御の下で整形されます. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +mprintf('At iteration %i, Result is:\nalpha=%f',33,0.535) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="disp">disp</link> + </member> + <member> + <link linkend="printf_conversion">printf_conversion</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/ja_JP/msprintf.xml b/modules/output_stream/help/ja_JP/msprintf.xml new file mode 100755 index 000000000..0e15eb396 --- /dev/null +++ b/modules/output_stream/help/ja_JP/msprintf.xml @@ -0,0 +1,86 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 2008 - INRIA + * ... + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="msprintf" xml:lang="ja"> + <refnamediv> + <refname>msprintf</refname> + <refpurpose>データを変換,整形し,文字列に書き込む</refpurpose> + </refnamediv> + <refnamediv xml:id="sprintf"> + <refname>sprintf</refname> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>str=msprintf(format,a1,...,an);</synopsis> + </refsynopsisdiv> + <refsection> + <title>パラメータ</title> + <variablelist> + <varlistentry> + <term>format</term> + <listitem> + <para> + 残りのオペランドを書き込む際に使用される + フォーマット定義するSclab文字列. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>str</term> + <listitem> + <para>文字列.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>a1,...,an</term> + <listitem> + <para>S + formatパラメータに基づき変換,出力されるデータを定義します. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>説明</title> + <para> + <literal>msprintf</literal>は,整形されたオペランドを + その戻り値(Scilab文字列)に書き込みます. + argumentオペランドはformatオペランドの制御の下で + 整形されます. + </para> + <para> + この場合,エスケープシーケンス(<literal>"\n"</literal>) は + 文字列を文字列の行列に分割することに注意してください (例を参照) + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +msprintf('%5.3f %5.3f',123,0.732) +msprintf('%5.3f\n%5.3f',123,0.732) +msprintf('--%s-\n-%d--',"hello",3) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="mprintf">mprintf</link> + </member> + <member> + <link linkend="printf_conversion">printf_conversion</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/ja_JP/prettyprint.xml b/modules/output_stream/help/ja_JP/prettyprint.xml new file mode 100755 index 000000000..102ae0022 --- /dev/null +++ b/modules/output_stream/help/ja_JP/prettyprint.xml @@ -0,0 +1,157 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * + * This help file was generated from prettyprint.sci using help_from_sci(). + * + --> +<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="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="prettyprint" xml:lang="ja"> + <refnamediv> + <refname>prettyprint</refname> + <refpurpose>Scilabデータ型からTeX, LaTeXまたはMathML形式の出力を得る</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis> + str = prettyprint(a) // デフォルト形式 (LaTeX)で変数を表示 + str = prettyprint(a, exportFormat) // 指定された形式で変数を表示 + str = prettyprint(a, exportFormat, delim) // 上と同様ですが,デリミタを変更 + str = prettyprint(a, exportFormat, delim, processByElement) // 上と同様ですが,各要素を独立に処理 + str = prettyprint(a, exportFormat, delim, processByElement, isWrapped) // 上と同様ですが,TeXまたはLaTeXエクスポートのspecialキーワードを追加 + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Pパラメータ</title> + <variablelist> + <varlistentry> + <term>a</term> + <listitem> + <para>Scilab変数</para> + </listitem> + </varlistentry> + <varlistentry> + <term>exportFormat</term> + <listitem> + <para>出力形式で,省略された場合はデフォルトで'latex'が使用されます. + 'latex', 'tex' または 'mathml'とすることができます. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>delimiter</term> + <listitem> + <para> 結果の行列で使用されるデリミタを示す文字列で, + isWrappedがtrueの場合にみ使用されます. + デリミタは '(', '{', '[', '|', '||' または ')' とすることができます + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>processByElement</term> + <listitem> + <para> 結果の行列が一つの文字列に変換されるかどうかを設定する論理値.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>isWrapped</term> + <listitem> + <para>xstring または xtitleで使用される際, + 結果がデリミタ(latexおよびtexの場合は'$',mathmlの場合はなし)で + 括られるかどうかを設定する論理値. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>str</term> + <listitem> + <para>変数aの表現</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>説明</title> + <para> + 変数を指定すると, + prettyprint 関数はこれを整形した結果を出力します. + 形式はTeX, LaTeX または MathMLです. + これらはサードパーティアプリケーションだけでなく, + Scilab内でも多くの + <link linkend="math_rendering_features_in_graphic">Scilabグラフィック機能</link>で + 使用できます. + 以下の型がこの関数で処理できます: + </para> + <itemizedlist> + <listitem> + <para>実数 / 複素数行列</para> + </listitem> + <listitem> + <para>多項式型</para> + </listitem> + <listitem> + <para>論理値</para> + </listitem> + <listitem> + <para>整数</para> + </listitem> + <listitem> + <para>文字列</para> + </listitem> + <listitem> + <para>tlist</para> + </listitem> + <listitem> + <para>有理数</para> + </listitem> + <listitem> + <para>セル</para> + </listitem> + </itemizedlist> + <para/> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +str = prettyprint(rand(3,3)) // 3x3 行列のLaTeX表現を返す +xstring(0.2,0.2,str) // グラフィックウインドウに表示 +prettyprint(rand(3,4),"mathml") // 3x4行列のMathML表現を返す +prettyprint(rand(3,4),"mathml","[") // 3x4行列のMathML表現を'['をデリミタとして 返す +s=poly(0,'s'); G=[1,s;1+s^2,3*s^3]; +xstring(0.2,0.2,prettyprint(G*s-1)); // LaTeX表現により多項式を表示 + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="math_rendering_features_in_graphic">math_rendering_features_in_graphic</link> + </member> + <member> + <link linkend="xtitle">xtitle</link> + </member> + <member> + <link linkend="axes_properties">axes_properties</link> + </member> + <member> + <link linkend="label_properties">label_properties</link> + </member> + <member> + <link linkend="legend_properties">legend_properties</link> + </member> + <member> + <link linkend="sci2exp">sci2exp</link> + </member> + <member> + <link linkend="text_properties">text_properties</link> + </member> + <member> + <link linkend="xstringb">xstringb</link> + </member> + <member> + <link linkend="xstringl">xstringl</link> + </member> + <member> + <link linkend="xstring">xstring</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/ja_JP/print.xml b/modules/output_stream/help/ja_JP/print.xml new file mode 100755 index 000000000..b6c50552d --- /dev/null +++ b/modules/output_stream/help/ja_JP/print.xml @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) XXXX-2008 - INRIA + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="ja" xml:id="print"> + <refnamediv> + <refname>print</refname> + <refpurpose>変数をファイルに出力する</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>print('file-name',x1,[x2,...xn])</synopsis> + </refsynopsisdiv> + <refsection> + <title>説明</title> + <para> + <literal>xi</literal> をファイル <literal>'file-name'</literal>にカレントの + 形式,すなわち,Scilabが変数を表示する際に使用される形式,で出力します. + 任意の変数型は "<literal>print</literal>" で出力できます. + </para> + <para> + 注意 : <literal>xi</literal> は名前のある変数である必要があり, + 変数式を含む場合には表示される名前の部分は予測不能となります. + </para> + <para> + <literal>print(%io(2),...)</literal> はScilabのウインドウに出力します. + この構文はマクロの中で変数を表示する際に使用することができます. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +a=rand(3,3);p=poly([1,2,3],'s');l=list(1,'asdf',[1 2 3]); +print(%io(2),a,p,l) +write(%io(2),a) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="write">write</link> + </member> + <member> + <link linkend="read">read</link> + </member> + <member> + <link linkend="format">format</link> + </member> + <member> + <link linkend="mprintf">mprintf</link> + </member> + <member> + <link linkend="disp">disp</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/ja_JP/printf_conversion.xml b/modules/output_stream/help/ja_JP/printf_conversion.xml new file mode 100755 index 000000000..88c6fa32d --- /dev/null +++ b/modules/output_stream/help/ja_JP/printf_conversion.xml @@ -0,0 +1,336 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) XXXX-2008 - INRIA + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="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="printf_conversion" xml:lang="ja"> + <refnamediv> + <refname>printf_conversion</refname> + <refpurpose>mprintf, msprintf, mfprintf 変換仕様</refpurpose> + </refnamediv> + <refsection> + <title>説明</title> + <para> + <literal>mprintf</literal> , + <literal>msprintf</literal> , <literal>mfprintf</literal>における各変換仕様. + <literal>format</literal> パラメータは以下のような構文を有します: + </para> + <itemizedlist> + <listitem> + <para>A % (パーセント) 符号.</para> + </listitem> + <listitem> + <para> + 0個以上の <literal>options</literal>で, + 変換仕様の意味を修正します. + 以下のリストに<literal>option</literal>文字とその意味を示します: + </para> + <itemizedlist> + <listitem> + <para>- : 左揃え, フィールド内では, 変換の結果.</para> + </listitem> + <listitem> + <para>+ : (+または -)を指定する符号変換の結果を開始.</para> + </listitem> + <listitem> + <para>'空白' : + 符号変換後の最初の文字が符号ではない場合に結果の + 前に空白文字を付加します. + (空白) および +オプションが共に指定された場合, + (空白) オプションは無視されます. + </para> + </listitem> + <listitem> + <para># : 別の形式に値を変換. + <literal>c</literal>, <literal>d</literal>, <literal>i</literal>, + <literal>s</literal>, および <literal>u</literal> 変換の場合, + <literal>#</literal>オプションの効果はありません. + <literal>o</literal> 変換の場合, <literal>#</literal> は + 結果の最初の桁を強制的に0 (ゼロ)にし,精度を増加させます. + <literal>x</literal> および <literal>X</literal>変換の場合, + ゼロでない結果の前に0xまたは0Xが付加されます. + <literal>e, E, f, g,</literal> および <literal>G</literal>変換の場合, + 小数点以下の値がない場合でも結果には常に小数点が含まれます. + <literal>g</literal> および + <literal>G</literal> 変換の場合, + 末尾の0は結果から除かれません. + </para> + </listitem> + <listitem> + <para>0 : + <literal>d</literal>, + <literal>i</literal>, <literal>o</literal>, <literal>u</literal>, + <literal>x</literal>, <literal>X</literal>, <literal>e</literal>, + <literal>E</literal>, <literal>f</literal>, <literal>g</literal>, + および <literal>G</literal>変換において + (符号または基底の指示子の後に) + 前に0をつけることによりフィールド幅内を埋めます: + 空白によるパディングは行われません + <literal>0</literal> および <literal>\-</literal>(ダッシュ)が共に指定された場合, + <literal>0</literal>フラグは無視されます. + <literal>d</literal>, <literal>i</literal>, + <literal>o</literal> <literal>u</literal>, <literal>x</literal>, + および <literal>X</literal> 変換の場合, 精度が指定されると, + <literal>0</literal> フラグも無視されます. + </para> + </listitem> + </itemizedlist> + </listitem> + </itemizedlist> + <para> + オプションの10進数文字列は + 最小フィールド幅を指定します. + 変換された値の文字がこのフィールド幅よりも少ない場合, + フィールドはフィールド幅の指定長まで左側にパディングされます. + 左寄せオプションが指定された場合, + フィールドは右側にパディングされます. + </para> + <para> + オプションの精度. 精度は <literal>.</literal> (ドット)の後に + 10進数文字列が続きます. + 精度が指定されない場合, + このパラメータは 0 (ゼロ)と扱われます. + 精度指定子: + </para> + <itemizedlist> + <listitem> + <para> + <literal>d</literal>, + <literal>u</literal>, <literal>o</literal>, <literal>x</literal>, または + <literal>X</literal>変換に関する最小表示桁数 + </para> + </listitem> + <listitem> + <para> + <literal>e</literal>, <literal>E</literal>, および <literal>f</literal> + における小数点の後に表示する桁数 + </para> + </listitem> + <listitem> + <para> + <literal>g</literal> および<literal>G</literal>変換における + 有効桁の最大値 + </para> + </listitem> + <listitem> + <para> + <literal>s</literal>変換において文字列から出力される + 最大文字数 + </para> + </listitem> + <listitem> + <para>適用される変換の種類を示す文字:</para> + <itemizedlist> + <listitem> + <para>% : 変換しません. %を表示.</para> + </listitem> + <listitem> + <para> + d,i: 整数 <literal>value</literal> を受け取り, + 符号付き10進数表記に変換します. + 精度は表示される最小の桁数を指定します. + 変換される値がより少ない桁数で表せる場合, + 前にゼロを付加して拡張されます. + デフォルトの精度は1です.値0を精度0で変換した結果は, + ヌル文字列となります. + 前に付加する文字をゼロとしてフィールド幅を指定すると, + フィールド幅までの値では前にゼロを付加するパディングが + 行われます. + </para> + </listitem> + <listitem> + <para> + u : 整数 <literal>value</literal> を受け取り, + 符号なし10進数表記に変換します. + 精度は表示される最小の桁数を指定します. + 変換される値がより少ない桁数で表せる場合, + 前にゼロを付加して拡張されます. + デフォルトの精度は1です.値0を精度0で変換した結果は, + ヌル文字列となります. + 前に付加する文字をゼロとしてフィールド幅を指定すると, + フィールド幅までの値では前にゼロを付加するパディングが + 行われます. + </para> + </listitem> + <listitem> + <para> + o : 整数 <literal>value</literal> を受け取り, + 符号なし8進数表記に変換します. + 精度は表示される最小の桁数を指定します. + 変換される値がより少ない桁数で表せる場合, + 前にゼロを付加して拡張されます. + デフォルトの精度は1です.値0を精度0で変換した結果は, + ヌル文字列となります. + 前に付加する文字をゼロとしてフィールド幅を指定すると, + フィールド幅までの値では前にゼロを付加するパディングが + 行われます. フィールド幅に8進数を使用することはできません. + </para> + </listitem> + <listitem> + <para> + x, X : 整数 <literal>value</literal> を受け取り, + 符号なし16進数表記に変換します.<literal>x</literal>変換では, + 文字``abcdef''が使用されます;<literal>X</literal>変換では, + 文字``ABCDEF''が使用されます. + 精度はは表示される最小の桁数を指定します. + 変換される値がより少ない桁数で表せる場合, + 前にゼロを付加して拡張されます. + デフォルトの精度は1です.値0を精度0で変換した結果は, + ヌル文字列となります. + 前に付加する文字をゼロとしてフィールド幅を指定すると, + フィールド幅までの値では前にゼロを付加するパディングが + 行われます. + </para> + </listitem> + <listitem> + <para> + f : float または double の<literal>value</literal> を受け取り, + %[\-]<literal>ddd.ddd</literal>形式の10進数表記に変換します. + 小数点以下の桁数は,精度指定子に等しくなります. + </para> + <itemizedlist> + <listitem> + <para>精度が指定されない場合, 6桁が出力されます.</para> + </listitem> + <listitem> + <para>精度がゼロの場合, 小数点は表示されず, + システムは<literal>value</literal>に最も近い整数に丸めた数を + 出力します. + </para> + </listitem> + <listitem> + <para>小数点が出力される場合,最低でも1桁がその前に出力されます.</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para> + e, E : 実数を受け取り,指数形式%[\-]<literal>d.ddde</literal>+/\-<literal>dd</literal> + に変換します. + 小数点の前に1桁があり,小数点の後の桁数は精度指定子に等しくなります. + </para> + <itemizedlist> + <listitem> + <para>精度が指定されない場合, 6桁が出力されます.</para> + </listitem> + <listitem> + <para>精度がゼロの場合, 小数点は表示されません. + </para> + </listitem> + <listitem> + <para> + <literal>E</literal> 変換文字の場合, + 指数の前の e の代わりに E を付けた数値を出力します. + 指数には常に2桁以上が含まれます. + 値が 0 の場合, 指数は 0 となります. + </para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para>g, G : 実数を受け取り,有効桁数を指定する精度を付けた + <literal>e</literal>, <literal>E</literal>, または + <literal>f</literal>変換文字の形式に変換します. + 末尾のゼロは結果から削除されます. + 小数点は数字が続く場合にのみ表示されます. + 使用される形式は変換される値に依存します. + 変換結果の指数が-4よりも小さい場合,または, + 精度より大きいか等しい場合に, + <literal>e</literal> (使用されるフラグが<literal>G</literal>の場合は + <literal>E</literal>)形式が使用されます. + </para> + </listitem> + <listitem> + <para>c : 整数値を受け取り,文字に変換します.</para> + </listitem> + <listitem> + <para> + s : 文字列 <literal>value</literal> を受け取り, + 文字列から末尾または精度に示された文字数に達するまで, + 文字に変換します.精度が指定されない場合,末尾までの全ての文字が + 表示されます. + </para> + </listitem> + </itemizedlist> + </listitem> + </itemizedlist> + <para>フィールド幅または精度は, + 桁文字の代わりに<literal>*</literal> (アスタリスク)で + 示すことができます. + この場合,整数 <literal>value</literal>パラメータは + フィールド幅または精度を指定します. + 出力に変換される<literal>value</literal> パラメータは + 変換文字が達するまで取得されません. + このため, + フィールド幅または精度を指定するパラメータは変換される値よりも + 前に現れる必要があります. + </para> + <para>変換の結果がフィールド幅よりも広い場合, + このフィールドは変換結果を含められる幅まで拡張されます. + </para> + <para> + +記号の意味は<literal>+</literal>または(空白)整形オプションの + どちらが指定されたかに依存します. + </para> + <para>指数形式 %e の表示はプレットフォームに依存し, + 指数の桁数は異なります. + </para> + <informaltable border="1"> + <tr> + <td>プラットフォーム</td> + <td>例: msprintf("%e",1.23e4)</td> + </tr> + <tr> + <td>Windows</td> + <td>1.23000e+004</td> + </tr> + <tr> + <td>Linux/Mac OS</td> + <td>1.23000e+04</td> + </tr> + </informaltable> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +mprintf('a string: %s\n', 'Scilab'); +mprintf('an integer: %d\n', 10); +mprintf('an integer: %4d\n', 10); +mprintf('a left justified integer: %-4d\n', 10); +mprintf('an integer converted to float: %#fd\n',10); +mprintf('an integer with a sign: %+4d\n', 10); +mprintf('an integer with a sign: %+4d\n', -10); +mprintf('an integer padded with zeros: %04d\n', 10); +mprintf('an unsigned integer: %u\n', 10); +mprintf('an unsigned integer: %4u\n', -10); +mprintf('an integer converted to hexadecimal: %x\n', 10); +mprintf('a float: %d\n', %pi); +mprintf('a float: %3.2d\n', %pi); +mprintf('a float (exponential form): %3.2e\n', %pi); +mprintf('a float (exponential form): %3.2g\n', %pi); +mprintf('a character: %c\n', 'a'); +mprintf('a character: %c\n', 'aaa'); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="mprintf">mprintf</link> + </member> + <member> + <link linkend="mfprintf">mfprintf</link> + </member> + <member> + <link linkend="msprintf">msprintf</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/pt_BR/addchapter.sce b/modules/output_stream/help/pt_BR/addchapter.sce new file mode 100755 index 000000000..00025d1b5 --- /dev/null +++ b/modules/output_stream/help/pt_BR/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Funções de Saída",SCI+"/modules/output_stream/help/pt_BR",%T); + diff --git a/modules/output_stream/help/pt_BR/disp.xml b/modules/output_stream/help/pt_BR/disp.xml new file mode 100755 index 000000000..5e64b614c --- /dev/null +++ b/modules/output_stream/help/pt_BR/disp.xml @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) XXXX-2008 - INRIA + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="disp" xml:lang="en"> + <refnamediv> + <refname>disp</refname> + <refpurpose>exibio de variveis</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>disp(x1,[x2,...xn])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Descrio</title> + <para> + Exibe <literal>xi</literal> com o formato corrente. + <literal>xi</literal>'s so objetos arbitrrios (matrizes de constantes, + strings, funes, listas, ...) + </para> + <para> + A exibio de objetos definidos por <literal>tlist</literal>'s pode + ser sobrecarregada pela definio de uma funo. Esta funo no deve ter + argumento de sada, um nico argumento de entrada e seu nome deve ser + formado como segue: <literal>%<tlist_type>_p</literal> onde + <literal>%<tlist_type></literal> a primeira entrada do componente + de tipo tlist. + </para> + <para> + A funo <link linkend="lines">lines</link> pode ser usada para + controlar a sada. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +disp([1 2],3) +deff('[]=%t_p(l)','disp(l(3),l(2))') +disp(tlist('t',1,2)) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="lines">lines</link> + </member> + <member> + <link linkend="write">write</link> + </member> + <member> + <link linkend="read">read</link> + </member> + <member> + <link linkend="print">print</link> + </member> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="tlist">tlist</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/pt_BR/print.xml b/modules/output_stream/help/pt_BR/print.xml new file mode 100755 index 000000000..45ac94176 --- /dev/null +++ b/modules/output_stream/help/pt_BR/print.xml @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) XXXX-2008 - INRIA + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="print" xml:lang="en"> + <refnamediv> + <refname>print</refname> + <refpurpose>imprime variveis em um arquivo</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>print('file-name',x1,[x2,...xn])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Descrio</title> + <para> + Imprime <literal>xi</literal> no arquivo + <literal>'file-name'</literal> com o formato corrente, i.e., o formato + utilizado pelo Scilab para exibir variveis. Todos os tipos de variveis + podem ser impressos. + </para> + <para> + Note que <literal>xi</literal> deve ser uma varivel nomeada. Com + expresses, a exibio da parte do nome da varivel imprevisvel. + </para> + <para> + <literal>print(%io(2),...)</literal> imprime na janela do Scilab. + Esta sintaxe pode ser utilizada para exibir variveis dentro de um + macro. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +a=rand(3,3);p=poly([1,2,3],'s');l=list(1,'asdf',[1 2 3]); +print(%io(2),a,p,l) +write(%io(2),a) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="write">write</link> + </member> + <member> + <link linkend="read">read</link> + </member> + <member> + <link linkend="format">format</link> + </member> + <member> + <link linkend="mprintf">mprintf</link> + </member> + <member> + <link linkend="disp">disp</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/pt_BR/printf_conversion.xml b/modules/output_stream/help/pt_BR/printf_conversion.xml new file mode 100755 index 000000000..3081734ee --- /dev/null +++ b/modules/output_stream/help/pt_BR/printf_conversion.xml @@ -0,0 +1,279 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) XXXX-2008 - INRIA + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="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="printf_conversion" xml:lang="en"> + <refnamediv> + <refname>printf_conversion</refname> + <refpurpose>Especificaes de converso de mprintf, msprintf, + mfprintf + </refpurpose> + </refnamediv> + <refsection> + <title>Descrio</title> + <para>Cada especificao de converso no parmetro format de + <literal>mprintf</literal> , <literal>msprintf</literal> , + <literal>mfprintf</literal> possui a seguinte sintaxe: + </para> + <itemizedlist> + <listitem> + <para>Um sinal % (porcento).</para> + </listitem> + <listitem> + <para> + Zero ou mais <literal>options</literal> (opes), que modificam + o significado da especificao de converso. A lista seguinte contem + os caracteres <literal>option</literal> e seus significados: + </para> + </listitem> + <listitem> + <para>Alinhe esquerda, dentro do campo, o resultado da + converso. + </para> + </listitem> + <listitem> + <para>Comece o resultado de uma converso com sinal com um sinal (+ ou + -). + </para> + </listitem> + <listitem> + <para>Prefixe um caractere de espao ao resultado se o primeiro + caractere de uma converso com sinal no for um sinal. Se ambas as + opes (espao) e + aparecerem, a opo (space) ignorada. + </para> + </listitem> + <listitem> + <para>Converta o valor para uma forma alternativa. Para as converses + <literal>c</literal>, <literal>d</literal>, <literal>i</literal>, + <literal>s</literal>, e <literal>u</literal>, a opo + <literal>#</literal> no possui efeito. Para a converso + <literal>o</literal>, <literal>#</literal> aumenta a preciso para + forar o primeiro dgito do resultado a ser 0 (zero). Para as + converses <literal>x</literal> e <literal>X</literal>, um valor + no-nulo possui 0x ou 0X prefixado a ele. Para as converses + <literal>e, E, f, g,</literal> e <literal>G</literal>, o resultado + sempre contm ponto decimal, Mesmo que nenhum dgito o siga. Para as + converses <literal>g</literal> e <literal>G</literal>, zeros por + ltimo no so removidos. + </para> + </listitem> + <listitem> + <para>Aumente a largura do campo utilizando zeros esquerda (seguindo + qualquer indicao de sinal ou base) para as converses + <literal>d</literal>, <literal>i</literal>, <literal>o</literal>, + <literal>u</literal>, <literal>x</literal>, <literal>X</literal>, + <literal>e</literal>, <literal>E</literal>, <literal>f</literal>, + <literal>g</literal>, e <literal>G</literal>; nenhum aumento de espao + realizado. Se ambos os indicadores <literal>0</literal> e + <literal>\-</literal> (barra) aparecerem, o indicador + <literal>0</literal> ignorado. Para as converses + <literal>d</literal>, <literal>i</literal>, <literal>o</literal> + <literal>u</literal>, <literal>x</literal>, e <literal>X</literal>, se + uma preciso for especificada, o indicador <literal>0</literal> tambm + ignorado. + </para> + </listitem> + <listitem> + <para>Um string de dgitos decimais opcional que especifica a largura + mnima do campo. Se o valor convertido tiver menos caracteres que a + largura do campo, o campo aumentado esquerda at o comprimento + especificado pela largura do campo. Se a opo de ajuste esquerda for + especificada, o campo aumentado pela direita. + </para> + </listitem> + <listitem> + <para> + Uma preciso opcional. A preciso um ponto <literal>.</literal> + seguido por um string de dgito decimal. Se nenhuma preciso for + fornecida, o parmetro tratado como 0 (zero). A preciso + especifica: + </para> + <itemizedlist> + <listitem> + <para>O nmero mnimo de dgitos a aparecerem nas converses + <literal>d</literal>, <literal>u</literal>, <literal>o</literal>, + <literal>x</literal>, ou <literal>X</literal> + </para> + </listitem> + <listitem> + <para>O nmero de dgitos a aparecerem aps o ponto decimal nas + converses <literal>e</literal>, <literal>E</literal>, e + <literal>f</literal> + </para> + </listitem> + <listitem> + <para>O nmero mximo de dgitos significativos para as converses + <literal>g</literal> e <literal>G</literal> + </para> + </listitem> + <listitem> + <para>O nmero mximo de caracteres a serem impressos a partir de um + string em uma conveso <literal>s</literal> + </para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para>O caractere que indica o tipo de converso a ser + aplicada: + </para> + </listitem> + <listitem> + <para>No realiza converso. Exibe %.</para> + </listitem> + <listitem> + <para>Aceita um valor inteiro e o converte para notao decimal com + sinal. A preciso especifica o nmero mnimo de dgitos a aparecer. Se + o valor sendo convertido puder ser representado em menos dgitos, ele + expandido com zeros esquerda. A preciso padro 1. O resultado + de se converter um valor zero com uma preciso de zero um string + nulo. A especificao de uma largura de campo com zero como caractere + mais esquerda faz com que o valor da largura do campo seja + preenchido com zeros esquerda. + </para> + </listitem> + <listitem> + <para>Aceita um valor inteiro e o converte para a notao decimal sem + sinal. A preciso especifica o nmero mnimo de dgitos a aparecer. Se + o valor sendo convertido puder ser representado em menos dgitos, ele + expandido com zeros esquerda. A preciso padro 1. O resultado + de se converter um valor zero com uma preciso de zero um string + nulo. A especificao de uma largura de campo com zero como caractere + mais esquerda faz com que o valor da largura do campo seja + preenchido com zeros esquerda. + </para> + </listitem> + <listitem> + <para>Aceita um valor inteiro e o converte para a sua notao octal + sem sinal. A preciso especifica o nmero mnimo de dgitos a + aparecer. Se o valor sendo convertido puder ser representado em menos + dgitos, ele expandido com zeros esquerda. A preciso padro 1. + O resultado de se converter um valor zero com uma preciso de zero + um string nulo. A especificao de uma largura de campo com zero como + caractere mais esquerda faz com que o valor da largura do campo seja + preenchido com zeros esquerda. No implicado um valor octal para a + largura do campo. + </para> + </listitem> + <listitem> + <para>Aceita um valor inteiro e o converte para a sua notao + hexadecimal sem sinal. As letras ``abcdef'' so utilizadas para a + converso <literal>x</literal>; as letras ``ABCDEF'' so utilizadas + para a converso <literal>X</literal>. A preciso especifica o nmero + mnimo de dgitos a aparecer. Se o valor sendo convertido puder ser + representado em menos dgitos, ele expandido com zeros esquerda. A + preciso padro 1. O resultado de se converter um valor zero com uma + preciso de zero um string nulo. A especificao de uma largura de + campo com zero como caractere mais esquerda faz com que o valor da + largura do campo seja preenchido com zeros esquerda. + </para> + </listitem> + <listitem> + <para>Aceita um valor float ou double e o converte para a sua notao + decimal no formato %[\-]<literal>ddd.ddd</literal>. O nmero de + dgitos aps o ponto decimal igual especificao de + preciso. + </para> + </listitem> + <listitem> + <para>Se nenhuma preciso for especificada, a sada possui seis + dgitos + </para> + </listitem> + <listitem> + <para>Se a preciso for zero, nenhum ponto decimal aparece e o sistema + imprime na sada o valor inteiro mais prximo de + <literal>value</literal>. + </para> + </listitem> + <listitem> + <para>Se a sada possui um ponto decimal, pelo menos um dgito posto + antes dele. + </para> + </listitem> + <listitem> + <para>Aceita um real e o converte para a sua forma exponencial + %[\-]<literal>d.ddde</literal>+/\-<literal>dd</literal>. H um dgito + antes do ponto decimal, e o nmero de dgitos aps o ponto decimal + igual especificao de preciso. + </para> + </listitem> + <listitem> + <para>Se nenhuma preciso for especificada, a sada so seis + dgitos + </para> + </listitem> + <listitem> + <para>Se a preciso for zero, nenhum ponto decimal aparece.</para> + </listitem> + <listitem> + <para> + A caractere de converso <literal>E</literal> produz um nmero + com o caractere 'E', ao invs de 'e' antes do expoente. O expoente + sempre contm pelo menos dois dgitos. Se o valor for zero, o expoente + zero. + </para> + </listitem> + <listitem> + <para>Aceita um real e o converte no estilo dos caracteres de + converso <literal>e</literal>, <literal>E</literal>, ou + <literal>f</literal>, com a preciso especificando o nmero de dgitos + significativos. Zeros por ltimo so removidos. Um ponto decimal + aparece apenas se for seguido de um dgito. O estilo depende do valor + convertido. O resultado o estilo <literal>e</literal> + (<literal>E</literal>, se <literal>G</literal> o indicador + utilizado) apenas se o expoente resultante da converso for menor do + que -4, ou se for maior do que ou igual preciso. + </para> + </listitem> + <listitem> + <para>Aceita e exibe um valor inteiro convertido em um + caractere. + </para> + </listitem> + <listitem> + <para>Aceita um valor string e exibe caracteres do string at o fim + ou at que o nmero de caracteres indicados pela preciso seja + alcanado. Se nenhuma preciso for especificada, todos os caracteres + at o fim so exibidos. + </para> + </listitem> + </itemizedlist> + <para>Uma largura de campo ou uma preciso podem ser indicadas por + <literal>*</literal> (astersco) ao invs de um string de dgito. Neste + caso, um parmetro de valor inteiro prov a largura do campo ou a + preciso. O parmetro de valor convertido para sada no buscado at que + a letra de converso seja alcanada, ento os parmetros especificando o + comprimento de campo ou preciso devem aparecer antes do valor a ser + convertido (se houver algum). + </para> + <para>Se o resultado da converso for maior que a largura do campo, o + campo expandido para conter o resultado convertido. + </para> + <para>A representao do sinal de mais depende da opo de formatao + especificada, se <literal>+</literal> ou (espao). + </para> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="mprintf">mprintf</link> + </member> + <member> + <link linkend="mfprintf">mfprintf</link> + </member> + <member> + <link linkend="msprintf">msprintf</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/output_stream/help/ru_RU/addchapter.sce b/modules/output_stream/help/ru_RU/addchapter.sce new file mode 100755 index 000000000..827aeaed5 --- /dev/null +++ b/modules/output_stream/help/ru_RU/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Output functions",SCI+"/modules/output_stream/help/ru_RU",%T); + |