diff options
Diffstat (limited to 'modules/string/help')
165 files changed, 16839 insertions, 0 deletions
diff --git a/modules/string/help/en_US/addchapter.sce b/modules/string/help/en_US/addchapter.sce new file mode 100755 index 000000000..7ff6a942d --- /dev/null +++ b/modules/string/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("Strings",SCI+"/modules/string/help/en_US",%T); + diff --git a/modules/string/help/en_US/ascii.xml b/modules/string/help/en_US/ascii.xml new file mode 100755 index 000000000..45395a3f1 --- /dev/null +++ b/modules/string/help/en_US/ascii.xml @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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: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="ascii" xml:lang="en"> + <refnamediv> + <refname>ascii</refname> + <refpurpose>string ASCII conversions</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>a = ascii(txt) + txt = ascii(a) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>txt</term> + <listitem> + <para>a character string or a matrix of character strings.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>a</term> + <listitem> + <para>a vector of integer ASCII codes</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + This function converts Scilab string to a vector of ASCII code (the first 127 + codes are ASCII) or vector of ASCII code to Scilab strings. + </para> + <para> + If <varname>txt</varname> is a matrix of string, <code>ascii(txt)</code> is + equivalent to <code>ascii(strcat(txt))</code>. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +ascii(["hello";"world"]) +ascii("scilab") +ascii([115 99 105 108 97 98]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="code2str">code2str</link> + </member> + <member> + <link linkend="str2code">str2code</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/asciimat.xml b/modules/string/help/en_US/asciimat.xml new file mode 100755 index 000000000..e65d084c9 --- /dev/null +++ b/modules/string/help/en_US/asciimat.xml @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 2004-2007 - INRIA - Vincent COUVERT + * + * 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="asciimat"> + <refnamediv> + <refname>asciimat</refname> + <refpurpose>string matrix ASCII conversions</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis> + a = asciimat(txt) + txt = asciimat(a) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>txt</term> + <listitem> + <para> + a character string or matrix of strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>a</term> + <listitem> + <para> + a vector or matrix of integer ASCII codes. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + This function converts Scilab string to ASCII code or a + matrix of ASCII code to Scilab string. Output is a matrix + having the same number of rows than input, what is not the + case with <function>ascii</function>. + </para> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="ascii">ascii</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/blanks.xml b/modules/string/help/en_US/blanks.xml new file mode 100755 index 000000000..adb7f8d9d --- /dev/null +++ b/modules/string/help/en_US/blanks.xml @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="blanks"> + <refnamediv> + <refname>blanks</refname> + <refpurpose>create string of blank characters</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>txt = blanks(n)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>txt</term> + <listitem> + <para>a single character string.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>n</term> + <listitem> + <para>an integer, number of blanks.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>blanks(n)</code> is a string of <varname>n</varname> blanks. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +disp(['xxx' blanks(20) 'yyy']) + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/char.xml b/modules/string/help/en_US/char.xml new file mode 100755 index 000000000..fd4a8aa1d --- /dev/null +++ b/modules/string/help/en_US/char.xml @@ -0,0 +1,108 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 2008 - INRIA - Farid BELAHCENE + * + * 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="char" xml:lang="en"> + <refnamediv> + <refname>char</refname> + <refpurpose>converts in a character array</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis> + y = char(x) + y = char(st1, st2, st3,...) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>x</term> + <listitem> + <para>a cell array of strings, or an array of ASCII codes.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>st1, st2, st3</term> + <listitem> + <para>arrays of strings.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>y</term> + <listitem> + <para>a vector of strings (column).</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <emphasis role="bold">One input argument :</emphasis> + </para> + <para> + Given a cell of array of strings <varname>x</varname>, this function + returns a vector of strings <varname>y</varname> in which the rows are the + concatenated components of corresponding rows of the cell array of strings. + </para> + <para> + Given an array of ASCII codes <varname>x</varname>, this function + returns a array of strings <varname>y</varname> corresponding into ASCII + codes. If dimensions of <varname>x</varname> are <literal>[n1, n2, n3, n4,...]</literal>, + then returned value has same size as input value except second dimension, i.e. + the dimensions of <varname>y</varname> are <literal>[n1, n3, n4,...]</literal>. + </para> + <para> + <emphasis role="bold">More than one input argument :</emphasis> + </para> + <para> + Given arrays of strings <literal>st1, st2, st3,...</literal>, this function + returns a vector of strings in which the rows are the concatenated + components of corresponding rows of <literal>st1, st2, st3,...</literal>. + In the vector <varname>y</varname> all strings <literal>sti</literal> + are completed by blanks to have the same length as the max length of + <literal>sti</literal>. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +//Example with a hypermatrix of ASCII codes : +x=hypermat([4,2,3],61:84); +y=char(x) +size(x) +size(y) + +//Example with more than one argument : +st1="zeros"; +st2=["one","two"]; +st3=["three"]; +y=char(st1,st2,st3) +size(y) + +//all strings rows are completed by 'blanks' to have the same length : 6 +length(y) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="ascii">ascii</link> + </member> + <member> + <link linkend="asciimat">asciimat</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/convstr.xml b/modules/string/help/en_US/convstr.xml new file mode 100755 index 000000000..78fb9d79c --- /dev/null +++ b/modules/string/help/en_US/convstr.xml @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="convstr"> + <refnamediv> + <refname>convstr</refname> + <refpurpose>case conversion</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>[y] = convstr(str, [flag])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str, y</term> + <listitem> + <para>a matrix of character strings.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>flag</term> + <listitem> + <para>a character option with possible values:</para> + <variablelist> + <varlistentry> + <term>'u'</term> + <listitem> + <para>for upper;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>'l'</term> + <listitem> + <para>for lower.</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + The <function>convstr</function> function converts the matrix of strings + <varname>str</varname> into lower case (for <varname>flag</varname> = + <literal>"l"</literal>; default value) or upper case (for + <varname>flag</varname> = <literal>"u"</literal>). + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +A=['this','is';'my','matrix']; +convstr(A,'u') + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/emptystr.xml b/modules/string/help/en_US/emptystr.xml new file mode 100755 index 000000000..2b71ff6b6 --- /dev/null +++ b/modules/string/help/en_US/emptystr.xml @@ -0,0 +1,95 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="emptystr"> + <refnamediv> + <refname>emptystr</refname> + <refpurpose>zero length string</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>s = emptystr() + s = emptystr(a) + s = emptystr(m, n) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>a</term> + <listitem> + <para> + a matrix of size <literal>mx n</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>s</term> + <listitem> + <para>a matrix of character strings.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>m, n</term> + <listitem> + <para>integers</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + The <function>emptystr</function> function returns a matrix of zero + length character strings. + </para> + <para> + With no input argument <function>emptystr</function> returns a zero + length character string. + </para> + <para> + With a matrix <varname>a</varname> for input argument + <function>emptystr</function> returns a zero length character + strings matrix of the same size. + </para> + <para> + With two integer arguments <function>emptystr</function> returns a + <varname>m</varname> <literal>x</literal> <varname>n</varname> zero + length character strings matrix. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +x=emptystr(); +for k=1:10 + x = x + ',' + string(k) + emptystr(1,k) + string(k) +end + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="part">part</link> + </member> + <member> + <link linkend="length">length</link> + </member> + <member> + <link linkend="string">string</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/eval.xml b/modules/string/help/en_US/eval.xml new file mode 100755 index 000000000..e9fdfdf37 --- /dev/null +++ b/modules/string/help/en_US/eval.xml @@ -0,0 +1,60 @@ +<?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="eval" xml:lang="en"> + <refnamediv> + <refname>eval</refname> + <refpurpose>evaluation of a matrix of strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>[H] = eval(Z)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>Z</term> + <listitem> + <para>a matrix of character string.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + The <function>eval</function> function returns the evaluation of the matrix of character strings + <varname>Z</varname>. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +a=1; +b=2; +Z=['a','sin(b)']; +eval(Z) //returns the matrix [1, 0.909]; + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="evstr">evstr</link> + </member> + <member> + <link linkend="execstr">execstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/evstr.xml b/modules/string/help/en_US/evstr.xml new file mode 100755 index 000000000..c79b9b890 --- /dev/null +++ b/modules/string/help/en_US/evstr.xml @@ -0,0 +1,126 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * + * 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="evstr" xml:lang="en"> + <refnamediv> + <refname>evstr</refname> + <refpurpose>evaluation of expressions</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis> + H = evstr(Z) + [H, ierr] = evstr(Z) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>Z</term> + <listitem> + <para> + a matrix of character strings <varname>M</varname> or + <code>list(M,Subexp)</code> + </para> + <variablelist> + <varlistentry> + <term>M</term> + <listitem> + <para>a matrix of character strings.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>Subexp</term> + <listitem> + <para>a vector of character strings.</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + <varlistentry> + <term>H</term> + <listitem> + <para>a matrix.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>ierr</term> + <listitem> + <para>an integer, error indicator.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + Returns the result of the evaluation of the matrix of character + strings <varname>M</varname>. Each element of the matrix must define a + valid Scilab expression. + </para> + <para> + If the evaluation of <varname>M</varname> expression leads to an + error, the single return value version, <code>H = evstr(M)</code>, + raises the error as usual. The two return values version, + <code>[H,ierr] = evstr(M)</code>, on the other hand, produces no + error, but returns the error number in <varname>ierr</varname>. + </para> + <para> + If <varname>Z</varname> is a list, <varname>Subexp</varname> is a + vector of character strings, that defines subexpressions which are + evaluated before evaluating <varname>M</varname>. These subexpressions + must be referred to as <literal>%(k)</literal> in <varname>M</varname>, + where <literal>k</literal> is the subexpression's index in + <varname>Subexp</varname>. + </para> + <para> + <code>evstr('a = 1')</code> is not valid (use <function>execstr</function> + instead). + </para> + <para> + <literal>Nan</literal>, <literal>NaN</literal> will be interpreted as <constant>%nan</constant>. + </para> + <para> + <literal>Inf</literal> will be interpreted as <constant>%inf</constant>. + </para> + <note> + Note that <varname>Z</varname> should not be composed of continuation marks (..). + </note> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"> + a = 1; b = 2; + Z = ['a', 'b'] ; + evstr(Z) + + Z = list(['%(1)','%(1)-%(2)'],['a+1','b+1']); + evstr(Z) + + evstr('NaN'), evstr('Inf') + + //The two return values version + [H, ierr] = evstr(Z) // no error + Z = ['a', 'b', 'c'] ;// the variable c is undefined + [H, ierr] = evstr(Z) // error 4: Undefined variable: c + </programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="execstr">execstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/grep.xml b/modules/string/help/en_US/grep.xml new file mode 100755 index 000000000..83b352740 --- /dev/null +++ b/modules/string/help/en_US/grep.xml @@ -0,0 +1,131 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="grep" xml:lang="en"> + <refnamediv> + <refname>grep</refname> + <refpurpose>find matches of a string in a vector of strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>row = grep(haystack, needle ) + [row, which] = grep(haystack, needle ) + row = grep(haystack, needle, [flag]) + [row, which] = grep(haystack, needle, [flag]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>haystack</term> + <listitem> + <para>a row vector of character strings.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>needle</term> + <listitem> + <para> + a character string or a row vector of character strings. The + string(s) to search in <varname>haystack</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>row</term> + <listitem> + <para> + a vector of indices: row where a match has been found or an + empty matrix if no match found. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>which</term> + <listitem> + <para> + a vector of indices: index of <varname>needle</varname> string found + or an empty matrix if no match found. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>flag</term> + <listitem> + <para> + a character (<literal>"r"</literal> for regular expression). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + For each entry of <varname>haystack</varname>, <function>grep</function> + searches if at least a string in <varname>needle</varname> which matches a + substring. The <varname>haystack</varname> entries index where at least a + match has been found are returned in the <varname>row</varname> output + argument. The optional <varname>which</varname> output argument gives the + index of first string of <varname>needle</varname> found. + </para> + <para> + When using the third parameter <varname>flag</varname><literal>="r"</literal>, the + <varname>needle</varname> is expected to be a regular expression string. + In this case, <function>grep</function> uses the + <varname>needle</varname> as a regular expression and compares it + against <varname>haystack</varname> according to the regular expressions + rules. See the <link linkend="regexp">regexp</link> function for details about + regular expressions. + </para> + </refsection> + <refsection> + <title>Example #1</title> + <para> + In the following example, we search one or two strings in a text, + which is stored in the <varname>txt</varname> variable. + </para> + <programlisting role="example"><![CDATA[ +txt=['find matches of a string in a vector of strings' + 'search position of a character string in an other string' + 'Compare Strings']; + +grep(txt,'strings') +grep(txt,['strings' 'Strings']) + +[r,w]=grep(txt,['strings' 'Strings']) + ]]></programlisting> + </refsection> + <refsection> + <title>Example #2</title> + <para>In the following example, we perform regexp searches.</para> + <programlisting role="example"><![CDATA[ +str = ["hat";"cat";"hhat";"chat";"hcat";"ccchat";"at";"dog"] + +grep(str,'/[hc]+at/','r') +grep(str,'/[hc]?at/','r') +grep(str,'/cat|dog/','r') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="strindex">strindex</link> + </member> + <member> + <link linkend="regexp">regexp</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/isalphanum.xml b/modules/string/help/en_US/isalphanum.xml new file mode 100755 index 000000000..68976c0ae --- /dev/null +++ b/modules/string/help/en_US/isalphanum.xml @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="isalphanum"> + <refnamediv> + <refname>isalphanum</refname> + <refpurpose>check that characters of a string are alphanumerics</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = isalphanum(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>a character string.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>a boolean matrix.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = isalphanum(str)</code> returns an array the same size as + <varname>str</varname> containing logical <constant>%t</constant> + (true) where the elements of <varname>str</varname> are + alphanumerics and logical <constant>%f</constant> (false) where they + are not. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +s = 'A1,B2,C3'; +isalphanum(s) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="isletter">isletter</link> + </member> + <member> + <link linkend="isdigit">isdigit</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/isascii.xml b/modules/string/help/en_US/isascii.xml new file mode 100755 index 000000000..54d3d94d3 --- /dev/null +++ b/modules/string/help/en_US/isascii.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) 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="isascii"> + <refnamediv> + <refname>isascii</refname> + <refpurpose>tests if character is a 7-bit US-ASCII character</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = isascii(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>a character string or an array of integers.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>a boolean matrix.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = isascii(str)</code> returns <constant>%t</constant> + (TRUE) if entries of <varname>str</varname> are a 7-bit + US-ASCII character code between 0 and octal 0177 inclusive (or + entries of <varname>str</varname> are 7-bit US-ASCII characters). + Otherwise returns <constant>%f</constant> (FALSE). + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +letters = [115. 99. 105. 108. 97. 98.] +isascii(letters) +ascii(letters) +isascii('scilab') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="isalphanum">isalphanum</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/isdigit.xml b/modules/string/help/en_US/isdigit.xml new file mode 100755 index 000000000..15c47d858 --- /dev/null +++ b/modules/string/help/en_US/isdigit.xml @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="isdigit"> + <refnamediv> + <refname>isdigit</refname> + <refpurpose> + check that characters of a string are digits between 0 and 9 + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = isdigit(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>a character string.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>a boolean matrix.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = isdigit(str)</code> returns an array the same size as + <varname>str</varname> containing logical <constant>%t</constant> + (TRUE) where the elements of <varname>str</varname> are digits and + logical <constant>%f</constant> (FALSE) where they are not. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +s = 'A1,B2,C3'; +isdigit(s) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="isalphanum">isalphanum</link> + </member> + <member> + <link linkend="isletter">isletter</link> + </member> + <member> + <link linkend="isnum">isnum</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/isletter.xml b/modules/string/help/en_US/isletter.xml new file mode 100755 index 000000000..af2d15c45 --- /dev/null +++ b/modules/string/help/en_US/isletter.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) 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" +xml:lang="en" xml:id="isletter"> + <refnamediv> + <refname>isletter</refname> + <refpurpose> + check that characters of a string are alphabetic letters + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = isletter(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>a character string.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>a boolean matrix.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = isletter(str)</code> returns an array the same size as + <varname>str</varname> containing logical <constant>%t</constant> + (true) where the elements of <varname>str</varname> are letters of + the alphabet and logical <constant>%f</constant> (false) where they + are not. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +s = 'A1,B2,C3'; +isletter(s) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="isalphanum">isalphanum</link> + </member> + <member> + <link linkend="isdigit">isdigit</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/isnum.xml b/modules/string/help/en_US/isnum.xml new file mode 100755 index 000000000..8b1d6cf88 --- /dev/null +++ b/modules/string/help/en_US/isnum.xml @@ -0,0 +1,94 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- +* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +* Copyright (C) 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" +xml:lang="en" xml:id="isnum"> + <refnamediv> + <refname>isnum</refname> + <refpurpose>tests if a string represents a number</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = isnum(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para> + a character string or a matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>a boolean matrix.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = isnum(str)</code> returns <constant>%t</constant> if + <varname>str</varname> represents a number. + </para> + <para> + <code>isnum</code> does not handle "operations", but only pure scalar numbers. + For instance, <code>isnum("1+2*3")</code> will return <code>%f</code>. + Complex numbers are not concerned, because one complex number is defined by the addition of two parts. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +isnum(['1' , .. + '-1.23' , .. + '+1e+23' , .. + '1d+23' , .. + 'A' , .. + '%e' , .. + '%pi' , .. + '%nan' , .. + 'Nan' , .. + '%inf' , .. + 'Inf' , .. + '1+%i*2' , .. + '%eps-%eps*%i', .. + '%inf+Nan*%i' ]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="isletter">isletter</link> + </member> + <member> + <link linkend="isdigit">isdigit</link> + </member> + <member> + <link linkend="isalphanum">isalphanum</link> + </member> + <member> + <link linkend="evstr">evstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/justify.xml b/modules/string/help/en_US/justify.xml new file mode 100755 index 000000000..9ce7e9576 --- /dev/null +++ b/modules/string/help/en_US/justify.xml @@ -0,0 +1,104 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- +* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +* Copyright (C) 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" + xml:lang="en" xml:id="justify"> + <refnamediv> + <refname>justify</refname> + <refpurpose>justify character array</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>Tj = justify(T, opt)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>T</term> + <listitem> + <para>a matrix of character strings.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>Tj</term> + <listitem> + <para> + a matrix of character strings. The justified result. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>opt</term> + <listitem> + <para> + a character option with possible values: + </para> + <variablelist> + <varlistentry> + <term>'r' or 'right'</term> + <listitem> + <para>for right justification;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>'l' or 'left'</term> + <listitem> + <para>for left justification;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>'c' or 'center'</term> + <listitem> + <para>for centering justification.</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + The <function>justify</function> function justifies the column of a + matrix of string according to the given option <varname>opt</varname>. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +t=['1234','x','adfdfgdfghfgj' + '1','354556','dgf' + 'sdfgd','','sdfsf']; + +justify(t,'l') +justify(t,'c') +justify(t,'r') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="length">length</link> + </member> + <member> + <link linkend="part">part</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/length.xml b/modules/string/help/en_US/length.xml new file mode 100755 index 000000000..4b60897ce --- /dev/null +++ b/modules/string/help/en_US/length.xml @@ -0,0 +1,123 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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" xml:id="length" xml:lang="en"> + <refnamediv> + <refname>length</refname> + <refpurpose>length of object</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>n = length(M)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>M</term> + <listitem> + <para> + a matrix (usual or polynomial or character string) or a + list. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>n</term> + <listitem> + <para>an integer or a matrix of integers.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + For usual or polynomial matrix <varname>n</varname> is the integer + equal to number of rows times number of columns + of <varname>M</varname>. (Also valid for <varname>M</varname> + a boolean matrix). + </para> + <para> + For matrices made of character strings (and in particular for a + character string) <function>length</function> returns in + <varname>n</varname> the length of entries of the matrix of + character strings <varname>M</varname>. + </para> + <para> + The length of a list is the number of elements in the list (also + given by <function>size</function>). + </para> + <para> + The length of a mlist is by default the number of elements in the + mlist, but you can overload it (see example). Note that for a non-string + hypermatrix, there is no need to overload the function. Indeed, <function>length</function> + returns the product of the dimensions of the hypermatrix. + </para> + <para> + <code>length('123')</code> is <literal>3</literal>. + <code>length([1,2;3,4])</code> is <literal>4</literal>. + </para> + <para> + <warning> + WARNING : <function>length</function> of a sparse matrix + returns the max of dimensions and not the product + of the dimensions. (For example: + <code>length(sparse(eye(12,2)))</code> + returns <code>max(12,2)</code> and not <literal>24</literal>). + Please use <literal>size(...,'*')</literal> with sparse matrix. + </warning> + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +length([123 ; 456 ]) +length(['hello world',SCI]) +length(rand(2,2,2)) + + ]]></programlisting> + <programlisting role="example"><![CDATA[ + +a = mlist(["myMlistT" "field1" "field2"],"aexample","bexampleb"); +length(a) +// returns 3 default behaviour if length not overloaded for mlist + +// we create an overload function for mlist of type myMlistT +function r = %myMlistT_length(M) + r = length(M.field1) +endfunction + +length(a) +// returns 8 result of length(a.field1) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="size">size</link> + </member> + </simplelist> + </refsection> + <refsection> + <title>History</title> + <revhistory> + <revision> + <revnumber>5.4.0</revnumber> + <revremark> + This function allows overloading for mlist type. + </revremark> + </revision> + </revhistory> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/part.xml b/modules/string/help/en_US/part.xml new file mode 100755 index 000000000..2cc4e086a --- /dev/null +++ b/modules/string/help/en_US/part.xml @@ -0,0 +1,139 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * Copyright (C) Samuel GOUGEON - 2013 : $ is now supported. More examples. + * + * 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" xml:id="part" xml:lang="en"> + <refnamediv> + <refname>part</refname> + <refpurpose>Extraction of characters from strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>[strings_out] = part(strings_in, v)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>strings_in</term> + <listitem> + <para>a character string or matrix of character string.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>v</term> + <listitem> + <para> + a vector of integer values containing the indices of characters to be extracted. + <literal>$</literal> is accepted and means length(strings_in). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>strings_out</term> + <listitem> + <para>a character string or matrix of character string.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + This function extracts characters from strings. The characters to be + extracted are referred to by their indices contained in <literal>v</literal>. + </para> + + <para> + <literal>strings_out</literal> is filled with whitespace characters when indices + are beyond the input string's length. + </para> + <para> + <literal>v</literal> may contain <literal>$</literal> symbol which stands for the + length of <literal>string_in</literal>. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +// Returns characters position 8 to 11 +part("How to use ""part"" ?", 8:11) + +// Returns characters position 2 to 4 for each element +// No characters replaced by '' +c = part(['a', 'abc', 'abcd'], 2:4) + +// Returns character position 1 for each element and add characters position +// 4 to 7 of each element +c = part(['abcdefg', 'hijklmn', 'opqrstu'], [1, 4:7]); + +// Returns character 4 for each element, add characters position 1 to 7 and +// add character position 4 for each element +c = part(['abcdefg', 'hijklmn', 'opqrstu'], [4, 1:7, 4]); + +// Returns character position 1, add again character position 1 and +// character position 2 +c=part(['a', 'abc', 'abcd'], [1, 1, 2]) + + +part(['a', 'abc', 'abcd'], [1]) // => ['a' 'a' 'a'] +part(['a', 'abc', 'abcd'], [1, 1]) // => ['aa' 'aa' 'aa'] +part(['a', 'abc', 'abcd'], [1, 1, 2]) // => ['aa' 'aab' 'aab'] + +// Repeating a character N times: +N = 10; part('-', ones(1:N)) // => '----------' + +// Repeating a pattern N times: +N = 6; pat = '- '; +part(pat, ones(1:N).*.(1:length(pat))) // => '- - - - - - ' + +// Using $ = implicit length of strings: +// 1) +part(['a string' 'another longer one'], $-2:$ ) // => [ 'ing' 'one'] + +// 2) Another implementation for strrev(): +part('Hello world', $:-1:1) // => 'dlrow olleH' + +// 3) With unranging $: +part('Hello world', [ $ 4:5 ]) // => 'dlo' + +// 4) Mixing scalar or unrangin $ with ranging ones is not possible: +part("Hello", [ 1 $-1:$ $ ]) // => error + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="strsplit">strsplit</link> + </member> + <member> + <link linkend="length">length</link> + </member> + </simplelist> + </refsection> + + <refsection> + <title>History</title> + <revhistory> + <revision> + <revnumber>5.5.0</revnumber> + <revremark> + <literal>$</literal> standing for length(input_strings) is now accepted in indices of selected characters + </revremark> + </revision> + </revhistory> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/regexp.xml b/modules/string/help/en_US/regexp.xml new file mode 100755 index 000000000..995faca47 --- /dev/null +++ b/modules/string/help/en_US/regexp.xml @@ -0,0 +1,164 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- +* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +* Copyright (C) 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" +xml:id="regexp" xml:lang="en"> + <refnamediv> + <refname>regexp</refname> + <refpurpose> + find a substring that matches the regular expression string + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis> + [start] = regexp(input, pattern, [flag]) + [start, final] = regexp(input, pattern, [flag]) + [start, final, match] = regexp(input, pattern, [flag]) + [start, final, match, foundString] = regexp(input, pattern, [flag]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>input</term> + <listitem> + <para>a string.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>pattern</term> + <listitem> + <para> + a character string (under the rules of regular expression). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>start</term> + <listitem> + <para> + the starting index of each substring of + <varname>input</varname> that matches the regular + expression string <varname>pattern</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>final</term> + <listitem> + <para> + the ending index of each substring of + <varname>input</varname> that matches the regular + expression string <varname>pattern</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>match</term> + <listitem> + <para> + the text of each substring of <varname>input</varname> + that matches <varname>pattern</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>foundString</term> + <listitem> + <para> + the captured parenthesized <literal>subpatterns</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>[flag]</term> + <listitem> + <para> + <literal>'o'</literal> for matching the pattern once. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + The rules of regular expression are similar to Perl language. For a + quick start, see + <ulink url="http://perldoc.perl.org/perlrequick.html">http://perldoc.perl.org/perlrequick.html</ulink>. + For a more in-depth tutorial on, see + <ulink url="http://perldoc.perl.org/perlretut.html">http://perldoc.perl.org/perlretut.html</ulink> + and for the reference page, see + <ulink url="http://perldoc.perl.org/perlre.html">http://perldoc.perl.org/perlre.html</ulink> + </para> + <para> + A difference with Perl is that matching a position but no character + (for example, with <literal>/^/</literal> or + <literal>/(?=o)/</literal>) is a successful match in Perl but not + in Scilab. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +regexp('xabyabbbz','/ab*/','o') +regexp('a!','/((((((((((a))))))))))\041/') +regexp('ABCC','/^abc$/i') +regexp('ABC','/ab|cd/i') +[a b c]=regexp('XABYABBBZ','/ab*/i') + +piString="3.14" +[a,b,c,piStringSplit]=regexp(piString,"/(\d+)\.(\d+)/") +disp(piStringSplit(1)) +disp(piStringSplit(2)) + +[a,b,c,d]=regexp('xabyabbbz','/ab(.*)b(.*)/') +size(d) + +// get host name from URL +myURL="http://www.scilab.org/download/"; +[a,b,c,d]=regexp(myURL,'@^(?:http://)?([^/]+)@i') + +str='foobar: 2012'; +// Using named subpatterns +[a,b,c,d]=regexp(str,'/(?P<name>\w+): (?P<digit>\d+)/') +d(1)=="foobar" +d(2)=="2012" + + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="strindex">strindex</link> + </member> + </simplelist> + </refsection> + <refsection> + <title>History</title> + <revhistory> + <revision> + <revnumber>5.4.0</revnumber> + <revremark> + A new output argument, foundString, has been added to retrieve subpatterns matches. + </revremark> + </revision> + </revhistory> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/sci2exp.xml b/modules/string/help/en_US/sci2exp.xml new file mode 100755 index 000000000..125bd9dd8 --- /dev/null +++ b/modules/string/help/en_US/sci2exp.xml @@ -0,0 +1,147 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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" xml:lang="en" xml:id="sci2exp"> + <refnamediv> + <refname>sci2exp</refname> + <refpurpose> converts an expression to a string</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>t = sci2exp(a [,nam] [,lmax])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>a</term> + <listitem> + <para>a scilab expression, may be:</para> + <variablelist> + <varlistentry> + <term>- </term> + <listitem> + <para>a constant;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>- </term> + <listitem> + <para>a polynomial;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>- </term> + <listitem> + <para>a string matrix;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>- </term> + <listitem> + <para>a list;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>- </term> + <listitem> + <para>a boolean matrix;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>- </term> + <listitem> + <para>a handle (only figure and uicontrol).</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + <varlistentry> + <term>nam</term> + <listitem> + <para>a character string.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>t</term> + <listitem> + <para> + a vector of strings, contains the expression or the affectation instruction. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>lmax</term> + <listitem> + <para> + an integer, contains the maximum line length. Default + value is <literal>0</literal>, + which indicates no line length + control; a single string is returned. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <function>sci2exp</function> converts expression to an instruction string if <varname>nam</varname> is + given or to an expression string. + </para> + </refsection> + <refsection> + <title>Remarks</title> + <itemizedlist> + <listitem> + <para> + If <varname>a</varname> is a handle, <function>sci2exp</function> gives a result which has no hierarchical links, + that is, with empty fields for parent and children. + </para> + </listitem> + <listitem> + <para> + <varname>t</varname> can be impacted by <link linkend="format">format</link>. + </para> + </listitem> + </itemizedlist> + </refsection> + + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +a=[1 2;3 4] +sci2exp(a,'aa') +sci2exp(a,'aa',10) +sci2exp(ssrand(2,2,2)) +sci2exp(poly([1 0 3 4],'s'),'fi') +sci2exp(figure("figure_name","figure1")) +b=0.123456789; +format(5); +c=sci2exp(b) +format(10); +d=sci2exp(b) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="prettyprint">prettyprint</link> + </member> + <member> + <link linkend="format">format</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strcat.xml b/modules/string/help/en_US/strcat.xml new file mode 100755 index 000000000..c869a52ee --- /dev/null +++ b/modules/string/help/en_US/strcat.xml @@ -0,0 +1,126 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- +* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +* Copyright (C) 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" xml:id="strcat" xml:lang="en"> + <refnamediv> + <refname>strcat</refname> + <refpurpose>concatenates character strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis> + txt = strcat(strings [,string_added]) + txt = strcat(strings [,string_added, ["flag"]]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>strings</term> + <listitem> + <para>a vector or matrix of strings.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>string_added</term> + <listitem> + <para> + a string added, default value is the zero length character + string <literal>""</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>txt</term> + <listitem> + <para>a string.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>"flag"</term> + <listitem> + <para> + a character (<literal>"r"</literal> for concatenation of + rows in the matrix <varname>strings</varname>, + <literal>"c"</literal> for concatenations of columns in the + matrix <varname>strings</varname>). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>txt = strcat(strings)</code> concatenates character strings: + <literal>txt = strings(1) + ... + strings(n)</literal>. + </para> + <para> + <code>txt = strcat(strings, string_added)</code> returns + <literal>txt = strings(1) + string_added + ... + string_added + strings(n)</literal>. + </para> + <para> + The plus symbol does the same: <code>"a"+"b"</code> is the + same as <code>strcat(["a","b"]).</code>. + </para> + <para> + If the size of <varname>strings</varname> is one, it returns + <code>txt = strings(1)</code>; + </para> + <para> + <code>strcat('A','B')</code> returns <literal>'A'</literal> and not + <literal>'AB'</literal> as <code>strcat(['A','B'])</code>. + </para> + <para> + If <varname>strings</varname> is a matrix of strings, + <code>txt = strcat(strings, "", "r")</code> returns a row vector of strings. + Each entry of <varname>txt</varname> results from the concatenation of rows along + the related column. + <code>txt = strcat(strings, "", "c")</code> returns a column vector of strings. + Each entry of <varname>txt</varname> results from the concatenation of columns along + the related row. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +strcat(string(1:10),',') +strcat(["a","b"]) +strcat(["a","b"],'|') +strcat('A') +strcat('A','B') +strcat(['A','B']) +strcat(['A','B'],'') + +m =["a" "b" ; "c" "d"]; +strcat(m, "r") +strcat(m, "", "r") +strcat(m, "", "c") + +strcat(m, "_and_", "r") +strcat(m, "_and_", "c") + + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="strings">strings</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strchr.xml b/modules/string/help/en_US/strchr.xml new file mode 100755 index 000000000..284969dff --- /dev/null +++ b/modules/string/help/en_US/strchr.xml @@ -0,0 +1,82 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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" xml:lang="en" xml:id="strchr"> + <refnamediv> + <refname>strchr</refname> + <refpurpose> + find the first occurrence of a character in a string + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = strchr(haystack, char)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>haystack</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>char</term> + <listitem> + <para>a character.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = strchr(haystack, char)</code> returns the first + occurrence of character in the string <varname>haystack</varname>. + </para> + <para> + <varname>char</varname> must contain only one string or as many + strings as in <varname>haystack</varname> (each one being one- + character-long). + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +strchr('This is a sample string','s') +strchr(['This is a sample string','in scilab'],'s') +strchr(['This is a sample string','in scilab'],['s','a']) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="strrchr">strrchr</link> + </member> + <member> + <link linkend="strstr">strstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strcmp.xml b/modules/string/help/en_US/strcmp.xml new file mode 100755 index 000000000..6089d6cc9 --- /dev/null +++ b/modules/string/help/en_US/strcmp.xml @@ -0,0 +1,105 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strcmp" xml:lang="en"> + <refnamediv> + <refname>strcmp</refname> + <refpurpose>compare character strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = strcmp(string_one, string_two, ['i'])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>string_one</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>string_two</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>'i'</term> + <listitem> + <para> + an optional parameter to do <function>strcmpi</function> + (case independent), default value is <literal>'s'</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>a matrix of integers.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = strcmp(string_one, string_two)</code> (or + <code>res = strcmp(string_one, string_two, 's')</code>) returns an + integral value indicating the relationship between the strings. + </para> + <para> + The value greater than zero indicates that the first character that + does not match has a greater value in <varname>string_one</varname> + than in <varname>string_two</varname> and the value less than zero + indicates the opposite (lexicographical order). + </para> + <para> + The value equal zero indicates that <varname>string_one</varname> + and <varname>string_two</varname> are equal. + </para> + <para> + <code>res = strcmp(string_one, string_two, 'i')</code> returns + <literal>0</literal> if <varname>string_one</varname> is equal to + <varname>string_two</varname> (case independently) and + <literal>1</literal> indicates the opposite. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +TXT1 = ['scilab','SciLab';'Strcmp','STRcmp']; +TXT2 = ['ScIlAb','sciLab';'sTrCmP','StrCMP']; +strcmp(TXT1,TXT2) +strcmp(TXT1,'scilab') +strcmp(TXT1,'SciLab') +strcmp(TXT1,TXT2,'i') +strcmp(TXT1,TXT2,'s') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="strcat">strcat</link> + </member> + <member> + <link linkend="strcmpi">strcmpi</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strcmpi.xml b/modules/string/help/en_US/strcmpi.xml new file mode 100755 index 000000000..4bf33eda1 --- /dev/null +++ b/modules/string/help/en_US/strcmpi.xml @@ -0,0 +1,83 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strcmpi"> + <refnamediv> + <refname>strcmpi</refname> + <refpurpose> + compare character strings (case independent) + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = strcmpi(string_one, string_two)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>string_one</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>string_two</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>a matrix of integers.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = strcmpi(string_one, string_two)</code> returns an + integral value indicating the relationship between the strings. The two strings are compared in using the <emphasis role="bold">lexicographical order</emphasis>. + </para> + <para> + The value is <literal>0</literal> if <varname>string_one</varname> + is equal to <varname>string_two</varname> (case independently), + <literal>1</literal> if <varname>string_one</varname> is greater than <varname>string_two</varname> and <literal>-1</literal> else. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +TXT1 = ['scilab','SciLab';'Strcmp','STRcmp']; +TXT2 = ['ScIlAb','sciLab';'sTrCmP','StrCMP']; +strcmpi(TXT1,TXT2) +strcmpi(TXT1,'scilab') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="strcat">strcat</link> + </member> + <member> + <link linkend="strcmp">strcmp</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strcspn.xml b/modules/string/help/en_US/strcspn.xml new file mode 100755 index 000000000..059a212df --- /dev/null +++ b/modules/string/help/en_US/strcspn.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) 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="strcspn" xml:lang="en"> + <refnamediv> + <refname>strcspn</refname> + <refpurpose>get span until character in string</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = strcspn(string_one, string_two)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>string_one</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>string_two</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>a matrix.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = strcspn(string_one,string_two)</code> scans + <varname>string_one</varname> for the first occurrence of any of the + characters that are part of <varname>string_two</varname>, returning + the number of characters of <varname>string_one</varname> read + before this first occurrence. + </para> + <para> + <varname>string_two</varname> must have same dimensions than <varname>string_one</varname> or <varname>string_two</varname> + must be a string. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +strcspn("fcba73","1234567890") +strcspn(["fcba73","f7cba73"],"1234567890") +strcspn(["fcba73","f7cba73"],["312","34567890"]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="strspn">strspn</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strindex.xml b/modules/string/help/en_US/strindex.xml new file mode 100755 index 000000000..3c2b1f160 --- /dev/null +++ b/modules/string/help/en_US/strindex.xml @@ -0,0 +1,136 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strindex" xml:lang="en"> + <refnamediv> + <refname>strindex</refname> + <refpurpose> + search position of a character string in an other string + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis> + ind = strindex(haystack, needle, [flag]) + [ind, which] = strindex(haystack, needle, [flag]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>haystack</term> + <listitem> + <para> + a character string. The string where to search + occurrences of <varname>needle</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>needle</term> + <listitem> + <para> + a character string or character string vector. The + string(s) to search in <varname>haystack</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>ind</term> + <listitem> + <para>a vector of indexes.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>which</term> + <listitem> + <para>a vector of indexes.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>flag</term> + <listitem> + <para> + a string (<literal>"r"</literal> for regular expression). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <function>strindex</function> searches indexes where + <literal>needle(i)</literal> is found in <varname>haystack</varname>. + </para> + <para> + For each <literal>k</literal> it exist an <literal>i</literal> such + that <code>part(haystack,ind(k)+(0:length(needle(i))-1))</code> is + the same string than <literal>needle(i)</literal>. If + <varname>which</varname> argument is required it contains these + <literal>i</literal>. When using the third parameter <literal>"r"</literal>, the <varname>needle</varname> + should be a string of regular expression. And then <function>strindex</function> is going to + match it with <varname>haystack</varname> according to the regular express rules. + </para> + <para> + <function>strindex</function> without regular expression argument is + based on Knuth-Morris-Pratt algorithm. + </para> + <para> + This algorithm is more powerful than that used in Scilab 4.x. In + some special case, result can be different. + </para> + <para>Example:</para> + <para>// Scilab 5.x</para> + <para>-->[k,w]=strindex('aab',['a','ab'])</para> + <para>w = 1. 1. 2. k = 1. 2. 2.</para> + <para>// Scilab 4.x</para> + <para>-->[k,w]=strindex('aab',['a','ab'])</para> + <para>w = 1. 1. k = 1. 2.</para> + <para> + The rules of regular expression are similar to Perl language. For a + quick start, see <ulink url="http://perldoc.perl.org/perlrequick.html">http://perldoc.perl.org/perlrequick.html</ulink>. + For a more in-depth tutorial on, see <ulink url="http://perldoc.perl.org/perlretut.html">http://perldoc.perl.org/perlretut.html</ulink> + and for the reference page, see <ulink url="http://perldoc.perl.org/perlre.html">http://perldoc.perl.org/perlre.html</ulink> + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +k=strindex('SCI/demos/scicos','/') +k=strindex('SCI/demos/scicos','SCI/') +k=strindex('SCI/demos/scicos','!') +k=strindex('aaaaa','aa') +k=strindex('SCI/demos/scicos',['SCI','sci']) +[k,w]=strindex('1+3*abc/2.33',['+','-','*','/']) +k=strindex('2' ,'/2(]*)?$\1/' ,'r') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="strings">strings</link> + </member> + <member> + <link linkend="regexp">regexp</link> + </member> + <member> + <link linkend="strsubst">strsubst</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/string.xml b/modules/string/help/en_US/string.xml new file mode 100755 index 000000000..c12e645b5 --- /dev/null +++ b/modules/string/help/en_US/string.xml @@ -0,0 +1,146 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * Copyright (C) DIGITEO - 2012 - Allan CORNET + * + * 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="string" xml:lang="en"> + <refnamediv> + <refname>string</refname> + <refpurpose>conversion to string</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>string(x) + [out, in, text] = string(x) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>x</term> + <listitem> + <para> + a boolean, complex, real, integer, polynomial matrix, + an implicit size, a library or a function. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + The <function>string</function> function converts a matrix <varname>x</varname> into a matrix of strings. + </para> + <para> + If <varname>x</varname> is a function <code>[out, in, text] = string(x)</code> + returns three vectors of strings: <varname>out</varname> + is the vector of output variables, <varname>in</varname> is the vector of + input variables, and <varname>text</varname> is the (column) vector of the + source code of the function. + </para> + <para> + If <varname>x</varname> is a <literal>lib</literal> variable + (library), <varname>text</varname> is a character string column vector. The first element + contains the path of library file and the other the name of functions it + defines. + </para> + <para> + Character strings are defined as <literal>'string'</literal> + (between quotes) or <literal>"string"</literal> (between doublequotes); + matrices of strings are defined as usual constant matrices. + </para> + <para> + Concatenation of strings is made by the <literal>+</literal> + operation. + </para> + <para> + For complex, real, integer, polynomial matrix + <function>string</function> output is managed by <link linkend="format">format</link> function (see examples). + </para> + <para> + Note that string([]) returns []. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"> + string(rand(2, 2)) + + deff("y = mymacro(x)", "y = x + 1") + [out, in, text] = string(mymacro) + x = 123.356; + disp("Result is " + string(x)); + + disp("/" + string(~%t) + "/"); + disp("/" + string(%i+1) + "/"); + disp("/" + string(int16(-123)) + "/"); + disp("/" + string(1 + %s + %s^3) + "/"); + + string(corelib) + + v = format(); + disp(string(%pi)) + format(24); + disp(string(%pi)) + format(v(2)) + + string(1:4:$) + </programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="part">part</link> + </member> + <member> + <link linkend="length">length</link> + </member> + <member> + <link linkend="quote">quote</link> + </member> + <member> + <link linkend="evstr">evstr</link> + </member> + <member> + <link linkend="execstr">execstr</link> + </member> + <member> + <link linkend="strsubst">strsubst</link> + </member> + <member> + <link linkend="strcat">strcat</link> + </member> + <member> + <link linkend="strindex">strindex</link> + </member> + <member> + <link linkend="sci2exp">sci2exp</link> + </member> + <member> + <link linkend="format">format</link> + </member> + </simplelist> + </refsection> + <refsection> + <title>History</title> + <revhistory> + <revision> + <revnumber>5.4.0</revnumber> + <revremark> + implicit size type managed as input argument. + </revremark> + </revision> + </revhistory> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strings.xml b/modules/string/help/en_US/strings.xml new file mode 100755 index 000000000..e9265d8a1 --- /dev/null +++ b/modules/string/help/en_US/strings.xml @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strings"> + <refnamediv> + <refname>strings</refname> + <refpurpose>Scilab Object, character strings</refpurpose> + </refnamediv> + <refsection> + <title>Description</title> + <para> + Strings are defined as <code>'string'</code> (between quotes) or + <code>"string"</code> (between doublequotes); + matrices of strings are defined as usual constant matrices. + </para> + <para> + Concatenation of two strings is made by a <literal>+</literal>: <code>string1 + string2</code>. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +['this','is'; 'a 2x2','matrix'] +"matrix"=="mat"+"rix" + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="part">part</link> + </member> + <member> + <link linkend="length">length</link> + </member> + <member> + <link linkend="strcat">strcat</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/stripblanks.xml b/modules/string/help/en_US/stripblanks.xml new file mode 100755 index 000000000..a624e6006 --- /dev/null +++ b/modules/string/help/en_US/stripblanks.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) 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="stripblanks"> + <refnamediv> + <refname>stripblanks</refname> + <refpurpose> + strips / trims leading and trailing + blanks (and tabs) of strings + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>txt = stripblanks(txt[,tabs])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>txt</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>tabs</term> + <listitem> + <para> + a boolean, if <constant>%t</constant> then tabs are also stripped (default value is <constant>%f</constant>). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + The <function>stripblanks</function> function strips / trims leading and trailing blanks (and tabs) of strings. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +a=' 123 '; +'!'+a+'!' +'!'+stripblanks(a)+'!' +a=[' 123 ',' xyz'] +strcat(stripblanks(a)) + +a = msprintf("\t \tHello world!\t\t") +strcat(stripblanks(a,%f)+'?') +strcat(stripblanks(a,%t)+'?') + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strncpy.xml b/modules/string/help/en_US/strncpy.xml new file mode 100755 index 000000000..9adf2c37c --- /dev/null +++ b/modules/string/help/en_US/strncpy.xml @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strncpy"> + <refnamediv> + <refname>strncpy</refname> + <refpurpose>copy characters from strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = strncpy(str1, num)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str1</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>num</term> + <listitem> + <para> + an integer or a matrix of integers, maximum number of characters to be copied from source. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = strncpy(str1, num)</code> copies the first <varname>num</varname> characters of source <varname>str1</varname> to destination <varname>res</varname>. + </para> + <para> + <varname>num</varname> must have same dimensions than + <varname>str1</varname> or <varname>num</varname> must be an integer number. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +strncpy('scilab',3) +strncpy(['scilab','SciLab';'strncpy','strstr'],3) +strncpy(['scilab','SciLab';'strncpy','strstr'],[1,2;3,4]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="strcat">strcat</link> + </member> + <member> + <link linkend="strcmp">strcmp</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strrchr.xml b/modules/string/help/en_US/strrchr.xml new file mode 100755 index 000000000..cfd887775 --- /dev/null +++ b/modules/string/help/en_US/strrchr.xml @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strrchr"> + <refnamediv> + <refname>strrchr</refname> + <refpurpose> + find the last occurrence of a character in a string + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = strrchr(str1, char)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str1</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>char</term> + <listitem> + <para>a character or matrix of characters.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = strrchr(str1, char)</code> returns the last occurrence of character <varname>char</varname> in the string <varname>str1</varname>. + </para> + <para> + <varname>char</varname> must have same dimensions than + <varname>str1</varname> or only one character. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +strrchr('This is a sample string','s') +strrchr(['This is a sample string','in scilab'],'s') +strrchr(['This is a sample string','in scilab'],['s','a']) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="strchr">strchr</link> + </member> + <member> + <link linkend="strstr">strstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strrev.xml b/modules/string/help/en_US/strrev.xml new file mode 100755 index 000000000..6f41398a3 --- /dev/null +++ b/modules/string/help/en_US/strrev.xml @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strrev"> + <refnamediv> + <refname>strrev</refname> + <refpurpose>returns string reversed</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = strrev(str1)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str1</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = strrev(str1)</code> returns string reversed. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +rev = strrev('This is a simple string') +strrev(rev) +strrev(['This is a simple string','scilab']) + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strsplit.xml b/modules/string/help/en_US/strsplit.xml new file mode 100755 index 000000000..0ec182758 --- /dev/null +++ b/modules/string/help/en_US/strsplit.xml @@ -0,0 +1,161 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strsplit" xml:lang="en"> + <refnamediv> + <refname>strsplit</refname> + <refpurpose>split a string into a vector of strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis> + v = strsplit(str,ind) + [v, matched_separators] = strsplit(str) + [v, matched_separators] = strsplit(str, matrix_of_strings, limit) + [v, matched_separators] = strsplit(str, regexp_pattern, limit) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>a character string to split.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>ind</term> + <listitem> + <para> + a vector of strictly increasing indices in the interval + <literal>[1 length(str)-1]</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>v</term> + <listitem> + <para> + the resulting column vector of string (dimension ><literal>size(ind,'*')+1</literal>). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>matched_separators</term> + <listitem> + <para> + a column vector of the matched separators. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>matrix_of_strings</term> + <listitem> + <para> + a matrix of strings to search in <varname>str</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>regexp_pattern</term> + <listitem> + <para>a regular expression pattern.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>limit</term> + <listitem> + <para>maximum of limit elements.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>v= strsplit(str, ind)</code> splits the string + <varname>str</varname> into a vector of strings at the points given by the + indices in <varname>ind</varname> (after each characters pointed to by the + index in <varname>ind</varname>). + </para> + <para> + <code>strsplit(str)</code> returns same thing as + <code>strsplit(str,1:length(str)-1).</code> + </para> + <para> + <code>strsplit(str, regexp_pattern, limit)</code> returns an + column vector of strings, each of which is a substring of + <varname>str</varname> formed by splitting it on boundaries formed + by the case-sensitive regular expression pattern. + </para> + <para> + If there are <literal>n</literal> occurrences of pattern, the + returned array will contain <literal>n+1</literal> items. + </para> + <para> + For example, if there is no occurrence of pattern, an array with + only one element will be returned. Of course, this is also true if <varname>str</varname> is empty. + </para> + <para> + If <varname>limit</varname> is set, the returned array will contain + a maximum of limit elements with the last element containing the + whole rest of string. + </para> + <para> + <code>strsplit(str, matrix_of_strings, limit)</code> splits + <varname>str</varname> on any of elements. It allows to + split on different separators for users without regexp knowledge. + </para> + <para> + If <code>strsplit()</code> is called with a second output + argument, the column vector of the matched separators is returned. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +S='strsplit splits a string into a vector of strings'; +strsplit(S,[15 25 30]) +ind=strindex(S,' ') + +[r_1, r_2] = strsplit("abcd") + +[r_1, r_2] = strsplit("root:x:0:0:root:/root:/bin/bash",":",5) + +[r_1, r_2] = strsplit("abc,def:ijk,:lmo","/:|,/") + +[r_1, r_2] = strsplit("abc,def:ijk,:lmo",[":";","]) + +strsplit("abcdef2ghijkl3mnopqr6stuvw7xyz","/\d+/") + +[r_1, r_2] = strsplit("abcdef2ghijkl3mnopqr6stuvw7xyz","/\d+/",2) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="part"> part</link> + </member> + <member> + <link linkend="strcat"> strcat</link> + </member> + <member> + <link linkend="tokens"> tokens</link> + </member> + <member> + <link linkend="regexp"> regexp</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strspn.xml b/modules/string/help/en_US/strspn.xml new file mode 100755 index 000000000..885978c4a --- /dev/null +++ b/modules/string/help/en_US/strspn.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) 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="strspn" xml:lang="en"> + <refnamediv> + <refname>strspn</refname> + <refpurpose>get span of character set in string</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = strspn(str1, str2)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str1</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>str2</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>a matrix of character strings.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = strspn(str1, str2)</code> returns the length of the initial portion of <varname>str1</varname> which consists only of characters that are part of <varname>str2</varname>. + </para> + <para> + <varname>str1</varname> must have same dimensions as <varname>str2</varname> or <varname>str2</varname> must be 1x1 string. The output will be the same dimensions as <varname>str1</varname> in both cases. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +i = strspn("129th","1234567890"); +mprintf ("The length of initial number is %d.\n",i); +i = strspn(["129th","130th"],["1234567890","130t"]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="strcspn">strcspn</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strstr.xml b/modules/string/help/en_US/strstr.xml new file mode 100755 index 000000000..c171a97f5 --- /dev/null +++ b/modules/string/help/en_US/strstr.xml @@ -0,0 +1,81 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strstr" xml:lang="en"> + <refnamediv> + <refname>strstr</refname> + <refpurpose>locate substring</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = strstr(haystack, needle)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>haystack</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>needle</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = strstr(haystack, needle)</code> returns a string matrix + starting from where the first occurrence of + <varname>needle</varname> in <varname>haystack</varname> to the end + of <varname>haystack</varname>, or <literal>''</literal> if there + <varname>needle</varname> is not part of <varname>haystack</varname>. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +strstr('This is a simple string','simple') +strstr('This is a simple string','sample') +strstr(['This is a simple string','in scilab'],'is') +strstr(['This is a sample string','in scilab'],['a','scilab']) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="strrchr">strrchr</link> + </member> + <member> + <link linkend="strchr">strchr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strsubst.xml b/modules/string/help/en_US/strsubst.xml new file mode 100755 index 000000000..61c7806a2 --- /dev/null +++ b/modules/string/help/en_US/strsubst.xml @@ -0,0 +1,108 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strsubst" xml:lang="en"> + <refnamediv> + <refname>strsubst</refname> + <refpurpose> + substitute a character string by another in a character string + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis> + string_out = strsubst(string_in, searchStr, replaceStr) + string_out = strsubst(string_in, searchStr, replaceStr, [flag]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>string_in</term> + <listitem> + <para> + a matrix of character strings. The strings where to + search occurrences of <varname>searchStr</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>searchStr</term> + <listitem> + <para> + a character string. The string to search in + <varname>string_in</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>replaceStr</term> + <listitem> + <para> + a character string. The replacement string. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>string_out</term> + <listitem> + <para> + a matrix of character strings. The result of the + substitution on <varname>searchStr</varname> by + <varname>replaceStr</varname> in <varname>string_in</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>flag</term> + <listitem> + <para> + a character (<literal>"r"</literal> for regular expression). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + The <function>strsubst</function> function replaces all occurrences of + <varname>searchStr</varname> in <varname>string_in</varname> by + <varname>replaceStr</varname>. + </para> + <para> + When using the forth parameter <literal>"r"</literal>, the <varname>searchStr</varname> should be a + string of regular expression. And then <function>strsubst</function> is going to match it with + <varname>string_in</varname> and replace according to the regular expression rules. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +strsubst('SCI/demos/scicos','SCI','.') +strsubst('SCI/demos/scicos','/',' ') +strsubst('2' ,'/2(]*)?$\1/' ,'0','r') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="strings">strings</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strtod.xml b/modules/string/help/en_US/strtod.xml new file mode 100755 index 000000000..cd668f04e --- /dev/null +++ b/modules/string/help/en_US/strtod.xml @@ -0,0 +1,117 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strtod" xml:lang="en"> + <refnamediv> + <refname>strtod</refname> + <refpurpose>convert string to double</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis> + d = strtod(str [,decimalseparator]) + [d, endstr] = strtod(str [,decimalseparator]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para> + a character string or matrix of character strings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>decimalseparator</term> + <listitem> + <para> + the decimal separator chosen: "." (by default) or ",". + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>d</term> + <listitem> + <para> + a real or matrix of reals. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>endstr</term> + <listitem> + <para> + a character string or matrix of character strings (next + character in <varname>str</varname> after the numerical + value). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>[d, endstr] = strtod(str)</code> parses strings + <varname>str</varname> interpreting its content as a floating point + number and returns its value as a real. If <varname>str</varname> does not contain any numerical value then <varname>d</varname> equals <literal>Nan</literal>. + </para> + </refsection> + <refsection> + <title>Remarks</title> + <itemizedlist> + <listitem> + <para> + This function is based on the strtod C function which causes different behaviors on Windows and Linux. In fact, on Windows, it is possible to use + d or D for exponents, but it is not possible to use hexadecimal numbers. + </para> + </listitem> + <listitem> + <para> + Note that <literal>strtod("%inf")</literal> returns <literal>Nan</literal>. + </para> + </listitem> + </itemizedlist> + </refsection> + + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +strtod('123.556This is a sample real') +strtod('123,556This is a sample real', ",") +[d,endstr] = strtod('123.556This is a sample real') +strtod(['123.556This is a sample real','888.666 here']) +[d,endstr] =strtod(['123.556This is a sample real','888.666 here']) +[d,endstr] =strtod(['123.556This is a sample real','888,666 here'], ",") + ]]></programlisting> + </refsection> + <refsection> + <title>History</title> + <revhistory> + <revision> + <revnumber>5.5.0</revnumber> + <revremark> + New optional input: decimalseparator (SEP 97). + </revremark> + </revision> + <revision> + <revnumber>5.4.1</revnumber> + <revremark> + If <varname>str</varname> does not contain any numerical value then <varname>d</varname> equals <literal>Nan</literal> instead of <literal>0</literal> in previous versions. + </revremark> + </revision> + </revhistory> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/strtok.xml b/modules/string/help/en_US/strtok.xml new file mode 100755 index 000000000..5bcb806fc --- /dev/null +++ b/modules/string/help/en_US/strtok.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) 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="strtok"> + <refnamediv> + <refname>strtok</refname> + <refpurpose>split string into tokens</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>res = strtok(str, delimiters)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>a character string.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>delimiters</term> + <listitem> + <para>a character string.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>a character string.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = strtok(str, delimiters)</code> sequence of calls to + this function split <varname>str</varname> into tokens, which are + sequences of contiguous characters separated by any of the + characters that are part of <varname>delimiters</varname>. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +TOKENS = []; +token = strtok("A string of ,,tokens and some more tokens"," r,"); +TOKENS = [TOKENS,token]; +while( token <> '' ) + token = strtok(" r,"); + TOKENS = [TOKENS,token]; +end +disp(TOKENS); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="strrchr">strrchr</link> + </member> + <member> + <link linkend="strchr">strchr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/tokenpos.xml b/modules/string/help/en_US/tokenpos.xml new file mode 100755 index 000000000..d278f49f4 --- /dev/null +++ b/modules/string/help/en_US/tokenpos.xml @@ -0,0 +1,85 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="tokenpos"> + <refnamediv> + <refname>tokenpos</refname> + <refpurpose> + returns the tokens positions in a character string + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>kdf = tokenpos(str [,delimiter])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para> + a character string. The string where to search the tokens. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>delimiter</term> + <listitem> + <para> + (optional) a character or a vector of characters. The tokens delimiters. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>kdf</term> + <listitem> + <para> + a two column matrix, first column gives the index of the + beginning of the tokens, the second gives the index of + the last character of the tokens. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>kdf = tokenpos(str [,delimiter])</code> searches the tokens + included in the string <varname>str</varname>. The + <varname>delimiter</varname> default value is <literal>[" ",<Tab>]</literal> + where <literal><Tab></literal> stands for + <code>ascii(9)</code>. It returns the indices of the first and last + characters of each found tokens. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +str = 'This is a character string'; +kdf = tokenpos(str) +first = part(str, kdf(1,1):kdf(1,2)) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="strindex">strindex</link> + </member> + <member> + <link linkend="tokens">tokens</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/en_US/tokens.xml b/modules/string/help/en_US/tokens.xml new file mode 100755 index 000000000..bce3d9c41 --- /dev/null +++ b/modules/string/help/en_US/tokens.xml @@ -0,0 +1,81 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="tokens"> + <refnamediv> + <refname>tokens</refname> + <refpurpose>returns the tokens of a character string</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>T = tokens(str [,delimiter])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para> + a character string. The string where to search the tokens. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>delimiter</term> + <listitem> + <para> + (optional) a character or a vector of characters. The tokens delimiters. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>T</term> + <listitem> + <para> + a column vector of found tokens. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>T = tokens(str [,delimiter]) </code> searches the tokens + included in the string <varname>str</varname>. The + <varname>delimiter</varname> default value is <literal>[" ",<Tab>]</literal> + where <literal><Tab></literal> stands for <code>ascii(9)</code>. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +tokens('This is a character string') + +tokens('SCI/demos/scicos','/') + +tokens('y=a+b*2',['=','+','*']) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="strindex">strindex</link> + </member> + <member> + <link linkend="tokenpos">tokenpos</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/fr_FR/addchapter.sce b/modules/string/help/fr_FR/addchapter.sce new file mode 100755 index 000000000..b4d068841 --- /dev/null +++ b/modules/string/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("Chaînes de caractères",SCI+"/modules/string/help/fr_FR",%T); + diff --git a/modules/string/help/fr_FR/asciimat.xml b/modules/string/help/fr_FR/asciimat.xml new file mode 100755 index 000000000..4f43731b5 --- /dev/null +++ b/modules/string/help/fr_FR/asciimat.xml @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 2002-2004 - INRIA - Vincent COUVERT + * + * 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="fr" xml:id="asciimat"> + <refnamediv> + <refname>asciimat</refname> + <refpurpose>conversion d'une matrice de chaînes ASCII</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis> + a = asciimat(txt) + txt = asciimat(a) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Paramètres</title> + <variablelist> + <varlistentry> + <term>txt</term> + <listitem> + <para>chaîne de caractères ou matrice de chaînes</para> + </listitem> + </varlistentry> + <varlistentry> + <term>a</term> + <listitem> + <para>vecteur ou matrice de codes ASCII</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + Cette fonction convertit une chaîne de caractères Scilab en codes ASCII ou une matrice de codes ASCII en chaîne de caractères Scilab. + La valeur retournée est une matrice ayant le même nombre de lignes que l'entrée, + ce qui n'est pas le cas de la fonction <function>ascii</function>. + </para> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="ascii">ascii</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/fr_FR/eval.xml b/modules/string/help/fr_FR/eval.xml new file mode 100755 index 000000000..8a19e9908 --- /dev/null +++ b/modules/string/help/fr_FR/eval.xml @@ -0,0 +1,37 @@ +<?xml version="1.0" encoding="UTF-8"?> +<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="eval" xml:lang="fr"> + <refnamediv> + <refname>eval</refname> + <refpurpose>évaluation d'une matrice de chaînes de caractères</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>[H]= eval(Z)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para>renvoie le résultat de l'évaluation d'une matrice de chaînes de + caractères <literal>Z</literal>. + </para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +a=1; +b=2; +Z=['a','sin(b)']; +eval(Z) // renvoie la matrice [1,0.909]; + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="evstr">evstr</link> + </member> + <member> + <link linkend="execstr">execstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/fr_FR/evstr.xml b/modules/string/help/fr_FR/evstr.xml new file mode 100755 index 000000000..5a7555e36 --- /dev/null +++ b/modules/string/help/fr_FR/evstr.xml @@ -0,0 +1,105 @@ +<?xml version="1.0" encoding="UTF-8"?> +<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="evstr" xml:lang="fr"> + <refnamediv> + <refname>evstr</refname> + <refpurpose>évaluation d'une expression</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>H=evstr(Z) + [H,ierr]=evstr(Z) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Paramètres</title> + <variablelist> + <varlistentry> + <term>Z</term> + <listitem> + <para> + matrice de chaînes de caractères <literal>M</literal> ou + <literal>list(M,Subexp)</literal> + </para> + <variablelist> + <varlistentry> + <term>M</term> + <listitem> + <para>matrice de chaînes de caractères</para> + </listitem> + </varlistentry> + <varlistentry> + <term>Subexp</term> + <listitem> + <para>vecteur de chaînes de caractères</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + <varlistentry> + <term>H</term> + <listitem> + <para>matrice</para> + </listitem> + </varlistentry> + <varlistentry> + <term>ierr</term> + <listitem> + <para>entier, 0 ou numéro de l'erreur</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para>Renvoie le résultat de l'évaluation de la matrice de chaînes de + caractères <literal>M</literal>. Chaque élément de la matrice doit être + une expression Scilab valide. + </para> + <para> + Si l'évaluation d'un terme de <literal>M</literal> conduit à une + erreur, la syntaxe habituelle <literal>H=evstr(M)</literal>, déclenche le + message d'erreur. Dans la syntaxe <literal>[H,ierr]=evstr(M)</literal> + aucun message d'erreur n'est produit, mais le numéro de l'erreur est + renvoyé dans <literal>ierr</literal>. + </para> + <para> + Si <literal>Z</literal> est une liste, <literal>Subexp</literal> est + un vecteur de chaînes de caractères qui définit des sous-expressions qui + sont évaluées avant <literal>M</literal>. Ces sous-expressions doivent + être référencées par l'expression <literal>%(k)</literal> dans + <literal>M</literal>, où <literal>k</literal> est la position de la + sous-expression dans la liste <literal>Subexp</literal>. + </para> + <para>evstr('a=1') n'est pas valide (utiliser pour cela + <literal>execstr</literal>). + </para> + <para>Nan et Nan seront interpretés comme %nan.</para> + <para>Inf sera interpreté comme %inf</para> + <note> + Note : <varname>Z</varname> ne doit pas comporter de marques de suite (..). + </note> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +a = 1; +b = 2; +Z = ['a','b']; +evstr(Z) +a = 1; +b = 2; +Z = list(['%(1)','%(1)-%(2)'],['a+1','b+1']); +evstr(Z) +evstr('NaN'), evstr('Inf') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="execstr">execstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/fr_FR/isnum.xml b/modules/string/help/fr_FR/isnum.xml new file mode 100755 index 000000000..9552ae7f6 --- /dev/null +++ b/modules/string/help/fr_FR/isnum.xml @@ -0,0 +1,95 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- +* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +* Copyright (C) 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" +xml:lang="fr" xml:id="isnum"> + <refnamediv> + <refname>isnum</refname> + <refpurpose>teste si une chaîne de caractères représente un nombre</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>res = isnum(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Paramètres</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para> + une matrice de chaînes de caractères. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>une matrice de booléens.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <code>res = isnum(str)</code> retourne <constant>%t</constant> si + <varname>str</varname> représente un nombre. + </para> + <para> + <code>isnum</code> ne supporte pas les "opérations", mais seulement des scalaires purs. + Par exemple, <code>isnum("1+2*3")</code> retourne <code>%f</code>. + Les nombres complexes ne sont pas conernés par cela, + puisqu'un nombre complexe est défini par l'addition de deux parties. + </para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +isnum(['1' , .. + '-1.23' , .. + '+1e+23' , .. + '1d+23' , .. + 'A' , .. + '%e' , .. + '%pi' , .. + '%nan' , .. + 'Nan' , .. + '%inf' , .. + 'Inf' , .. + '1+%i*2' , .. + '%eps-%eps*%i', .. + '%inf+Nan*%i' ]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="isletter">isletter</link> + </member> + <member> + <link linkend="isdigit">isdigit</link> + </member> + <member> + <link linkend="isalphanum">isalphanum</link> + </member> + <member> + <link linkend="evstr">evstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/fr_FR/string.xml b/modules/string/help/fr_FR/string.xml new file mode 100755 index 000000000..f759376a4 --- /dev/null +++ b/modules/string/help/fr_FR/string.xml @@ -0,0 +1,128 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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: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="string" xml:lang="fr"> + <refnamediv> + <refname>string</refname> + <refpurpose>conversion en chaîne de caractères</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>string(x) + [out, in, text] = string(x) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Paramètres</title> + <variablelist> + <varlistentry> + <term>x</term> + <listitem> + <para>Booléen, complexe, réel, entier, polynôme matrice, + bibliotheque ou fonction + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para>Convertit une matrice en matrice de chaînes de caractères.</para> + <para> + Si <literal>x</literal> est une fonction <literal>[out, in, text] = + string(x) + </literal> + retourne 3 vecteurs de chaînes de caractères : + <literal>out</literal> est le vecteur des variables de sortie, + <literal>in</literal> est le vecteur des variables d'entrée, et + <literal>text</literal> est le vecteur colonne du code source de la + fonction. + </para> + <para> + Si <literal>x</literal> est une variable bibliotheque + <literal>lib</literal>, text est un vecteur colonne de chaînes de + caractères. Le premier élément contient le chemin de la bibliothèque et + l'autre élément le nom des fonctions qui sont définies dans cette + bibliothèque. + </para> + <para>Les chaînes de caractères sont définies de la façon suivant, + <literal>'string'</literal> (entre quotes) ou <literal>"string"</literal> + (entre double quotes); les matrices de chaînes de caractères sont définies + comme des matrices constantes normales. + </para> + <para>La concaténation des chaînes de caractères est effectuée par + l'opérateur <literal>+</literal>. + </para> + <para> + pour les types Booléen, complexe, réel, entier, polynôme matrice le texte issu de <literal>string</literal> est dependant de la fonction <link linkend="format">format</link> (voir exemples). + </para> + <para> + Notez que string([]) renvoie []. + </para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +string(rand(2, 2)) + +deff("y = mymacro(x)", "y = x + 1") +[out, in, text] = string(mymacro) +x = 123.356; +disp("Result is " + string(x)); + +disp("/" + string(~%t) + "/"); +disp("/" + string(%i+1) + "/"); +disp("/" + string(int16(-123)) + "/"); +disp("/" + string(1 + %s + %s^3) + "/"); + +string(corelib) + +v = format(); +disp(string(%pi)) +format(24); +disp(string(%pi)) +format(v(2)) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="part">part</link> + </member> + <member> + <link linkend="length">length</link> + </member> + <member> + <link linkend="quote">quote</link> + </member> + <member> + <link linkend="evstr">evstr</link> + </member> + <member> + <link linkend="execstr">execstr</link> + </member> + <member> + <link linkend="strsubst">strsubst</link> + </member> + <member> + <link linkend="strcat">strcat</link> + </member> + <member> + <link linkend="strindex">strindex</link> + </member> + <member> + <link linkend="sci2exp">sci2exp</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ja_JP/addchapter.sce b/modules/string/help/ja_JP/addchapter.sce new file mode 100755 index 000000000..0a891d0da --- /dev/null +++ b/modules/string/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("Strings",SCI+"/modules/string/help/ja_JP",%T); + diff --git a/modules/string/help/ja_JP/ascii.xml b/modules/string/help/ja_JP/ascii.xml new file mode 100755 index 000000000..884735714 --- /dev/null +++ b/modules/string/help/ja_JP/ascii.xml @@ -0,0 +1,132 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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: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="ascii" xml:lang="ja"> + + <refnamediv> + + <refname>ascii</refname> + + <refpurpose>文字列をアスキー変換する</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>a=ascii(txt) + + txt=ascii(a) + + </synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>txt</term> + + <listitem> + + <para>文字列または文字列の行列.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>a</term> + + <listitem> + + <para>整数アスキーコードのベクトル</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + この関数はScilab文字列をアスキーコード + + (最初の127個のコードはASCIIです)またはアスキーコードののベクトルに変換します. + + もしくは,アスキーコードのベクトルをScilab文字列に変換します. + + </para> + + <para> + + <literal>txt</literal> が文字列の行列の場合, + + <literal>ascii(txt)</literal> は + + <literal>ascii(strcat(txt))</literal>と等価です + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +ascii(["hello";"world"]) +ascii("scilab") +ascii([115 99 105 108 97 98]) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="code2str">code2str</link> + + </member> + + <member> + + <link linkend="str2code">str2code</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/asciimat.xml b/modules/string/help/ja_JP/asciimat.xml new file mode 100755 index 000000000..ece5a041c --- /dev/null +++ b/modules/string/help/ja_JP/asciimat.xml @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 2004-2007 - INRIA - Vincent COUVERT + * + * 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="asciimat"> + <refnamediv> + <refname>asciimat</refname> + <refpurpose>文字列行列アスキー変換</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis> + a = asciimat(txt) + txt = asciimat(a) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>引数</title> + <variablelist> + <varlistentry> + <term>txt</term> + <listitem> + <para> + 文字列または文字列の行列. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>a</term> + <listitem> + <para> + 整数アスキーコードのベクトルまたは行列. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>説明</title> + <para> + この関数は,Scilab文字列をアスキーコードに変換または + アスキーコードの行列をScilab文字列に変換します. + 出力は,<function>ascii</function>の場合と異なり, + 入力と同じ行数を有する行列です. + </para> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="ascii">ascii</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ja_JP/blanks.xml b/modules/string/help/ja_JP/blanks.xml new file mode 100755 index 000000000..1275dfb5d --- /dev/null +++ b/modules/string/help/ja_JP/blanks.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) 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="blanks"> + + <refnamediv> + + <refname>blanks</refname> + + <refpurpose>空白文字からなる文字列を作成する</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>txt=blanks(n)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>txt</term> + + <listitem> + + <para>文字列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>n</term> + + <listitem> + + <para>空白の数</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>D説明</title> + + <para>blanks(n) はn個の空白からなる文字列です.</para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +disp(['xxx' blanks(20) 'yyy']) + ]]></programlisting> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/char.xml b/modules/string/help/ja_JP/char.xml new file mode 100755 index 000000000..b9feec967 --- /dev/null +++ b/modules/string/help/ja_JP/char.xml @@ -0,0 +1,194 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 2008 - INRIA - Farid BELAHCENE + * + * 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="char" xml:lang="ja"> + + <refnamediv> + + <refname>char</refname> + + <refpurpose>char 関数</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis> + + y = char(x) + + y = char(st1, st2, st3,....) + + </synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>x</term> + + <listitem> + + <para>文字列配列のセル, またはアスキーコードの配列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>st1,st2,st3</term> + + <listitem> + + <para>文字列配列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>y:</term> + + <listitem> + + <para>文字列(列)ベクトル</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <emphasis role="bold">入力引数が一つの場合 :</emphasis> + + </para> + + <para> + + 文字列配列<varname>x</varname>のセルを指定すると, この関数は + + 文字列セルの要素を行とする文字列ベクトル <varname>y</varname> + + を返します. + + </para> + + <para> + + アスキーコード<varname>x</varname>の配列を指定すると, + + この関数はそのアスキーコードに対応する文字列の配列 <varname>y</varname> + + を返します. + + <varname>x</varname>の次元が <literal>[n1, n2, n3, n4,...]</literal>の場合, + + 返り値は2番目の次元以外は入力値と同じ大きさを有します. + + すなわち,<varname>y</varname>の次元は, + + <literal>[n1, n3, n4,...]</literal>となります. + + </para> + + <para> + + <emphasis role="bold">入力引数が1より多い場合 :</emphasis> + + </para> + + <para> + + 文字列配列 + + <literal>st1,st2,st3,...</literal>を指定すると, この関数は, + + <literal>st1,st2,st3,...</literal>を結合した要素が行となる + + 文字列のベクトルを返します. + + ベクトル <varname>y</varname> においては, + + 文字列<literal>sti</literal>の末尾を空白で埋めることにより, + + <literal>sti</literal>の最長のものと同じ長さにしています. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +//Example with a hypermatrix of ASCII codes : +x=hypermat([4,2,3],61:84); +y=char(x) +size(x) +size(y) +//Example with more than one argument : +st1="zeros"; +st2=["one","two"]; +st3=["three"]; +y=char(st1,st2,st3) +size(y) +//all strings rows are completed by 'blanks' to have the same length : 6 +length(y) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="ascii">ascii</link> + + </member> + + <member> + + <link linkend="asciimat">asciimat</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/convstr.xml b/modules/string/help/ja_JP/convstr.xml new file mode 100755 index 000000000..953099ae2 --- /dev/null +++ b/modules/string/help/ja_JP/convstr.xml @@ -0,0 +1,127 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="convstr"> + + <refnamediv> + + <refname>convstr</refname> + + <refpurpose>大文字小文字変換</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>[y] = convstr(str, [flag])</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str, y</term> + + <listitem> + + <para>文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>flag</term> + + <listitem> + + <para>文字オプションで指定可能な値は以下のとおり</para> + + <variablelist> + + <varlistentry> + + <term>'u'</term> + + <listitem> + + <para>大文字に変換</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>'l'</term> + + <listitem> + + <para>小文字に変換</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <function>convstr</function>関数は,文字列の行列 + + <varname>str</varname>を + + 小文字に変換(<varname>flag</varname> = <literal>"l"</literal>の場合; + + デフォルト値)または + + 大文字(<varname>flag</varname> = <literal>"u"</literal>の場合)に変換します. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +A=['this','is';'my','matrix']; +convstr(A,'u') + ]]></programlisting> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/emptystr.xml b/modules/string/help/ja_JP/emptystr.xml new file mode 100755 index 000000000..7754decb1 --- /dev/null +++ b/modules/string/help/ja_JP/emptystr.xml @@ -0,0 +1,162 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="emptystr"> + + <refnamediv> + + <refname>emptystr</refname> + + <refpurpose>長さ0の文字列</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>s = emptystr() + + s = emptystr(a) + + s = emptystr(m, n) + + </synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>a</term> + + <listitem> + + <para> 大きさ m x nの行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>s</term> + + <listitem> + + <para>文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>m,n</term> + + <listitem> + + <para>整数</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + 長さ0の文字列の行列を返します. + + </para> + + <para> + + 入力引数を指定しない場合,長さ0の文字列を返します. + + </para> + + <para> + + 入力引数に行列を指定した場合,同じ大きさの長さ0の文字列行列を返します. + + </para> + + <para> + + 2個の整数を引数に指定した場合, + + <varname>m</varname> <literal>x</literal> <varname>n</varname> + + の長さ0の文字列行列を返します. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +x=emptystr(); +for k=1:10 + x = x + ',' + string(k) + emptystr(1,k) + string(k) +end + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="part">part</link> + + </member> + + <member> + + <link linkend="length">length</link> + + </member> + + <member> + + <link linkend="string">string</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/eval.xml b/modules/string/help/ja_JP/eval.xml new file mode 100755 index 000000000..3c70a1d70 --- /dev/null +++ b/modules/string/help/ja_JP/eval.xml @@ -0,0 +1,105 @@ +<?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="eval" xml:lang="ja"> + + <refnamediv> + + <refname>eval</refname> + + <refpurpose>文字列の行列を評価する</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>[H] = eval(Z)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>Z</term> + + <listitem> + + <para>文字列の行列.</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <function>eval</function>関数は, + + 文字列の行列<varname>Z</varname>を評価したものを返します. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +a=1; +b=2; +Z=['a','sin(b)']; +eval(Z) //行列 [1, 0.909]を返します; + ]]></programlisting> + + </refsection> + + <refsection> + + <title>S参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="evstr">evstr</link> + + </member> + + <member> + + <link linkend="execstr">execstr</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/evstr.xml b/modules/string/help/ja_JP/evstr.xml new file mode 100755 index 000000000..4756b07e6 --- /dev/null +++ b/modules/string/help/ja_JP/evstr.xml @@ -0,0 +1,236 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<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="evstr" xml:lang="ja"> + + <refnamediv> + + <refname>evstr</refname> + + <refpurpose>式を評価する</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis> + + H = evstr(Z) + + [H, ierr] = evstr(Z) + + </synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>Z</term> + + <listitem> + + <para> + + 文字列の行列 <varname>M</varname> または + + <code>list(M,Subexp)</code> + + </para> + + <variablelist> + + <varlistentry> + + <term>M</term> + + <listitem> + + <para>文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>Subexp</term> + + <listitem> + + <para>文字列のベクトル</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>H</term> + + <listitem> + + <para>行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>ierr</term> + + <listitem> + + <para>整数, エラーインジケータ</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + 文字列の行列<varname>M</varname>を評価した結果を返します. + + 行列の各要素は有効なScilab式を定義している必要があります. + + </para> + + <para> + + <varname>M</varname>式の評価でエラーが発生した場合, + + 戻り値が1つの版,<code>H = evstr(M)</code>,では通常と同様に + + エラーを発生します. + + 一方,戻り値が2つの版,<code>[H,ierr] = evstr(M)</code>, + + はエラーを発生しませんが,<varname>ierr</varname>にエラー番号が + + 返されます. + + </para> + + <para> + + <varname>Z</varname> がリストの場合, <varname>Subexp</varname> は + + 文字列のベクトルとなり,<varname>M</varname>を評価する前に + + 評価されるsub_expressionsを定義します. + + これらのsub_expressionsは,<varname>M</varname>の中では + + <literal>%(k)</literal>として参照する必要があります. + + ただし,<literal>k</literal>は<varname>Subexp</varname>における + + sub-expressionのインデックスです. + + </para> + + <para> + + <code>evstr('a = 1')</code> は有効ではありません + + (代わりに<function>execstr</function>を使用してください). + + </para> + + <para> + <literal>Nan</literal>, <literal>NaN</literal> + + は <constant>%nan</constant> と評価されます. + </para> + + <para> + + <literal>Inf</literal> は <constant>%inf</constant> と評価されます. + + </para> + + <note> + + <varname>Z</varname> は,継続記号 (..)で分解できない + + ことに注意してください. + + </note> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"> + + a = 1; b = 2; + + Z = ['a', 'b'] ; + + evstr(Z) + + + + Z = list(['%(1)','%(1)-%(2)'],['a+1','b+1']); + + evstr(Z) + + + + evstr('NaN'), evstr('Inf') + + + + //The two return values version + + [H, ierr] = evstr(Z) // no error + + Z = ['a', 'b', 'c'] ;// the variable c is undefined + + [H, ierr] = evstr(Z) // error 4: Undefined variable: c + + </programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="execstr">execstr</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/grep.xml b/modules/string/help/ja_JP/grep.xml new file mode 100755 index 000000000..4091326a2 --- /dev/null +++ b/modules/string/help/ja_JP/grep.xml @@ -0,0 +1,242 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="grep" xml:lang="ja"> + + <refnamediv> + + <refname>grep</refname> + + <refpurpose>文字列のベクトルの中で指定した文字列に一致するかどうかを調べる</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>row=grep(haystack,needle ) + + [row,which]=grep(haystack,needle ) + + row=grep(haystack,needle ,[flag]) + + [row,which]=grep(haystack,needle ,[flag]) + + </synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>haystack</term> + + <listitem> + + <para>文字列の行ベクトル.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>needle</term> + + <listitem> + + <para>文字列または文字列の行ベクトル. + + <varname>haystack</varname>の中で文字列を探します. + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>row</term> + + <listitem> + + <para>インデックスのベクトル: + + 一致するものが見つかった行, + + または一致するものが見つからなかった場合は空の行列. + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>which</term> + + <listitem> + + <para>インデックスのベクトル: + + 見つかったneedle文字列のインデックスまたは + + 一致するものがなかった場合は空の行列. + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>flag</term> + + <listitem> + + <para> + 文字 (正規表現の場合は<literal>"r"</literal>) + </para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + + + <varname>haystack</varname>の各エントリについて, + + <function>grep</function>は少なくとも + + <varname>needle</varname>の中の一つの文字列が + + 部分文字列に一致するかどうかを探します. + + 最低でも一致するものが一つある + + <varname>haystack</varname>のエントリのインデックスが + + 出力引数<varname>row</varname>に返されます. + + オプションの出力引数<varname>which</varname>は, + + <varname>needle</varname>の最初に見つかった文字列のインデックスを + + 指定します. + + </para> + + <para> + + 3番目のパラメータに<varname>flag</varname><literal>="r"</literal> + + を指定した場合, + + <varname>needle</varname>に正規表現文字列を指定できます. + + この場合, <function>grep</function>は<varname>needle</varname> + + を正規表現として使用し,正規表現の規則に基づいて + + <varname>haystack</varname>とこの文字列を比較します. + + 正規表現に関する詳細については関数<link linkend="regexp">regexp</link> + + を参照ください. + + </para> + + </refsection> + + <refsection> + + <title>例 #1</title> + + <para> + + 以下の例では,<varname>txt</varname>変数に保存されている + + テキスト中で,1つまたは2つの文字列を探します. + + </para> + + <programlisting role="example"><![CDATA[ +txt=['find matches of a string in a vector of strings' + 'search position of a character string in an other string' + 'Compare Strings']; +grep(txt,'strings') +grep(txt,['strings' 'Strings']) +[r,w]=grep(txt,['strings' 'Strings']) + ]]></programlisting> + + </refsection> + + <refsection> + + <title>例 #2</title> + + <para>以下の例では, 正規表現検索を行ないます.</para> + + <programlisting role="example"><![CDATA[ +str = ["hat";"cat";"hhat";"chat";"hcat";"ccchat";"at";"dog"] +grep(str,'/[hc]+at/','r') +grep(str,'/[hc]?at/','r') +grep(str,'/cat|dog/','r') + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="strindex">strindex</link> + + </member> + + <member> + + <link linkend="regexp">regexp</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/isalphanum.xml b/modules/string/help/ja_JP/isalphanum.xml new file mode 100755 index 000000000..f3f51a778 --- /dev/null +++ b/modules/string/help/ja_JP/isalphanum.xml @@ -0,0 +1,123 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="isalphanum"> + + <refnamediv> + + <refname>isalphanum</refname> + + <refpurpose>文字列の文字がアルファベットまたは数字であるかどうかを調べる</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>res = isalphanum(str)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str</term> + + <listitem> + + <para>文字列.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>論理値行列.</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = isalphanum(str)</code>は <varname>str</varname> + + と同じ大きさの配列を返します. + + この配列の要素は,対応する<varname>str</varname> + + の要素がアルファベットまたは数字である + + 場合に論理値 <constant>%t</constant> (true), + + そうでない場合は <constant>%f</constant> (false) を返します. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +s = 'A1,B2,C3'; +isalphanum(s) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="isletter">isletter</link> + + </member> + + <member> + + <link linkend="isdigit">isdigit</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/isascii.xml b/modules/string/help/ja_JP/isascii.xml new file mode 100755 index 000000000..8cbb771ba --- /dev/null +++ b/modules/string/help/ja_JP/isascii.xml @@ -0,0 +1,119 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="isascii"> + + <refnamediv> + + <refname>isascii</refname> + + <refpurpose>文字が7ビットUS-ASCII文字であるかどうかを確認する</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>res = isascii(str)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str</term> + + <listitem> + + <para>文字列または整数の配列.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>論理値行列.</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = isascii(str)</code>は, + + <varname>str</varname>のエントリが + + 0および8進数表現で0177の間の7ビットUS-ASCII文字コード + + (または<varname>str</varname>のエントリが7ビットUS-ASCII文字列) + + の場合に<constant>%t</constant> (TRUE), + + それ以外の場合に <constant>%f</constant> (FALSE). + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +letters = [115. 99. 105. 108. 97. 98.] +isascii(letters) +ascii(letters) +isascii('scilab') + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="isalphanum">isalphanum</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/isdigit.xml b/modules/string/help/ja_JP/isdigit.xml new file mode 100755 index 000000000..aec9ecbc5 --- /dev/null +++ b/modules/string/help/ja_JP/isdigit.xml @@ -0,0 +1,127 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="isdigit"> + + <refnamediv> + + <refname>isdigit</refname> + + <refpurpose>文字列の文字が0と9の間の数値であるかどうかを調べる</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>res = isdigit(str)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str</term> + + <listitem> + + <para>文字列.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>論理値の行列.</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = isdigit(str)</code> は, + + <varname>str</varname>と同じ大きさの配列を返します. + + 配列の要素は,対応する<varname>str</varname>の要素が数値の場合に + + 論理値<constant>%t</constant> (TRUE), + + それ以外の場合に論理値<constant>%f</constant> (FALSE)となります. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +s = 'A1,B2,C3'; +isdigit(s) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="isalphanum">isalphanum</link> + + </member> + + <member> + + <link linkend="isletter">isletter</link> + + </member> + + <member> + + <link linkend="isnum">isnum</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/isletter.xml b/modules/string/help/ja_JP/isletter.xml new file mode 100755 index 000000000..813f28d9b --- /dev/null +++ b/modules/string/help/ja_JP/isletter.xml @@ -0,0 +1,121 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="isletter"> + + <refnamediv> + + <refname>isletter</refname> + + <refpurpose>文字列の文字がアルファベット文字であるかどうかを調べる</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>res = isletter(str)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str</term> + + <listitem> + + <para>文字列.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>論理値の行列.</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = isletter(str)</code>は, + + <varname>str</varname>と同じ大きさの配列を返します. + + 配列の要素は,対応する <varname>str</varname>の要素が + + アルファベット文字の場合に論理値<constant>%t</constant> (TRUE), + + それ以外の場合に論理値<constant>%f</constant> (FALSE)となります. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +s = 'A1,B2,C3'; +isletter(s) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="isalphanum">isalphanum</link> + + </member> + + <member> + + <link linkend="isdigit">isdigit</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/isnum.xml b/modules/string/help/ja_JP/isnum.xml new file mode 100755 index 000000000..2a14214c5 --- /dev/null +++ b/modules/string/help/ja_JP/isnum.xml @@ -0,0 +1,155 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="isnum"> + + <refnamediv> + + <refname>isnum</refname> + + <refpurpose>文字列が数字であるかどうかを調べる</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>res = isnum(str)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str</term> + + <listitem> + + <para>文字列または文字列の行列.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>論理値の行列.</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = isnum(str)</code>は, + + <varname>str</varname>が数値を表す場合に<constant>%t</constant> + + を返します. + + </para> + + <para> + + <code>isnum</code> は "演算"を処理せずに, + + スカラー数値のみを扱います. + + 例えば, <code>isnum("1+2*3")</code> は <code>%f</code>を返します. + + 複素数は2つの部分の加算として定義されるため, + + 対応していません. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +isnum(['1' , .. + '-1.23' , .. + '+1e+23' , .. + '1d+23' , .. + 'A' , .. + '%e' , .. + '%pi' , .. + '%nan' , .. + 'Nan' , .. + '%inf' , .. + 'Inf' , .. + '1+%i*2' , .. + '%eps-%eps*%i', .. + '%inf+Nan*%i' ]) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="isletter">isletter</link> + + </member> + + <member> + + <link linkend="isdigit">isdigit</link> + + </member> + + <member> + + <link linkend="isalphanum">isalphanum</link> + + </member> + + <member> + + <link linkend="evstr">evstr</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/justify.xml b/modules/string/help/ja_JP/justify.xml new file mode 100755 index 000000000..bb84d87af --- /dev/null +++ b/modules/string/help/ja_JP/justify.xml @@ -0,0 +1,173 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="justify"> + + <refnamediv> + + <refname>justify</refname> + + <refpurpose>文字配列を整列</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>Tj = justify(T, opt)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>T</term> + + <listitem> + + <para>文字列の行列.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>Tj</term> + + <listitem> + + <para>文字列の行列. 揃えられた結果</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>opt</term> + + <listitem> + + <para>文字オプション,以下の値を指定できます:</para> + + <variablelist> + + <varlistentry> + + <term>'r'または'right'</term> + + <listitem> + + <para>右揃え</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>'l'または'left' </term> + + <listitem> + + <para>左揃え</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>'c'または'center' </term> + + <listitem> + + <para>中央揃え</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <function>justify</function>関数は, + + 指定したオプション<varname>opt</varname>に基づき + + 文字列の行列の列を整列します. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +t=['1234','x','adfdfgdfghfgj' + '1','354556','dgf' + 'sdfgd','','sdfsf']; +justify(t,'l') +justify(t,'c') +justify(t,'r') + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="length">length</link> + + </member> + + <member> + + <link linkend="part">part</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/length.xml b/modules/string/help/ja_JP/length.xml new file mode 100755 index 000000000..bca3af3d2 --- /dev/null +++ b/modules/string/help/ja_JP/length.xml @@ -0,0 +1,118 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="length" xml:lang="ja"> + <refnamediv> + <refname>length</refname> + <refpurpose>オブジェクトの長さ</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>n=length(M)</synopsis> + </refsynopsisdiv> + <refsection> + <title>引数</title> + <variablelist> + <varlistentry> + <term>M</term> + <listitem> + <para>行列 (通常または多項式または文字列) または + リスト + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>n</term> + <listitem> + <para>整数または整数行列</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>説明</title> + <para> + 通常または多項式の行列の場合, <literal>n</literal>は + <literal>M</literal>の行の数に列の数を乗じた整数になります. + (<literal>M</literal>が論理値行列の場合にも有効) + </para> + <para>文字列からなる行列の場合 (および部分的に文字列の場合) + <literal>length</literal>は, + 文字列の行列<literal>M</literal>のエントリの長さを + <literal>n</literal>に返します. + </para> + <para>リストの長さはリストの中の要素の長さです + (<literal>size</literal>でも出力されます). + </para> + <para> + mlistのlengthはデフォルトでmlistの要素数ですが, + オーバーロードすることができます(例参照). + 文字列でないハイパー行列は, + 関数をオーバーロードする必要がないことに注意してください. + さもなくば,<function>length</function>は + ハイパー行列の次元の積を返します. + </para> + <para> + <literal>length('123')</literal>は <literal>3</literal>となります. + <literal>length([1,2;3,4])</literal>は <literal>4</literal>となります. + </para> + <para> + <warning> + 警告 : + 疎行列の<function>length</function>は, + 行列の最大次元を返し,次元の積ではありません. + (例えば: + <code>length(sparse(eye(12,2)))</code>は, + <literal>24</literal>)ではなく<code>max(12,2)</code> を返します. + 疎行列の場合は <literal>size(...,'*')</literal>を使用してください. + </warning> + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +length([123 ; 456 ]) +length(['hello world',SCI]) +length(rand(2,2,2)) + ]]></programlisting> + <programlisting role="example"><![CDATA[ +a = mlist(["myMlistT" "field1" "field2"],"aexample","bexampleb"); +length(a) +// lengthがmlistにオーバーロードされたいない場合のデフォルトの動作は3を返す +// mlist型myMlistTのオーバーロード関数を作成 +function r = %myMlistT_length(M) + r = length(M.field1) +endfunction +length(a) +// length(a.field1)の結果8を返す + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="size">size</link> + </member> + </simplelist> + </refsection> + <refsection> + <title>履歴</title> + <revhistory> + <revision> + <revnumber>5.4.0</revnumber> + <revremark> + この関数によりmlist型のオーバーロードが可能となりました. + </revremark> + </revision> + </revhistory> + </refsection> +</refentry> diff --git a/modules/string/help/ja_JP/part.xml b/modules/string/help/ja_JP/part.xml new file mode 100755 index 000000000..a22c2efbc --- /dev/null +++ b/modules/string/help/ja_JP/part.xml @@ -0,0 +1,124 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="part" xml:lang="ja"> + <refnamediv> + <refname>part</refname> + <refpurpose>文字列の展開</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>[strings_out] = part(strings_in, v)</synopsis> + </refsynopsisdiv> + <refsection> + <title>引数</title> + <variablelist> + <varlistentry> + <term>strings_in</term> + <listitem> + <para>文字列または文字列の行列.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>v</term> + <listitem> + <para> + 展開する文字の添字を有する整数値のベクトル. + <literal>$</literal> を使用可能で, + length(strings_in)を意味します. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>strings_out</term> + <listitem> + <para>文字列または文字列の行列.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>説明</title> + <para> + この関数は,文字列から文字を展開します. + 展開する文字は<literal>v</literal>に含まれる + 添字により参照されます. + </para> + <para> + 添字が入力文字の長さを超える場合, + <literal>strings_out</literal> は,空白文字で埋められます. + </para> + <para> + <literal>v</literal> は,<literal>string_in</literal>の長さを意味する + <literal>$</literal>記号を含むことができます. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +// 位置 8 から 11 の文字を返します +part("How to use ""part"" ?", 8:11) +// 各要素の位置2から4の文字を返します +// 文字はn ''で置換されません +c = part(['a', 'abc', 'abcd'], 2:4) +// 各要素の位置1の文字に各要素の位置4から7に文字を追加して返します +c = part(['abcdefg', 'hijklmn', 'opqrstu'], [1, 4:7]); +// 各要素の4番目の文字に位置1から7の文字を追加し,各要素の位置4の文字を追加して返します +c = part(['abcdefg', 'hijklmn', 'opqrstu'], [4, 1:7, 4]); +// 位置1の文字に位置1の文字を再度追加,位置2の文字を追加して返す +c=part(['a', 'abc', 'abcd'], [1, 1, 2]) +part(['a', 'abc', 'abcd'], [1]) // => ['a' 'a' 'a'] +part(['a', 'abc', 'abcd'], [1, 1]) // => ['aa' 'aa' 'aa'] +part(['a', 'abc', 'abcd'], [1, 1, 2]) // => ['aa' 'aab' 'aab'] +// 文字をN回反復 +N = 10; part('-', ones(1:N)) // => '----------' +// パターンをN回反復: +N = 6; pat = '- '; +part(pat, ones(1:N).*.(1:length(pat))) // => '- - - - - - ' +// $ = 暗黙的な文字列長 を使用: +// 1) +part(['a string' 'another longer one'], $-2:$ ) // => [ 'ing' 'one'] +// 2) strrev()の別の実装: +part('Hello world', $:-1:1) // => 'dlrow olleH' +// 3) 範囲を示さない$を使用: +part('Hello world', [ $ 4:5 ]) // => 'dlo' +// 4) 範囲を示す$が使用できない状況でスカラーと範囲ではない$を混用: +part("Hello", [ 1 $-1:$ $ ]) // => エラー + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="strsplit">strsplit</link> + </member> + <member> + <link linkend="length">length</link> + </member> + </simplelist> + </refsection> + <refsection> + <title>履歴</title> + <revhistory> + <revision> + <revnumber>5.5.0</revnumber> + <revremark> + length(input_strings)を意味する <literal>$</literal> は, + 選択した文字の添字として使用可能になりました. + </revremark> + </revision> + </revhistory> + </refsection> +</refentry> diff --git a/modules/string/help/ja_JP/regexp.xml b/modules/string/help/ja_JP/regexp.xml new file mode 100755 index 000000000..0f2de9715 --- /dev/null +++ b/modules/string/help/ja_JP/regexp.xml @@ -0,0 +1,158 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="regexp" xml:lang="ja"> + <refnamediv> + <refname>regexp</refname> + <refpurpose>正規表現文字列に一致する部分文字列を探す</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis> + [start] = regexp(input, pattern, [flag]) + [start, final] = regexp(input, pattern, [flag]) + [start, final, match] = regexp(input, pattern, [flag]) + [start, final, match, foundString] = regexp(input, pattern, [flag]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>引数</title> + <variablelist> + <varlistentry> + <term>input</term> + <listitem> + <para>文字列.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>pattern</term> + <listitem> + <para> (正規表現の規則に基づく)文字列</para> + </listitem> + </varlistentry> + <varlistentry> + <term>start</term> + <listitem> + <para> + 正規表現文字列<varname>pattern</varname>に + 一致する<varname>input</varname>の各部分文字列の + 開始添字 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>final</term> + <listitem> + <para> + 正規表現文字列<varname>pattern</varname>に + 一致する<varname>input</varname>の各部分文字列の + 終端添字 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>match</term> + <listitem> + <para> + <literal>pattern</literal>に一致する + <varname>input</varname>の各部分文字列のテキスト. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>match</term> + <listitem> + <para> + <varname>pattern</varname>にマッチする<varname>input</varname> + の部分文字列のテキスト. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>foundString</term> + <listitem> + <para> + 取得された括弧で括られた<literal>サブパターン</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>[flag]</term> + <listitem> + <para> + パターンに一回マッチする場合は,<literal>'o'</literal>. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>説明</title> + <para> + Perl言語に似た正規表現の規則. + すぐに始めるには, + <ulink url="http://perldoc.perl.org/perlrequick.html">http://perldoc.perl.org/perlrequick.html</ulink>を参照ください. + より詳細なチュートリアルについては, + <ulink url="http://perldoc.perl.org/perlretut.html">http://perldoc.perl.org/perlretut.html</ulink>を参照ください. + また,リファレンスについては<ulink url="http://perldoc.perl.org/perlre.html">http://perldoc.perl.org/perlre.html</ulink>を参照ください. + </para> + <para> + Perlとの違いは,Perlでは文字ではない位置 + (例えば,<literal>/^/</literal>または<literal>/(?=o)/</literal>) + にPerlではマッチできますが,Scilabではできません. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +regexp('xabyabbbz','/ab*/','o') +regexp('a!','/((((((((((a))))))))))\041/') +regexp('ABCC','/^abc$/i') +regexp('ABC','/ab|cd/i') +[a b c]=regexp('XABYABBBZ','/ab*/i') +piString="3.14" +[a,b,c,piStringSplit]=regexp(piString,"/(\d+)\.(\d+)/") +disp(piStringSplit(1)) +disp(piStringSplit(2)) +[a,b,c,d]=regexp('xabyabbbz','/ab(.*)b(.*)/') +size(d) +// URLからホスト名を取得 +myURL="http://www.scilab.org/download/"; +[a,b,c,d]=regexp(myURL,'@^(?:http://)?([^/]+)@i') +str='foobar: 2012'; +// 名前のあるサブパターンを使用 +[a,b,c,d]=regexp(str,'/(?P<name>\w+): (?P<digit>\d+)/') +d(1)=="foobar" +d(2)=="2012" + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="strindex">strindex</link> + </member> + </simplelist> + </refsection> + <refsection> + <title>履歴</title> + <revhistory> + <revision> + <revnumber>5.4.0</revnumber> + <revremark> + サブパターンマッチの結果を取得するために + 新しい出力引数, foundString, が追加されました. + </revremark> + </revision> + </revhistory> + </refsection> +</refentry> diff --git a/modules/string/help/ja_JP/sci2exp.xml b/modules/string/help/ja_JP/sci2exp.xml new file mode 100755 index 000000000..8ed6522d0 --- /dev/null +++ b/modules/string/help/ja_JP/sci2exp.xml @@ -0,0 +1,272 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="sci2exp"> + + <refnamediv> + + <refname>sci2exp</refname> + + <refpurpose>式を文字列に変換</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>t = sci2exp(a [,nam] [,lmax])</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>a</term> + + <listitem> + + <para>以下に示すscilab式</para> + + <variablelist> + + <varlistentry> + + <term>- </term> + + <listitem> + + <para>定数,</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>- </term> + + <listitem> + + <para>多項式</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>- </term> + + <listitem> + + <para>文字列行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>- </term> + + <listitem> + + <para>リスト</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>- </term> + + <listitem> + + <para>論理値行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>- </term> + + <listitem> + + <para>ハンドル(図およびuicontrolのみ).</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>nam</term> + + <listitem> + + <para>文字列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>t</term> + + <listitem> + + <para>文字列ベクトルで, 式またはダミー命令を含みます</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>lmax</term> + + <listitem> + + <para> + + 整数で, 行の最大長を有します. + + デフォルト値は<literal>0</literal>で, + + 行の長さを制御を行わず, + + 単一の文字列が返されることを示します. + + </para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <function>sci2exp</function>は, + + <varname>nam</varname>が指定されるた場合には + + 式を命令文字列に,さもなくば式文字列に変換します. + + </para> + + </refsection> + + <refsection> + + <title>注意</title> + + <itemizedlist> + + <listitem> + + <para> + + <varname>a</varname> がハンドルの場合, + + <function>sci2exp</function> は階層的リンクがない結果 + + つまり,親および子の空のフィールドの結果を出力します. + + </para> + + </listitem> + + <listitem> + + <para> + + <varname>t</varname> は,<link linkend="format">format</link>の + + 影響を受けます. + + </para> + + </listitem> + + </itemizedlist> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +a=[1 2;3 4] +sci2exp(a,'aa') +sci2exp(a,'aa',10) +sci2exp(ssrand(2,2,2)) +sci2exp(poly([1 0 3 4],'s'),'fi') +sci2exp(figure("figure_name","figure1")) +b=0.123456789; +format(5); +c=sci2exp(b) +format(10); +d=sci2exp(b) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="prettyprint">prettyprint</link> + + </member> + + <member> + + <link linkend="format">format</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strcat.xml b/modules/string/help/ja_JP/strcat.xml new file mode 100755 index 000000000..5e23bc5bc --- /dev/null +++ b/modules/string/help/ja_JP/strcat.xml @@ -0,0 +1,223 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strcat" xml:lang="ja"> + + <refnamediv> + + <refname>strcat</refname> + + <refpurpose>文字列を結合する</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis> + + txt = strcat(strings [,string_added]) + + txt = strcat(strings [,string_added, ["flag"]]) + + </synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>strings</term> + + <listitem> + + <para>文字列のベクトルまたは行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>string_added</term> + + <listitem> + + <para> + + 追加される文字列, デフォルト値は長さ0の文字列 + + <literal>""</literal> + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>txt</term> + + <listitem> + + <para>文字列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>"flag"</term> + + <listitem> + + <para> + + 文字列 (<literal>"r"</literal>は + + 行列<varname>strings</varname>の行の結合, + + <literal>"c"</literal>は + + 行列<varname>strings</varname>の列の結合) + + </para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>txt = strcat(strings)</code>は文字列を結合します: + + <literal>txt = strings(1) + ... + strings(n)</literal>. + + </para> + + <para> + + <code>txt = strcat(strings, string_added)</code>は, + + <literal>txt = strings(1) + string_added + ... + string_added + strings(n)</literal> + + を返します. + + </para> + + <para> + + プラス記号の動作は同じです: <code>"a"+"b"</code> は + + <code>strcat(["a","b"])</code>と同じです. + + </para> + + <para> + + <varname>strings</varname> の大きさが1の場合, + + <code>txt = strings(1)</code>を返します. + + </para> + + <para> + + <code>strcat('A','B')</code> は <literal>'A'</literal>を返し, + + <code>strcat(['A','B'])</code>のように<literal>'AB'</literal> + + とはなりません. + + </para> + + <para> + + <varname>strings</varname>が文字列の行列の場合, + + <code>strcat(strings,"",'r')</code> は文字列の行ベクトルを返します. + + この行ベクトルのエントリは行結合の毛化です.文字列の列ベクトルを返します. + + この列ベクトルのエントリは列結合の結果です. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +strcat(string(1:10),',') +strcat(["a","b"]) +strcat(["a","b"],'|') +strcat('A') +strcat('A','B') +strcat(['A','B']) +strcat(['A','B'],'') + +m =["a" "b" ; "c" "d"]; +strcat(m, "r") +strcat(m, "", "r") +strcat(m, "", "c") + +strcat(m, "_and_", "r") +strcat(m, "_and_", "c") + + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="string">string</link> + + </member> + + <member> + + <link linkend="strings">strings</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strchr.xml b/modules/string/help/ja_JP/strchr.xml new file mode 100755 index 000000000..c27aa1c9f --- /dev/null +++ b/modules/string/help/ja_JP/strchr.xml @@ -0,0 +1,142 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strchr"> + + <refnamediv> + + <refname>strchr</refname> + + <refpurpose>文字列の中で指定した文字が最初に現れる位置を探す</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>res = strchr(haystack, char)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>haystack</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>char</term> + + <listitem> + + <para>文字.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = strchr(haystack, char)</code> は, + + 文字列<varname>haystack</varname>の中で指定した + + 文字が最初に現れる位置を返します. + + </para> + + <para> + + <varname>char</varname>は文字列を1つのみ,または, + + <varname>haystack</varname>と同じ数だけ有する + + 必要があります + + (各文字列の長さは1文字分のみ). + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +strchr('This is a sample string','s') +strchr(['This is a sample string','in scilab'],'s') +strchr(['This is a sample string','in scilab'],['s','a']) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="strrchr">strrchr</link> + + </member> + + <member> + + <link linkend="strstr">strstr</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strcmp.xml b/modules/string/help/ja_JP/strcmp.xml new file mode 100755 index 000000000..c5a869eba --- /dev/null +++ b/modules/string/help/ja_JP/strcmp.xml @@ -0,0 +1,179 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strcmp" xml:lang="ja"> + + <refnamediv> + + <refname>strcmp</refname> + + <refpurpose>文字列を比較</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>res = strcmp(string_one, string_two, [,'i'])</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>string_one</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>string_two</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>'i'</term> + + <listitem> + + <para> + + <function>strcmpi</function> + + (大文字小文字に依存)を使用するためのパラメータ, デフォルト値は + + <literal>'s'</literal>. + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>整数の行列.</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = strcmp(string_one, string_two)</code> + + (または<code>res = strcmp(string_one, string_two, 's')</code>)は, + + 文字列の間の関係(辞書順)を示す整数値を返します. + + </para> + + <para> + + ゼロより大きい値は,一致しない最初の文字について, + + <varname>string_one</varname>の方が + + <varname>string_two</varname>よりも大きな値を有している + + ことを示します. + + </para> + + <para> + + <code>res = strcmp(string_one, string_two, 'i')</code>は, + + <varname>string_one</varname> が + + <varname>string_two</varname> (大文字小文字を区別しません) + + に等しい場合に<literal>0</literal>を返し, + + <literal>1</literal>はその逆を示します. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +TXT1 = ['scilab','SciLab';'Strcmp','STRcmp']; +TXT2 = ['ScIlAb','sciLab';'sTrCmP','StrCMP']; +strcmp(TXT1,TXT2) +strcmp(TXT1,'scilab') +strcmp(TXT1,'SciLab') +strcmp(TXT1,TXT2,'i') + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="strcat">strcat</link> + + </member> + + <member> + + <link linkend="strcmpi">strcmpi</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strcmpi.xml b/modules/string/help/ja_JP/strcmpi.xml new file mode 100755 index 000000000..333a87b72 --- /dev/null +++ b/modules/string/help/ja_JP/strcmpi.xml @@ -0,0 +1,149 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strcmpi"> + + <refnamediv> + + <refname>strcmpi</refname> + + <refpurpose>文字列を比較 (大文字小文字を区別)</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>res = strcmpi(string_one,string_two)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>string_one</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>string_two</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>整数の行列.</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = strcmpi(string_one, string_two)</code>は, + + 文字列の間の関係を示す内部的な値を返します. + + 2つの文字列は<emphasis role="bold">辞書式順序</emphasis>により + + 比較されます. + + </para> + + <para> + + <varname>string_one</varname>が <varname>string_two</varname> + + に等しい場合(大文字小文字を区別しません), 値は + + <literal>0</literal> となり, + + <varname>string_one</varname>が + + <varname>string_two</varname>より大きい場合に<literal>1</literal>, + + それ以外は<literal>-1</literal>となります. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +TXT1 = ['scilab','SciLab';'Strcmp','STRcmp']; +TXT2 = ['ScIlAb','sciLab';'sTrCmP','StrCMP']; +strcmpi(TXT1,TXT2) +strcmpi(TXT1,'scilab') + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="strcat">strcat</link> + + </member> + + <member> + + <link linkend="strcmp">strcmp</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strcspn.xml b/modules/string/help/ja_JP/strcspn.xml new file mode 100755 index 000000000..014a4bf09 --- /dev/null +++ b/modules/string/help/ja_JP/strcspn.xml @@ -0,0 +1,134 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strcspn" xml:lang="ja"> + + <refnamediv> + + <refname>strcspn</refname> + + <refpurpose>文字列の中の文字までの間隔を得る</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>Calling Sequence</title> + + <synopsis>res = strcspn(string_one, string_two)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>string_one</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>string_two</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>行列.</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = strcspn(string_one,string_two)</code>は, + + <varname>string_one</varname>の中で + + <varname>string_two</varname>の一部の文字のどれかが最初に現れる位置を + + 探し,それが最初に現れるまでの<varname>string_one</varname>の文字数を返します. + + </para> + + <para> + + <varname>string_two</varname>の次元が<varname>string_one</varname>と + + 同じ,または<varname>string_two</varname>が文字列である必要があります. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +strcspn("fcba73","1234567890") +strcspn(["fcba73","f7cba73"],"1234567890") +strcspn(["fcba73","f7cba73"],["312","34567890"]) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="strspn">strspn</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strindex.xml b/modules/string/help/ja_JP/strindex.xml new file mode 100755 index 000000000..ee598c4f6 --- /dev/null +++ b/modules/string/help/ja_JP/strindex.xml @@ -0,0 +1,260 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strindex" xml:lang="ja"> + + <refnamediv> + + <refname>strindex</refname> + + <refpurpose>他の文字列の中で指定した文字列の位置を探す.</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis> + + ind = strindex(haystack, needle, [flag]) + + [ind, which] = strindex(haystack, needle, [flag]) + + </synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>haystack</term> + + <listitem> + + <para> + + 文字列. + + <varname>needle</varname>が現れる場所を探す文字列 + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>needle</term> + + <listitem> + + <para> + + 文字列または文字列ベクトル. + + <varname>haystack</varname>で探す文字列 + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>ind</term> + + <listitem> + + <para>添字のベクトル</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>which</term> + + <listitem> + + <para>添字のベクトル</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>flag</term> + + <listitem> + + <para> + 文字列(<literal>"r"</literal>の場合は正規表現) + </para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <function>strindex</function>は, + + <varname>haystack</varname>の中で<literal>needle(i)</literal>が + + 見つかる場所のインデックスを探します. + + </para> + + <para> + + 各<literal>k</literal>に関して, + + <literal>part(haystack,ind(k)+(0:length(needle(i))-1))</literal> + + が<literal>needle(i)</literal>と同じ文字列となるよな + + <literal>i</literal>が存在します. + + <varname>which</varname>引数が必要な場合, + + これにはこれらの<literal>i</literal>が含まれる必要があります. + + 3番目のパラメータ<literal>"r"</literal>を指定する場合, + + <varname>needle</varname>は正規表現の文字列とする必要があります. + + この場合, <function>strindex</function>は正規表現式の規則に基づき + + <varname>haystack</varname>を検索します. + + </para> + + <para> + + 正規表現式引数を指定しない<function>strindex</function>は + + Knuth-Morris-Prattアルゴリズムに基づきます. + + </para> + + <para> + + このアルゴリズムは Scilab 4.x で使用されるものよりも + + より強力です. いくつかの特殊なケースでは,結果が異なることがあります. + + </para> + + <para>例:</para> + + <para>// Scilab 5.x</para> + + <para>-->[k,w]=strindex('aab',['a','ab'])</para> + + <para>w = 1. 1. 2. k = 1. 2. 2.</para> + + <para>// Scilab 4.x</para> + + <para>-->[k,w]=strindex('aab',['a','ab'])</para> + + <para>w = 1. 1. k = 1. 2.</para> + + <para> + + 正規表現の規則はPerl言語に似ていますT. 使い始めるには, + + <ulink url="http://perldoc.perl.org/perlrequick.html">http://perldoc.perl.org/perlrequick.html</ulink>を参照してください. + + より詳細なチュートリアルについては <ulink url="http://perldoc.perl.org/perlretut.html">http://perldoc.perl.org/perlretut.html</ulink> + + を参照ください. + + リファレンスについては, <ulink url="http://perldoc.perl.org/perlre.html">http://perldoc.perl.org/perlre.html</ulink> + + を参照してください + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +k=strindex('SCI/demos/scicos','/') +k=strindex('SCI/demos/scicos','SCI/') +k=strindex('SCI/demos/scicos','!') +k=strindex('aaaaa','aa') +k=strindex('SCI/demos/scicos',['SCI','sci']) +[k,w]=strindex('1+3*abc/2.33',['+','-','*','/']) +k=strindex('2' ,'/2(]*)?$\1/' ,'r') + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="string">string</link> + + </member> + + <member> + + <link linkend="strings">strings</link> + + </member> + + <member> + + <link linkend="regexp">regexp</link> + + </member> + + <member> + + <link linkend="strsubst">strsubst</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/string.xml b/modules/string/help/ja_JP/string.xml new file mode 100755 index 000000000..52220a166 --- /dev/null +++ b/modules/string/help/ja_JP/string.xml @@ -0,0 +1,142 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="string"> + <refnamediv> + <refname>string</refname> + <refpurpose>文字列に変換</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>string(x) + [out, in, text] = string(x) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>引数</title> + <variablelist> + <varlistentry> + <term>x</term> + <listitem> + <para> + 論理値, 複素数, 実数, 整数, 多項式行列, + 暗黙の大きさ, ライブラリまたは関数. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>説明</title> + <para> + <function>string</function>関数は + 行列<varname>x</varname> を文字列の行列に変換します. + </para> + <para> + <literal>x</literal>が関数の場合, + <code>[out, in, text] = string(x)</code> は + 3つの文字列ベクトルを返します: + <literal>out</literal> は出力変数のベクトル, + <literal>in</literal> は入力変数のベクトル, そして <literal>text</literal> は + 関数のソースコードの(列)ベクトルです. + </para> + <para> + <literal>x</literal>が <literal>lib</literal>変数の場合, + <varname>text</varname>は文字列の列ベクトルとなります. + 最初の要素は,ライブラリファイルのパス, + その他の要素は定義する関数の名前を有します. + </para> + <para> + 文字列は<literal>'string'</literal> (引用符で括る)または + <literal>"string"</literal> (二重引用符で括る)で定義されます; + 文字列の行列は通常の定数行列として定義されます. + </para> + <para> + 文字列の結合は<literal>+</literal>操作により行われます. + </para> + <para> + 複素数, 実数, 整数, 多項式行列の場合, + <function>string</function> の出力は + <link linkend="format">format</link> function (例参照)で管理されます. + </para> + <para> + string([]) は []を返すことに注意してください. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ + string(rand(2, 2)) + deff("y = mymacro(x)", "y = x + 1") + [out, in, text] = string(mymacro) + x = 123.356; + disp("Result is " + string(x)); + disp("/" + string(~%t) + "/"); + disp("/" + string(%i+1) + "/"); + disp("/" + string(int16(-123)) + "/"); + disp("/" + string(1 + %s + %s^3) + "/"); + string(corelib) + v = format(); + disp(string(%pi)) + format(24); + disp(string(%pi)) + format(v(2)) + string(1:4:$) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="part">part</link> + </member> + <member> + <link linkend="length">length</link> + </member> + <member> + <link linkend="quote">quote</link> + </member> + <member> + <link linkend="evstr">evstr</link> + </member> + <member> + <link linkend="execstr">execstr</link> + </member> + <member> + <link linkend="strsubst">strsubst</link> + </member> + <member> + <link linkend="strcat">strcat</link> + </member> + <member> + <link linkend="strindex">strindex</link> + </member> + <member> + <link linkend="sci2exp">sci2exp</link> + </member> + <member> + <link linkend="format">format</link> + </member> + </simplelist> + </refsection> + <refsection> + <title>履歴</title> + <revhistory> + <revision> + <revnumber>5.4.0</revnumber> + <revremark> + 暗黙の大きさの型が入力引数として管理されます. + </revremark> + </revision> + </revhistory> + </refsection> +</refentry> diff --git a/modules/string/help/ja_JP/strings.xml b/modules/string/help/ja_JP/strings.xml new file mode 100755 index 000000000..e5824aad6 --- /dev/null +++ b/modules/string/help/ja_JP/strings.xml @@ -0,0 +1,89 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strings"> + + <refnamediv> + + <refname>strings</refname> + + <refpurpose>Scilabオブジェクト, 文字列</refpurpose> + + </refnamediv> + + <refsection> + + <title>説明</title> + + <para> + + 文字列は <code>'string'</code> (引用符で括る) または + + <code>"string"</code> (二重引用符で括る)と定義されます; + + 文字列の行列は通常の定数行列と同様に定義されます. + + </para> + + <para> + + 2つの文字列の結合は <literal>+</literal> により作成されます: + + <code>string1 + string2</code>. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +['this','is'; 'a 2x2','matrix'] +"matrix"=="mat"+"rix" + ]]></programlisting> + + </refsection> + + <refsection> + + <title>S参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="part">part</link> + + </member> + + <member> + + <link linkend="length">length</link> + + </member> + + <member> + + <link linkend="strcat">strcat</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/stripblanks.xml b/modules/string/help/ja_JP/stripblanks.xml new file mode 100755 index 000000000..d72a8cd74 --- /dev/null +++ b/modules/string/help/ja_JP/stripblanks.xml @@ -0,0 +1,110 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="stripblanks"> + + <refnamediv> + + <refname>stripblanks</refname> + + <refpurpose> + + 文字列の先頭または末尾の空白(およびタブ)を取り除く + + </refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>txt = stripblanks(txt[,tabs])</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>txt</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>tabs</term> + + <listitem> + + <para> + + 論理値, <constant>%t</constant>の場合タブも削除されます + + (デフォルト値は <constant>%f</constant>です). + + </para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <function>stripblanks</function>関数は, + + 文字列の先頭または末尾の空白(およびタブ)を取り除きます. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +a=' 123 '; +'!'+a+'!' +'!'+stripblanks(a)+'!' +a=[' 123 ',' xyz'] +strcat(stripblanks(a)) + +a = msprintf("\t \tHello world!\t\t") +strcat(stripblanks(a,%f)+'?') +strcat(stripblanks(a,%t)+'?') + ]]></programlisting> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strncpy.xml b/modules/string/help/ja_JP/strncpy.xml new file mode 100755 index 000000000..254a6a867 --- /dev/null +++ b/modules/string/help/ja_JP/strncpy.xml @@ -0,0 +1,140 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strncpy"> + + <refnamediv> + + <refname>strncpy</refname> + + <refpurpose>文字列から文字をコピーする</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>res = strncpy(str1, num)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str1</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>num</term> + + <listitem> + + <para>行列で,ソースからコピーされる文字の最大長</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = strncpy(str1, num)</code> は, + + ソース<varname>str1</varname>から + + デスティネーション<varname>res</varname>に + + 最初の<varname>num</varname>文字をコピーします. + + </para> + + <para> + + <varname>num</varname>は<varname>str1</varname>と同じ次元であるか, + + <varname>num</varname>が整数値である必要があります. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +strncpy('scilab',3) +strncpy(['scilab','SciLab';'strncpy','strstr'],3) +strncpy(['scilab','SciLab';'strncpy','strstr'],[1,2;3,4]) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="strcat">strcat</link> + + </member> + + <member> + + <link linkend="strcmp">strcmp</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strrchr.xml b/modules/string/help/ja_JP/strrchr.xml new file mode 100755 index 000000000..c8cc837e9 --- /dev/null +++ b/modules/string/help/ja_JP/strrchr.xml @@ -0,0 +1,138 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strrchr"> + + <refnamediv> + + <refname>strrchr</refname> + + <refpurpose>文字列の中で指定した文字が最後に現れる場所を探す</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>res = strrchr(str1, char)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str1</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>char</term> + + <listitem> + + <para>文字.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = strrchr(str1, char)</code>は, + + 文字列<varname>str1</varname>の中で指定した文字 + + <varname>char</varname>が最後に現れる場所を返します. + + </para> + + <para> + + <varname>char</varname>は<varname>str1</varname>と同じ次元 + + または1文字である必要があります. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +strrchr('This is a sample string','s') +strrchr(['This is a sample string','in scilab'],'s') +strrchr(['This is a sample string','in scilab'],['s','a']) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="strchr">strchr</link> + + </member> + + <member> + + <link linkend="strstr">strstr</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strrev.xml b/modules/string/help/ja_JP/strrev.xml new file mode 100755 index 000000000..04e958218 --- /dev/null +++ b/modules/string/help/ja_JP/strrev.xml @@ -0,0 +1,92 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strrev"> + + <refnamediv> + + <refname>strrev</refname> + + <refpurpose>文字列を逆順にして返す</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>res = strrev(str1)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str1</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = strrev(str1)</code> 文字列を逆順にして返します. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +rev = strrev('This is a simple string') +strrev(rev) +strrev(['This is a simple string','scilab']) + ]]></programlisting> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strsplit.xml b/modules/string/help/ja_JP/strsplit.xml new file mode 100755 index 000000000..6e93db9f2 --- /dev/null +++ b/modules/string/help/ja_JP/strsplit.xml @@ -0,0 +1,290 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strsplit" xml:lang="ja"> + + <refnamediv> + + <refname>strsplit</refname> + + <refpurpose>文字列を文字列のベクトルに分割する</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis> + + v = strsplit(str,ind) + + [v, matched_separators] = strsplit(str) + + [v, matched_separators] = strsplit(str, matrix_of_strings, limit) + + [v, matched_separators] = strsplit(str, regexp_pattern, limit) + + </synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str</term> + + <listitem> + + <para>分割する文字列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>ind</term> + + <listitem> + + <para> + + <literal>[1 length(str)-1] </literal>の範囲の + + 単調増加のインデックスのベクトル. + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>v</term> + + <listitem> + + <para> + + 得られた文字列の列ベクトル (次元 + + ><literal>size(ind,'*')+1</literal>). + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>matched_separators</term> + + <listitem> + + <para>一致したセパレータの列ベクトル</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>matrix_of_strings</term> + + <listitem> + + <para>strの中で検索する文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>regexp_pattern</term> + + <listitem> + + <para>正規表現パターン</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>limit</term> + + <listitem> + + <para>要素数の最大値</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>v= strsplit(str, ind)</code>は,文字列<varname>str</varname>を + + <varname>ind</varname>で添字が指定された点 + + (<varname>ind</varname>の添字が指す各文字の後)で, + + 文字列のベクトルに分割します. + + </para> + + <para> + + <code>strsplit(str)</code> は, + + <code>strsplit(str,1:length(str)-1)</code>と同じ文字列を返します. + + </para> + + <para> + + <code>strsplit(str, regexp_pattern, limit)</code>は + + 文字列の列ベクトルを返します. + + その各々は,大文字小文字を区別する正規表現により構築された境界で + + 分割された<varname>str</varname> の部分文字列です. + + </para> + + <para> + + パターンが<literal>n</literal>回現れる場合, + + 返される配列は<literal>n+1</literal>個の要素を有します. + + </para> + + <para> + + 例えば, パターンが1回も存在しなかった場合, + + 1要素のみの配列が返されます. + + もちろん,これは<varname>str</varname>が空の場合も同じです. + + </para> + + <para> + + <varname>limit</varname>が設定された場合,返される配列には + + 最大<varname>limit</varname>個の要素が含まれ, + + その最後の要素には文字列の残り全体が含まれます. + + </para> + + <para> + + <code>strsplit(str, matrix_of_strings, limit)</code>は, + + <varname>str</varname>を任意の要素で分割します. + + これにより, + + 正規表現を知らないユーザが異なるセパレータで分割することが + + できるようになります. + + </para> + + <para> + + <code>strsplit()</code>が第2の出力引数を指定してコールされた場合, + + 一致したセパレータの列ベクトルが返されます. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +S='strsplit splits a string into a vector of strings'; +strsplit(S,[15 25 30]) +ind=strindex(S,' ') +[r_1, r_2] = strsplit("abcd") +[r_1, r_2] = strsplit("root:x:0:0:root:/root:/bin/bash",":",5) +[r_1, r_2] = strsplit("abc,def:ijk,:lmo","/:|,/") +[r_1, r_2] = strsplit("abc,def:ijk,:lmo",[":";","]) +strsplit("abcdef2ghijkl3mnopqr6stuvw7xyz","/\d+/") +[r_1, r_2] = strsplit("abcdef2ghijkl3mnopqr6stuvw7xyz","/\d+/",2) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="part"> part</link> + + </member> + + <member> + + <link linkend="strcat"> strcat</link> + + </member> + + <member> + + <link linkend="tokens"> tokens</link> + + </member> + + <member> + + <link linkend="regexp"> regexp</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strspn.xml b/modules/string/help/ja_JP/strspn.xml new file mode 100755 index 000000000..b7374af84 --- /dev/null +++ b/modules/string/help/ja_JP/strspn.xml @@ -0,0 +1,138 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strspn" xml:lang="ja"> + + <refnamediv> + + <refname>strspn</refname> + + <refpurpose>文字列において指定した文字集合の幅を取得</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>res = strspn(str1, str2)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str1</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>str2</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>文字列の行列.</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = strspn(str1, str2)</code>は, + + <varname>str2</varname>に含まれる文字のみからなる + + <varname>str1</varname>の先頭部分の長さを返します. + + </para> + + <para> + + <varname>str1</varname>は<varname>str2</varname>と次元が同じ, + + もしくは, + + <varname>str2</varname>が1x1の文字列である必要があります. + + どちらの場合でも, + + 出力は<varname>str1</varname>と同じ次元となります. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +i = strspn("129th","1234567890"); +mprintf ("The length of initial number is %d.\n",i); +i = strspn(["129th","130th"],["1234567890","130t"]) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="strcspn">strcspn</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strstr.xml b/modules/string/help/ja_JP/strstr.xml new file mode 100755 index 000000000..08b298c22 --- /dev/null +++ b/modules/string/help/ja_JP/strstr.xml @@ -0,0 +1,135 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strstr" xml:lang="ja"> + + <refnamediv> + + <refname>strstr</refname> + + <refpurpose>部分文字列を取得</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>res = strstr(haystack, needle)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>haystack</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>needle</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>文字列または文字列の行列</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = strstr(haystack, needle)</code>は, + + <varname>haystack</varname>の中で<varname>needle</varname>が最初に現れる位置から + + <varname>haystack</varname>の末尾までの文字列行列を返します. + + <varname>haystack</varname>の部分が見つからない場合は + + <literal>''</literal>を返します. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +strstr('This is a simple string','simple') +strstr('This is a simple string','sample') +strstr(['This is a simple string','in scilab'],'is') +strstr(['This is a sample string','in scilab'],['a','scilab']) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="strrchr">strrchr</link> + + </member> + + <member> + + <link linkend="strchr">strchr</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strsubst.xml b/modules/string/help/ja_JP/strsubst.xml new file mode 100755 index 000000000..f0605a739 --- /dev/null +++ b/modules/string/help/ja_JP/strsubst.xml @@ -0,0 +1,194 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strsubst" xml:lang="ja"> + + <refnamediv> + + <refname>strsubst</refname> + + <refpurpose>文字列を他の文字列で置換する.</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis> + + string_out = strsubst(string_in, searchStr, replaceStr) + + string_out = strsubst(string_in, searchStr, replaceStr, [flag]) + + </synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>string_in</term> + + <listitem> + + <para> + + 文字列の行列. <varname>searchStr</varname>の存在を + + 探す文字列 + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>searchStr</term> + + <listitem> + + <para> + + 文字列. + + <varname>string_in</varname>の中で探す文字列. + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>replaceStr</term> + + <listitem> + + <para>文字列. 置換する文字列.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>str_out</term> + + <listitem> + + <para> + + 文字列の行列. <varname>string_in</varname>の中の + + <varname>searchStr</varname>を + + <varname>replaceStr</varname>で置換した結果. + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>flag</term> + + <listitem> + + <para> + 文字列 (正規表現の場合は<literal>"r"</literal>) + </para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <function>strsubst</function>関数は,<varname>string_in</varname>の中に + + 存在する全ての<varname>searchStr</varname>を<varname>replaceStr</varname>で + + 置換します. + + </para> + + <para> + + 4番目のパラメータ <literal>"r"</literal>を使用する時, + + <varname>searchStr</varname> は正規表現の文字列となります. + + <function>strsubst</function>はこれを<varname>string_in</varname>とマッチさせ, + + 正規表現式の規則に基づき置換を行ないます. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +strsubst('SCI/demos/scicos','SCI','.') +strsubst('SCI/demos/scicos','/',' ') +strsubst('2' ,'/2(]*)?$\1/' ,'0','r') + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="string">string</link> + + </member> + + <member> + + <link linkend="strings">strings</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strtod.xml b/modules/string/help/ja_JP/strtod.xml new file mode 100755 index 000000000..419805d5d --- /dev/null +++ b/modules/string/help/ja_JP/strtod.xml @@ -0,0 +1,231 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strtod" xml:lang="ja"> + + <refnamediv> + + <refname>strtod</refname> + + <refpurpose>文字列を倍精度実数に変換.</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis> + + d = strtod(str [,decimalseparator]) + + [d, endstr] = strtod(str [,decimalseparator]) + + </synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str</term> + + <listitem> + + <para> + + 文字列または文字列の行列 + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>decimalseparator</term> + + <listitem> + + <para> + + 選択した10進数セパレータ: "." (デフォルト) または ",". + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>d</term> + + <listitem> + + <para> + + 実数または実数の行列 + + </para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>endstr</term> + + <listitem> + + <para> + + 文字列または文字列の行列 + + (<varname>str</varname>の中で数値の後に続く文字). + + </para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>[d, endstr] = strtod(str)</code> は, + + 文字列<varname>str</varname> を + + パースし,その内容を浮動小数点数として解釈して, + + その値を実数として返します. + + <varname>str</varname>に数値が含まれていない場合, + + <varname>d</varname> は <literal>Nan</literal>となります. + + </para> + + </refsection> + + <refsection> + + <title>注意</title> + + <itemizedlist> + + <listitem> + + <para> + + この関数はWindowsとLinuxで動作が異なるstrtod C関数に基づきます. + + 実際, Windows では指数部にd または D を使用できますが, + + 16進数を使用することはできません. + + </para> + + </listitem> + + <listitem> + + <para> + + <literal>strtod("%inf")</literal> は <literal>Nan</literal>を + + 返すことに注意してください. + + </para> + + </listitem> + + </itemizedlist> + + </refsection> + + + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +strtod('123.556This is a sample real') +strtod('123,556This is a sample real', ",") +[d,endstr] = strtod('123.556This is a sample real') +strtod(['123.556This is a sample real','888.666 here']) +[d,endstr] =strtod(['123.556This is a sample real','888.666 here']) +[d,endstr] =strtod(['123.556This is a sample real','888,666 here'], ",") + ]]></programlisting> + + </refsection> + + <refsection> + + <title>履歴</title> + + <revhistory> + + <revision> + + <revnumber>5.5.0</revnumber> + + <revremark> + + 新しいオプション入力: decimalseparator (SEP 97). + + </revremark> + + </revision> + + <revision> + + <revnumber>5.4.1</revnumber> + + <revremark> + + <varname>str</varname> に数値が含まれていない場合, + + <varname>d</varname> は以前のバージョンのように + + <literal>0</literal>ではなく, + + <literal>Nan</literal>となります. + + </revremark> + + </revision> + + </revhistory> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/strtok.xml b/modules/string/help/ja_JP/strtok.xml new file mode 100755 index 000000000..1d71782b6 --- /dev/null +++ b/modules/string/help/ja_JP/strtok.xml @@ -0,0 +1,139 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strtok"> + + <refnamediv> + + <refname>strtok</refname> + + <refpurpose>文字列をトークンに分割</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>res = strtok(str, delimiters)</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str</term> + + <listitem> + + <para>文字列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>delimiters</term> + + <listitem> + + <para>文字列</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>res</term> + + <listitem> + + <para>文字列</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>res = strtok(str, delimiters)</code> + + この関数を連続してコールすることにより, + + <varname>str</varname>をトークンに分割します. + + トークンは<varname>delimiters</varname>の文字のどれかで + + 区切られた連続する一連の文字です. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +TOKENS = []; +token = strtok("A string of ,,tokens and some more tokens"," r,"); +TOKENS = [TOKENS,token]; +while( token <> '' ) + token = strtok(" r,"); + TOKENS = [TOKENS,token]; +end +disp(TOKENS); + ]]></programlisting> + + </refsection> + + <refsection> + + <title>参照o</title> + + <simplelist type="inline"> + + <member> + + <link linkend="strrchr">strrchr</link> + + </member> + + <member> + + <link linkend="strchr">strchr</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/tokenpos.xml b/modules/string/help/ja_JP/tokenpos.xml new file mode 100755 index 000000000..f45d59f41 --- /dev/null +++ b/modules/string/help/ja_JP/tokenpos.xml @@ -0,0 +1,142 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="tokenpos"> + + <refnamediv> + + <refname>tokenpos</refname> + + <refpurpose>文字列の中のトークンの位置を返す </refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>kdf = tokenpos(str [,delimiter])</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str</term> + + <listitem> + + <para>文字列. トークンを探す文字列.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>delimiter</term> + + <listitem> + + <para>(オプション) 文字列または文字列のベクトル. トークンデリミタ.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>kdf</term> + + <listitem> + + <para> + + 2列の行列で, 最初の列はトークン開始位置の添字, + + 2列目はトークンの最後の文字の添字を出力します. + + </para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>kdf = tokenpos(str [,delimiter])</code>は文字列 + + <varname>str</varname>に含まれるトークンを探します. + + <varname>delimiter</varname> のデフォルト値は + + <literal>[" ",<Tab>]</literal>です. + + ただし, <literal><Tab></literal> は<code>ascii(9)</code>を意味します. + + この関数は各トークンが見つかった最初および最後の文字のインデックスを返します. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +str = 'This is a character string'; +kdf = tokenpos(str) +first = part(str, kdf(1,1):kdf(1,2)) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="strindex">strindex</link> + + </member> + + <member> + + <link linkend="tokens">tokens</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/ja_JP/tokens.xml b/modules/string/help/ja_JP/tokens.xml new file mode 100755 index 000000000..3c5e4c267 --- /dev/null +++ b/modules/string/help/ja_JP/tokens.xml @@ -0,0 +1,134 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="tokens"> + + <refnamediv> + + <refname>tokens</refname> + + <refpurpose>文字列のトークンを返す.</refpurpose> + + </refnamediv> + + <refsynopsisdiv> + + <title>呼び出し手順</title> + + <synopsis>T = tokens(str [,delimiter])</synopsis> + + </refsynopsisdiv> + + <refsection> + + <title>引数</title> + + <variablelist> + + <varlistentry> + + <term>str</term> + + <listitem> + + <para>文字列. トークンを探す文字列.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>delimiter</term> + + <listitem> + + <para>(オプション) 文字または文字のベクトル. トークンデリミタ.</para> + + </listitem> + + </varlistentry> + + <varlistentry> + + <term>T</term> + + <listitem> + + <para>みつかったトークンの列ベクトル</para> + + </listitem> + + </varlistentry> + + </variablelist> + + </refsection> + + <refsection> + + <title>説明</title> + + <para> + + <code>T = tokens(str [,delimiter]) </code> は, + + 文字列<varname>str</varname>の中に含まれるトークンを探します. + + <varname>delimiter</varname>のデフォルト値は + + <literal>[" ",<Tab>]</literal>です. + + ただし, <Tab> は<code>ascii(9)</code>を意味します. + + </para> + + </refsection> + + <refsection> + + <title>例</title> + + <programlisting role="example"><![CDATA[ +tokens('This is a character string') +tokens('SCI/demos/scicos','/') +tokens('y=a+b*2',['=','+','*']) + ]]></programlisting> + + </refsection> + + <refsection role="see also"> + + <title>参照</title> + + <simplelist type="inline"> + + <member> + + <link linkend="strindex">strindex</link> + + </member> + + <member> + + <link linkend="tokenpos">tokenpos</link> + + </member> + + </simplelist> + + </refsection> + +</refentry> + diff --git a/modules/string/help/pt_BR/addchapter.sce b/modules/string/help/pt_BR/addchapter.sce new file mode 100755 index 000000000..0fb05ca1d --- /dev/null +++ b/modules/string/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("Cadeias de Caracteres (Strings)",SCI+"/modules/string/help/pt_BR",%T); + diff --git a/modules/string/help/pt_BR/ascii.xml b/modules/string/help/pt_BR/ascii.xml new file mode 100755 index 000000000..46f0c4c11 --- /dev/null +++ b/modules/string/help/pt_BR/ascii.xml @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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: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="ascii" xml:lang="en"> + <refnamediv> + <refname>ascii</refname> + <refpurpose>conversão ASCII de strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqüência de Chamamento</title> + <synopsis>a=ascii(txt) + txt=ascii(a) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Parâmetros</title> + <variablelist> + <varlistentry> + <term>txt</term> + <listitem> + <para>um string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>a</term> + <listitem> + <para>um vetor de códigos ASCII inteiros</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrição</title> + <para>Esta função converte um string Scilab para um vetor de códigos + ASCII, ou um vetor de códigos ASCII em strings Scilab + </para> + <para> + Se <literal>txt</literal> é uma matriz de strings, + <literal>ascii(txt)</literal> é equivalente a + <literal>ascii(strcat(txt))</literal> + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +ascii(["olá";"mundo"]) +ascii("scilab") +ascii([115 99 105 108 97 98]) + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/blanks.xml b/modules/string/help/pt_BR/blanks.xml new file mode 100755 index 000000000..fe10da09e --- /dev/null +++ b/modules/string/help/pt_BR/blanks.xml @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="blanks" xml:lang="en"> + <refnamediv> + <refname>blanks</refname> + <refpurpose>cria strings de caracteres em branco</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>txt=blanks(n)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>txt</term> + <listitem> + <para>um nico string</para> + </listitem> + </varlistentry> + <varlistentry> + <term>n</term> + <listitem> + <para>nmero de caracteres em branco</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para>blanks(n) um string de n caracteres em branco.</para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +disp(['xxx' blanks(20) 'yyy']) + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/char.xml b/modules/string/help/pt_BR/char.xml new file mode 100755 index 000000000..cc0a50b75 --- /dev/null +++ b/modules/string/help/pt_BR/char.xml @@ -0,0 +1,105 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 2008 - INRIA - Farid BELAHCENE + * + * 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: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="char" xml:lang="en"> + <refnamediv> + <refname>char</refname> + <refpurpose>funo char</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>y=char( x) + y=char(st1,st2,st3,....) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>x</term> + <listitem> + <para>um cell de arrays de strings, ou um array de cdigos ASCII + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>st1,st2,st3</term> + <listitem> + <para>arrays de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>y:</term> + <listitem> + <para>vetor (coluna) de strings </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>Argumento de uma entrada :</literal> + </para> + <para> + Dado um<literal> cell de arrays de strings x</literal>, esta funo + retorna um vetor de strings <literal>y </literal>no qual as linhas so + componentes do cell de strings. + </para> + <para> + Dado um<literal> array de cdigos ASCII x,</literal> esta funo + retorna um array de strings <literal>y</literal> correspondente aos + cdigos ASCII. Se dims (<literal>x</literal>)=[n1,n2,n3,n4,....], ento o + valor retornado tem o mesmo tamanho que o valor de entrada, ao invs do + segundo dims, dims(<literal>y</literal>)=[n1,n3,n4,..] + </para> + <para> + <literal>Argumento de mais de uma entrada :</literal> + </para> + <para> + Dados <literal>arrays de strings</literal> + <literal>st1,st2,st3,...</literal>, esta funo retorna um vetor de + strings no qual as linhas so os componentes de <literal>st1,st2,st3,... + </literal> + <literal> No vetor </literal><literal>y </literal>o comprimento + de todos os strings sti completado por lacunas, para terem o mesmo + comprimento que o comprimento mximo de sti. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +//exemplo com uma hipermatriz de cdigos ASCII : +x=hypermat([4,2,3],61:84); +y=char(x) +size(x) +size(y) + +//Exemplo com mais de um argumento : +st1="zeros"; +st2=["one","two"]; +st3=["three"]; +y=char(st1,st2,st3) +size(y) +//todos os strings so completados por "lacunas" para terem o mesmo comprimento : 6 +length(y) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="asciimat">asciimat</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/convstr.xml b/modules/string/help/pt_BR/convstr.xml new file mode 100755 index 000000000..9ac11fba5 --- /dev/null +++ b/modules/string/help/pt_BR/convstr.xml @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="convstr" xml:lang="en"> + <refnamediv> + <refname>convstr</refname> + <refpurpose>converso maisculas-minsculas, + minsculas-maisculas + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>[y]=convstr(str, [flag])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>str, y</term> + <listitem> + <para>uma matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>flag</term> + <listitem> + <para>um caractere de opo com dois possveis valores</para> + <variablelist> + <varlistentry> + <term>'u'</term> + <listitem> + <para>para maisculas</para> + </listitem> + </varlistentry> + <varlistentry> + <term>'l'</term> + <listitem> + <para>para minsculas</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + converts a matriz de strings <literal>str-matrix</literal> para + caracteres minsculos (<literal>"l"</literal> ; valor padro) ou para + maisculos (<literal>"u"</literal>). + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +A=['esta','';'a minha','matriz']; +convstr(A,'u') + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/emptystr.xml b/modules/string/help/pt_BR/emptystr.xml new file mode 100755 index 000000000..517b3b892 --- /dev/null +++ b/modules/string/help/pt_BR/emptystr.xml @@ -0,0 +1,81 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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: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="emptystr" xml:lang="en"> + <refnamediv> + <refname>emptystr</refname> + <refpurpose>string de comprimento zero</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>s=emptystr() + s=emptystr(a) + s=emptystr(m,n) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>a</term> + <listitem> + <para>qualquer tipo de matriz</para> + </listitem> + </varlistentry> + <varlistentry> + <term>s</term> + <listitem> + <para>matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>m,n</term> + <listitem> + <para>inteiros</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para>Retorna uma matriz de strings de comprimento zero.</para> + <para>Sem argumentos de entrada, retorna um string de comprimento + zero. + </para> + <para>Com uma matriz como argumento de entrada, retorna uma matriz de + strings de comprimento zero de mesmo tamanho. + </para> + <para>Com dois argumentos inteiros, retorna uma matriz mxn de strings de + comprimento zero. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +x=emptystr();for k=1:10, x=x+','+string(k);end + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="part">part</link> + </member> + <member> + <link linkend="length">length</link> + </member> + <member> + <link linkend="string">string</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/eval.xml b/modules/string/help/pt_BR/eval.xml new file mode 100755 index 000000000..8519fa58e --- /dev/null +++ b/modules/string/help/pt_BR/eval.xml @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * 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: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="eval" xml:lang="en"> + <refnamediv> + <refname>eval</refname> + <refpurpose>avaliao de uma matriz de strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>[H]= eval(Z)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Descrio</title> + <para>Retorna a avaliao da matriz de strings + <literal>Z</literal>. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +a=1; b=2; Z=['a','sin(b)'] ; eval(Z) //retorna a matriz [1,0.909]; + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="evstr">evstr</link> + </member> + <member> + <link linkend="execstr">execstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/evstr.xml b/modules/string/help/pt_BR/evstr.xml new file mode 100755 index 000000000..cf61d8b5d --- /dev/null +++ b/modules/string/help/pt_BR/evstr.xml @@ -0,0 +1,97 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<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="evstr" xml:lang="en"> + <refnamediv> + <refname>evstr</refname> + <refpurpose>avaliação de expressões</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqüência de Chamamento</title> + <synopsis>H=evstr(Z) + [H,ierr]=evstr(Z) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Parâmetros</title> + <variablelist> + <varlistentry> + <term>Z</term> + <listitem> + <para> + matriz de strings <literal>M</literal> ou + <literal>list(M,Subexp)</literal> + </para> + <variablelist> + <varlistentry> + <term>M</term> + <listitem> + <para>matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>Subexp</term> + <listitem> + <para>vetor de strings</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + <varlistentry> + <term>H</term> + <listitem> + <para>matriz</para> + </listitem> + </varlistentry> + <varlistentry> + <term>ierr</term> + <listitem> + <para>inteiro, indicador de erro</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrição</title> + <para>Retorna o resultado da avaliação da matriz de strings + <literal>M</literal>. Cada elemento da matriz deve definir uma expressão + Scilab válida. + </para> + <para> + Se a avaliação de <literal>M</literal> levar a um erro, a versão de + valor de único retorno, <literal>H=evstr(M)</literal>, levanta erro de + modo usual. A versão de dois valores de retorno, + <literal>[H,ierr]=evstr(M)</literal> , por outro lado, não produz erro, + mas retorna o número de erro em <literal>ierr</literal>. + </para> + <para> + Se <literal>Z</literal> é uma lista, <literal>Subexp </literal>é um + vetor de strings, que define subexpressões que são avaliadas antes da + avaliação de <literal>M</literal>. Estas subexpressões devem ser referidas + como <literal>%(k)</literal> em <literal>M</literal>, onde + <literal>k</literal> é o índice da subexpressão em + <literal>Subexp</literal>. + </para> + <para> + evstr('a=1') não é válido (use <literal>execstr</literal> ao + invés). + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example">a = 1; b = 2; Z = ['a','b'] ; evstr(Z) + + a = 1; b = 2; Z = list(['%(1)','%(1)-%(2)'],['a+1','b+1']); + evstr(Z) + + evstr('NaN'), evstr('Inf') + </programlisting> + </refsection> + <refsection> + <title>Ver Também</title> + <simplelist type="inline"> + <member> + <link linkend="execstr">execstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/grep.xml b/modules/string/help/pt_BR/grep.xml new file mode 100755 index 000000000..3d5b42236 --- /dev/null +++ b/modules/string/help/pt_BR/grep.xml @@ -0,0 +1,110 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="grep" xml:lang="en"> + <refnamediv> + <refname>grep</refname> + <refpurpose>acha correspondncias de um string em um vetor de + strings + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>row=grep(haystack,needle ) + [row,which]=grep(haystack,needle ) + row=grep(haystack,needle ,[flag]) + [row,which]=grep(haystack,needle ,[flag]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>haystack</term> + <listitem> + <para>vetor linha de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>needle</term> + <listitem> + <para>string ou vetor linha de strings . O(s) string(s) a serem + procurados em <literal>haystack.</literal> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>row</term> + <listitem> + <para>vetor de ndices: linha onde uma correspondncia foi + encontrada, ou matriz vazia se nenhuma ocorrncia tiver sido + encontrada + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>which</term> + <listitem> + <para>vetor de ndices: ndice do string needle encontrado, ou uma + matriz vazia, se nenhuma correspondncia tiver sido + encontrada + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>flag</term> + <listitem> + <para>caractere ("r" para expresso regular)</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para>Para cada entradada de haystack , grep procura se pelo menos um + string em needle corresponde a um substring. Os ndices das entradas de + haystack onde pelo menos uma entrada foi encontrada so retornados no + argumento row. O argumento opcional which fornece o ndice do primeiro + string de needle encontrado. Quando se usa o terceiro parmetro "r", + needle deve ser substitudo por uma expresso regular. Ento, grep vai + corresponder a haystack de acordo com as regras regulares + expressas. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +txt=['acha correspondncia em um string ou em um vetor de strings' + 'procura posio de um string em outro string' + 'Compara Strings']; + +grep(txt,'strings') +grep(txt,['strings' 'Strings']) + +[r,w]=grep(txt,['strings' 'Strings']) + +str = ["hat";"cat";"hhat";"chat";"hcat";"ccchat";"at";"dog"] + +grep(str,'/[hc]+at/','r') +grep(str,'/[hc]?at/','r') +grep(str,'/cat|dog/','r') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="strindex">strindex</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/isalphanum.xml b/modules/string/help/pt_BR/isalphanum.xml new file mode 100755 index 000000000..a1aae0b5e --- /dev/null +++ b/modules/string/help/pt_BR/isalphanum.xml @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="isalphanum" xml:lang="en"> + <refnamediv> + <refname>isalphanum</refname> + <refpurpose>verifica se os caracteres de um string so + alfanumricos + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = isalphanum(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>string</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>matriz de valores booleanos</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = isalphanum(str)</literal> retorna um array de mesmo + tamanho que str contendo valores lgicos %t (true) onde os elementos de + str so alfanumricos e %f (false) onde eles no so. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +s = 'A1,B2,C3'; +isalphanum(s) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="isletter">isletter</link> + </member> + <member> + <link linkend="isdigit">isdigit</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/isascii.xml b/modules/string/help/pt_BR/isascii.xml new file mode 100755 index 000000000..1f129103d --- /dev/null +++ b/modules/string/help/pt_BR/isascii.xml @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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: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="isascii" xml:lang="en"> + <refnamediv> + <refname>isascii</refname> + <refpurpose>verifica se um caractere do tipo 7-bit US-ASCII</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = isascii(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>string</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>uma matriz de booleanos</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = isascii(str)</literal> retorna verdadeiro (%T) se c + um cdigo 7-bit US-ASCII entre 0 e 0177 octal, inclusive. Caso contrrio, + retorna falso (%F). + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +letters = [115. 99. 105. 108. 97. 98.] +isascii(letters) +ascii(letters) +isascii('scilab') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="isalphanum">isalphanum</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/isdigit.xml b/modules/string/help/pt_BR/isdigit.xml new file mode 100755 index 000000000..209a4a3b0 --- /dev/null +++ b/modules/string/help/pt_BR/isdigit.xml @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="isdigit" xml:lang="en"> + <refnamediv> + <refname>isdigit</refname> + <refpurpose>checa se os caracteres de um string so nmeros entre 0 e + 9 + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = isdigit(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>string</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>matriz de valores booleanos</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = isdigit(str)</literal> retorna um array com mesmo + tamanho que str com valores %T (verdadeiro) onde os elementos de str so + dgitos de 0 a 9 e %F (falso) onde eles no so. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +s = 'A1,B2,C3'; +isdigit(s) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="isalphanum">isalphanum</link> + </member> + <member> + <link linkend="isletter">isletter</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/isletter.xml b/modules/string/help/pt_BR/isletter.xml new file mode 100755 index 000000000..b2ffce5fa --- /dev/null +++ b/modules/string/help/pt_BR/isletter.xml @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="isletter" xml:lang="en"> + <refnamediv> + <refname>isletter</refname> + <refpurpose>verifica se os caracteres de um string so letras do + alfabeto + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = isletter(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>string</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>matriz de booleanos</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = isletter(str)</literal> retorna um array de mesmo + tamanho que str com %t (verdadeiro) onde os elementos de str so letras do + alfabeto e %f (false) onde eles no so. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +s = 'A1,B2,C3'; +isletter(s) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="isalphanum">isalphanum</link> + </member> + <member> + <link linkend="isdigit">isdigit</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/isnum.xml b/modules/string/help/pt_BR/isnum.xml new file mode 100755 index 000000000..87a4d26c3 --- /dev/null +++ b/modules/string/help/pt_BR/isnum.xml @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="isnum" xml:lang="en"> + <refnamediv> + <refname>isnum</refname> + <refpurpose>testa se um string representa um nmero</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = isnum(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>um string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>matriz de booleanos</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = isnum(str)</literal>retorna %T se str representa um + nmero + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +isnum(['1' , .. + '-1.23' , .. + '+1e+23', .. + '1d+23' , .. + '%pi']) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="isletter">isletter</link> + </member> + <member> + <link linkend="isdigit">isdigit</link> + </member> + <member> + <link linkend="isalphanum">isalphanum</link> + </member> + </simplelist> + </refsection> + <refsection> + <title>Autores</title> + <simplelist type="vert"> + <member>P.M</member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/justify.xml b/modules/string/help/pt_BR/justify.xml new file mode 100755 index 000000000..584d28ee8 --- /dev/null +++ b/modules/string/help/pt_BR/justify.xml @@ -0,0 +1,95 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="justify" xml:lang="en"> + <refnamediv> + <refname>justify</refname> + <refpurpose>justifica um array de caracteres</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>Tj=justify(T,opt)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>T</term> + <listitem> + <para>matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>Tj</term> + <listitem> + <para>matriz de strings. O resultado justificado</para> + </listitem> + </varlistentry> + <varlistentry> + <term>opt</term> + <listitem> + <para>opo com possveis valores</para> + <variablelist> + <varlistentry> + <term>'r'</term> + <listitem> + <para>ou 'right' para justificao direita</para> + </listitem> + </varlistentry> + <varlistentry> + <term>'l'</term> + <listitem> + <para>ou 'left' para justificao esquerda</para> + </listitem> + </varlistentry> + <varlistentry> + <term>'c'</term> + <listitem> + <para>ou 'center' justificao centrada</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>justify</literal> justifica a coluna de uma matriz de + strings de acordo com a opo dada. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +t=['1234','x','adfdfgdfghfgj' + '1','354556','dgf' + 'sdfgd','','sdfsf']; + +justify(t,'l') +justify(t,'c') +justify(t,'r') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="length">length</link> + </member> + <member> + <link linkend="part">part</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/length.xml b/modules/string/help/pt_BR/length.xml new file mode 100755 index 000000000..45993ae94 --- /dev/null +++ b/modules/string/help/pt_BR/length.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) 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="length" xml:lang="en"> + <refnamediv> + <refname>length</refname> + <refpurpose>comprimento de um objeto</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqüência de Chamamento</title> + <synopsis>n=length(M)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parâmetros</title> + <variablelist> + <varlistentry> + <term>M</term> + <listitem> + <para>matriz (usual ou de polinômios ou de strings) ou lista</para> + </listitem> + </varlistentry> + <varlistentry> + <term>n</term> + <listitem> + <para>inteiro ou matriz de inteiros</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrição</title> + <para> + Para uma matriz usual ou de polinômios, <literal>n</literal> é o + inteiro igual ao número de linhas vezes o número de colunas de + <literal>M</literal>. (Também válido para <literal>M</literal> uma matriz + de booleanos) + </para> + <para>Para matrizes de strings (e, em particular, para um string) + <literal>length</literal> retorna em <literal>n</literal> os comprimentos + das entradas da matriz de strings <literal>M</literal>. + </para> + <para>O comprimento de uma lista é o número de elementos da lista (também + dado por <literal>size</literal>). + </para> + <para> + <literal>length('123')</literal> é <literal>3</literal>. + <literal>length([1,2;3,4])</literal> is <literal>4</literal>. + </para> + <para>AVISO : length para matrizes esparsas retorna o máximo das + dimensões, não o produto das dimensões. (exemplo : + length(sparse(eye(12,2))) retorna max(12,2), não 24) + </para> + <para>Utilize size(...,'*') para matrizes esparsas.</para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +length([123 ; 456 ]) +length(['olá mundo',SCI]) + ]]></programlisting> + </refsection> + <refsection> + <title>Ver Também</title> + <simplelist type="inline"> + <member> + <link linkend="size">size</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/part.xml b/modules/string/help/pt_BR/part.xml new file mode 100755 index 000000000..db861fba3 --- /dev/null +++ b/modules/string/help/pt_BR/part.xml @@ -0,0 +1,95 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="part" xml:lang="en"> + <refnamediv> + <refname>part</refname> + <refpurpose>extração de strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqüência de Chamamento</title> + <synopsis>[strings_out] = part(strings_in, v)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parâmetros</title> + <variablelist> + <varlistentry> + <term>strings_in, strings_out</term> + <listitem> + <para>matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>v</term> + <listitem> + <para>vetor linha de inteiros</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrição</title> + <para> + Seja <literal>s[k]</literal> o caractere <literal>k</literal> do + string <literal>s</literal> (ou o espaço em branco se <literal>k + >length(s) + </literal> + ). + </para> + <para> + <literal>part</literal> retorna <literal>strings_out</literal>, uma + matriz de strings, tal que <literal>strings_out(i,j)</literal> é o string + <literal>"s[v(1)]...s[v(n)]"</literal> ( + <literal>s=strings_in(i,j)</literal> ). + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +// retorna caracteres da posição 8 a 11 +part("Como usar ""part"" ?",8:11) + +// retorna caracteres da posição 2 a 4 para cada elemento +// caractere inexistente substituído por '' +c = part(['a','abc','abcd'],2:4) + +// retorna o caractere da posição 1 para cada elemento e adiciona caracteres da posição 4 a 7 de cada elemento +c = part(['abcdefg','hijklmn','opqrstu'],[1,4:7]); + +// retorna o caractere 4 para cada elemento, adiciona caracteres da posição 1 a 7 e adiciona o caractere da posição 4 para cada elemento +c = part(['abcdefg','hijklmn','opqrstu'],[4,1:7,4]); + +// retorna o caractere da posição 1, adiciona de novo o caractere da posição 1 e o caractere da posição 2 +c=part(['a','abc','abcd'],[1,1,2]) + +// a a a +part(['a','abc','abcd'],[1]) + +// aa aa aa +part(['a','abc','abcd'],[1,1]) + +// aa aab aab +part(['a','abc','abcd'],[1,1,2]) + ]]></programlisting> + </refsection> + <refsection> + <title>Ver Também</title> + <simplelist type="inline"> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="length">length</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/regexp.xml b/modules/string/help/pt_BR/regexp.xml new file mode 100755 index 000000000..1ab629295 --- /dev/null +++ b/modules/string/help/pt_BR/regexp.xml @@ -0,0 +1,105 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="regexp" xml:lang="en"> + <refnamediv> + <refname>regexp</refname> + <refpurpose>acha um string que corresponde ao string de expressão + regular + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqüência de Chamamento</title> + <synopsis>[start]=regexp(input,pattern,[flag]) + [start,end,match]=regexp(input,pattern,[flag]) + [start,end]=regexp(input,pattern,[flag]) + [start,end,match]=regexp(input,pattern,[flag]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Parâmetros</title> + <variablelist> + <varlistentry> + <term>input</term> + <listitem> + <para>string</para> + </listitem> + </varlistentry> + <varlistentry> + <term>pattern</term> + <listitem> + <para>string (sob regras de expressão regular)</para> + </listitem> + </varlistentry> + <varlistentry> + <term>start</term> + <listitem> + <para>o índice de início de cada substring de str que corresponde ao + padrão do string de expressão regular + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>end</term> + <listitem> + <para>o índice de fim de cada substring de str que corresponde ao + padrão do string de expressão regular + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>match</term> + <listitem> + <para>o texto de cada substring de que corresponde a + <literal>pattern</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>[flag]</term> + <listitem> + <para>'o' para correspondência com padrão uma vez</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrição</title> + <para>As regras de expressão regular são similares às da linguagem Perl. + Para uma introdução rápido , veja <ulink url="http://perldoc.perl.org/perlrequick.html">http://perldoc.perl.org/perlrequick.html</ulink>. + Para um tutorial mais profundo, veja <ulink url="http://perldoc.perl.org/perlretut.html">http://perldoc.perl.org/perlretut.html</ulink> + e para página de referência, veja <ulink url="http://perldoc.perl.org/perlre.html">http://perldoc.perl.org/perlre.html</ulink> + </para> + <para>Uma diferença para Perl é que correspondência entre posições, mas + não entre caracteres (por exemplo, com /^/ ou /(?=o)/) é uma + correspondência válida em Perl, mas não em Scilab. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +regexp('xabyabbbz','/ab*/','o') +regexp('a!','/((((((((((a))))))))))\041/') +regexp('ABCC','/^abc$/i') +regexp('ABC','/ab|cd/i') +[a b c]=regexp('XABYABBBZ','/ab*/i') + ]]></programlisting> + </refsection> + <refsection> + <title>Ver Também</title> + <simplelist type="inline"> + <member> + <link linkend="strindex">strindex</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/sci2exp.xml b/modules/string/help/pt_BR/sci2exp.xml new file mode 100755 index 000000000..9e29d2c69 --- /dev/null +++ b/modules/string/help/pt_BR/sci2exp.xml @@ -0,0 +1,114 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="sci2exp" xml:lang="en"> + <refnamediv> + <refname>sci2exp</refname> + <refpurpose>converte uma expresso para um string</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>t=sci2exp(a [,nam] [,lmax])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>a</term> + <listitem> + <para>expresso Scilab. Pode ser:</para> + <variablelist> + <varlistentry> + <term>-</term> + <listitem> + <para>constante,</para> + </listitem> + </varlistentry> + <varlistentry> + <term>-</term> + <listitem> + <para>polinomial</para> + </listitem> + </varlistentry> + <varlistentry> + <term>-</term> + <listitem> + <para>matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>-</term> + <listitem> + <para>lista</para> + </listitem> + </varlistentry> + <varlistentry> + <term>-</term> + <listitem> + <para>matriz de booleanos</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + <varlistentry> + <term>nam</term> + <listitem> + <para>string</para> + </listitem> + </varlistentry> + <varlistentry> + <term>t</term> + <listitem> + <para>vetor de strings, contm a expresso ou a instruo de + simulao. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>lmax</term> + <listitem> + <para>inteiro, contm o comprimento de linha mximo. O valor padro + 90, <literal>lmax=0</literal> indica ausncia de controle de + comprimento de linha, um nico string retornado + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>sci2exp</literal> converte expresso para um string de + instruo se <literal>nam</literal> for fornecido, ou para um string de + expresso. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +a=[1 2;3 4] +sci2exp(a,'aa') +sci2exp(a,'aa',0) +sci2exp(ssrand(2,2,2)) +sci2exp(poly([1 0 3 4],'s'),'fi') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="prettyprint">prettyprint</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strcat.xml b/modules/string/help/pt_BR/strcat.xml new file mode 100755 index 000000000..0a493ca2a --- /dev/null +++ b/modules/string/help/pt_BR/strcat.xml @@ -0,0 +1,109 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strcat" xml:lang="en"> + <refnamediv> + <refname>strcat</refname> + <refpurpose>concatena strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqüência de Chamamento</title> + <synopsis>txt=strcat(vector_of_strings [,string_added]) + txt=strcat(vector_of_strings [,string_added, ["flag"]]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Parâmetros</title> + <variablelist> + <varlistentry> + <term>vector_of_strings</term> + <listitem> + <para>vetor de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>string_added</term> + <listitem> + <para>string adicionado, o valor padrão é emptystr + <literal>""</literal> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>txt</term> + <listitem> + <para>string</para> + </listitem> + </varlistentry> + <varlistentry> + <term>"flag"</term> + <listitem> + <para>string ( "r" para retornar uma matriz linha, "c" para + retornar uma matriz coluna) + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrição</title> + <para> + <literal>txt=strcat(vector_of_strings)</literal> concatena strings : + <literal>txt=vector_of_strings(1)+...+vector_of_strings(n)</literal> + </para> + <para> + <literal>txt=strcat(vector_of_strings,string_added)</literal> + retorna + <literal>txt=vector_of_strings(1)+string_added+...+string_added+vector_of_strings(n)</literal>. + </para> + <para> + O símbolo de mais faz o mesmo: <literal>"a"+"b"</literal> é o mesmo + que <literal>strcat(["a","b"]).</literal> + </para> + <para>Se o tamanho de vector_of_strings for um, retorna + <literal>txt=vector_of_strings(1); </literal> + </para> + <para> + <literal>strcat('A','B')</literal> retorna 'A' , não 'AB' como + <literal>strcat(['A','B'])</literal> + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +strcat(string(1:10),',') +strcat(["a","b"]) +strcat(["a","b"],'|') +strcat('A') +strcat('A','B') +strcat(['A','B']) +strcat(['A','B'],'') + +m =["a" "b" ; "c" "d"]; +strcat(m, "r") +strcat(m, "", "r") +strcat(m, "", "c") + + ]]></programlisting> + </refsection> + <refsection> + <title>Ver Também</title> + <simplelist type="inline"> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="strings">strings</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strchr.xml b/modules/string/help/pt_BR/strchr.xml new file mode 100755 index 000000000..3279d7cb2 --- /dev/null +++ b/modules/string/help/pt_BR/strchr.xml @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strchr" xml:lang="en"> + <refnamediv> + <refname>strchr</refname> + <refpurpose>acha a primeira ocorrncia de um caractere em um + string + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = strchr(haystack,char)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>haystack</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>char</term> + <listitem> + <para>caractere</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = strchr(haystack,char)</literal> retorna a primeira + ocorrncia do caractere no string str. + </para> + <para>char deve ter as mesmas dimenses que haystack, ou apenas um + caractere. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +strchr('Este um string de amostra','s') +strchr(['Este um string de amostra','no scilab'],'s') +strchr(['Este um string de amostra','no scilab'],['s','a']) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="strrchr">strrchr</link> + </member> + <member> + <link linkend="strstr">strstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strcmp.xml b/modules/string/help/pt_BR/strcmp.xml new file mode 100755 index 000000000..6fb53f1de --- /dev/null +++ b/modules/string/help/pt_BR/strcmp.xml @@ -0,0 +1,87 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strcmp" xml:lang="en"> + <refnamediv> + <refname>strcmp</refname> + <refpurpose>compara strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = strcmp(string_one,string_two,[,'i'])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>string_one</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>string_two</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>'i'</term> + <listitem> + <para>parmetro para realizao de stricmp (caso independente), o + valor padro 's' + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>matrix</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = strcmp(string_one,string_two)</literal> retorna um + valor inteiro indicando a relao entre os strings. + </para> + <para>Um valor maior que zero indica que o primeiro caractere no + correspondente possui valor maior em <literal>string_one</literal> que em + <literal>string_two</literal> + </para> + <para>Um valor abaixo de zero indica o contrrio.</para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +TXT1 = ['scilab','SciLab';'Strcmp','STRcmp']; +TXT2 = ['ScIlAb','sciLab';'sTrCmP','StrCMP']; +strcmp(TXT1,TXT2) +strcmp(TXT1,'scilab') +strcmp(TXT1,'SciLab') +strcmp(TXT1,TXT2,'i') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="strcat">strcat</link> + </member> + <member> + <link linkend="strcmpi">strcmpi</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strcmpi.xml b/modules/string/help/pt_BR/strcmpi.xml new file mode 100755 index 000000000..548ec837b --- /dev/null +++ b/modules/string/help/pt_BR/strcmpi.xml @@ -0,0 +1,77 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strcmpi" xml:lang="en"> + <refnamediv> + <refname>strcmpi</refname> + <refpurpose>compara strings (caso independente)</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = strcmpi(string_one,string_two)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>string_one</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>string_two</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>matriz</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = strcmpi(string_one,string_two)</literal> retorna um + valor inteiro indicando a relao entre os strings. + </para> + <para>Um valor inteiro maior que zero indica que o primeiro caractere que + no corresponde possui valor maior em <literal>string_one</literal> que em + <literal>string_two</literal> + </para> + <para>Um valor negativo indica o contrrio.</para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +TXT1 = ['scilab','SciLab';'Strcmp','STRcmp']; +TXT2 = ['ScIlAb','sciLab';'sTrCmP','StrCMP']; +strcmpi(TXT1,TXT2) +strcmpi(TXT1,'scilab') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="strcat">strcat</link> + </member> + <member> + <link linkend="strcmp">strcmp</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strcspn.xml b/modules/string/help/pt_BR/strcspn.xml new file mode 100755 index 000000000..300aeac0a --- /dev/null +++ b/modules/string/help/pt_BR/strcspn.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) 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="strcspn" xml:lang="en"> + <refnamediv> + <refname>strcspn</refname> + <refpurpose>retorna extenso at um caractere em um string</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = strcspn(string_one,string_two)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>string_one</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>string_two</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>matriz</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = strcspn(string_one,string_two)</literal> l + string_one para a primeira ocorrncia de qualquer caractere que esteja em + string_two, retornando o nmero de caracteres de string_one lidos antes da + primeira ocorrncia. + </para> + <para>string_one deve ter as mesmas dimenses que string_two, ou + string_one deve ser um string. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +strcspn("fcba73","1234567890") +strcspn(["fcba73","f7cba73"],"1234567890") +strcspn(["fcba73","f7cba73"],["312","34567890"]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="strspn">strspn</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strindex.xml b/modules/string/help/pt_BR/strindex.xml new file mode 100755 index 000000000..6e8d85f9e --- /dev/null +++ b/modules/string/help/pt_BR/strindex.xml @@ -0,0 +1,129 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strindex" xml:lang="en"> + <refnamediv> + <refname>strindex</refname> + <refpurpose>procura posição de um string em outro</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqüência de Chamamento</title> + <synopsis>ind=strindex(haystack,needle,[flag]) + [ind,which]=strindex(haystack,needle,[flag]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Parâmetros</title> + <variablelist> + <varlistentry> + <term>haystack</term> + <listitem> + <para>string. O string onde se procurará por ocorrências de + <literal>needle </literal> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>needle</term> + <listitem> + <para>string ou vetor de strings . O(s) string(s) a serem procurados + em <literal>haystack</literal> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>ind</term> + <listitem> + <para>vetor de índices</para> + </listitem> + </varlistentry> + <varlistentry> + <term>which</term> + <listitem> + <para>vetor de índices</para> + </listitem> + </varlistentry> + <varlistentry> + <term>flag</term> + <listitem> + <para>string ("r" para expressão regular)</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrição</title> + <para> + <literal>strindex</literal> procura índices onde <literal>needle + (i) + </literal> + é encontrado em <literal>haystack</literal> + </para> + <para> + Para cada <literal>k</literal> existe um <literal>i</literal> tal + que <literal>part(haystack,ind(k)+(0:length(needle(i))-1))</literal> é o + mesmo string que <literal>needle(i)</literal>. Se o argumento + <literal>which</literal> for requerido, ele contém esses + <literal>i</literal>. Quando se usa o terceiro parâmetro "r", needle deve + ser um string de expressão regular. Então, strindex irá corresponder a + haystack de acordo com as regras regulares expressas. + </para> + <para> + <literal>strindex</literal> sem expressão regular é baseado no + algoritmo de Knuth-Morris-Pratt. + </para> + <para>Este algoritmo é mais poderoso que aquele usado no Scilab 4.x. Em + alguns casos especiais, o resultado pode ser diferente. + </para> + <para>Exemplo:</para> + <para>// Scilab 5.x</para> + <para>-->[k,w]=strindex('aab',['a','ab'])</para> + <para>w = 1. 1. 2. k = 1. 2. 2.</para> + <para>// scilab 4.x</para> + <para>-->[k,w]=strindex('aab',['a','ab'])</para> + <para>w = 1. 1. k = 1. 2.</para> + <para>As regras de expressão regular são similares às da linguagem Perl. + Para uma introdução rápida , ver <ulink url="http://perldoc.perl.org/perlrequick.html">http://perldoc.perl.org/perlrequick.html</ulink>. + Para um tutorial mais profundo , ver <ulink url="http://perldoc.perl.org/perlretut.html">http://perldoc.perl.org/perlretut.html</ulink> + e para a página de referência, ver <ulink url="http://perldoc.perl.org/perlre.html">http://perldoc.perl.org/perlre.html</ulink> + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +k=strindex('SCI/demos/scicos','/') +k=strindex('SCI/demos/scicos','SCI/') +k=strindex('SCI/demos/scicos','!') +k=strindex('aaaaa','aa') +k=strindex('SCI/demos/scicos',['SCI','sci']) +[k,w]=strindex('1+3*abc/2.33',['+','-','*','/']) +k=strindex('2' ,'/2(]*)?$\1/' ,'r') + ]]></programlisting> + </refsection> + <refsection> + <title>Ver Também</title> + <simplelist type="inline"> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="strings">strings</link> + </member> + <member> + <link linkend="regexp">regexp</link> + </member> + <member> + <link linkend="strsubst">strsubst</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/string.xml b/modules/string/help/pt_BR/string.xml new file mode 100755 index 000000000..5389fab45 --- /dev/null +++ b/modules/string/help/pt_BR/string.xml @@ -0,0 +1,121 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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: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="string" xml:lang="en"> + <refnamediv> + <refname>string</refname> + <refpurpose>converso para string (cadeia de caracteres)</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>string(x) + [out, in, text] = string(x) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>x</term> + <listitem> + <para>matriz de reais ou funo</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para>Converte uma matriz em uma matriz de strings.</para> + <para> + Se <literal>x</literal> uma funo <literal>[out, in, text] = + string(x) + </literal> + retorna trs vetores de strings : + <literal>out</literal> o vetor de variveis de sada, + <literal>in</literal> o vetor de variveis de entrada, e + <literal>text</literal> o vetor (coluna) do cdigo fonte da + funo. + </para> + <para> + Se <literal>x</literal> uma varivel <literal>lib</literal> + (bibiloteca), text um vetor coluna de strings. O primeiro elemento + contm o endereo do arquivo biblioteca e o outro o nome da funo que ela + define. + </para> + <para> + Strings so definidos como <literal>'string'</literal> (entre aspas + simples) ou <literal>"string"</literal> (entre aspas duplas); matrizes de + strings so definidas como matrizes de constantes. + </para> + <para>Concatenao de strings feita pela operao + <literal>+</literal>. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example">string(rand(2, 2)) + + deff("y = mymacro(x)", "y = x + 1") + [out, in, text] = string(mymacro) + x = 123.356; + disp("Result is " + string(x)); + + disp("/" + string(~%t) + "/"); + disp("/" + string(%i+1) + "/"); + disp("/" + string(int16(-123)) + "/"); + disp("/" + string(1 + %s + %s^3) + "/"); + + string(corelib) + + v = format(); + disp(string(%pi)) + format(24); + disp(string(%pi)) + format(v(2)) + </programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="part">part</link> + </member> + <member> + <link linkend="length">length</link> + </member> + <member> + <link linkend="quote">quote</link> + </member> + <member> + <link linkend="evstr">evstr</link> + </member> + <member> + <link linkend="execstr">execstr</link> + </member> + <member> + <link linkend="strsubst">strsubst</link> + </member> + <member> + <link linkend="strcat">strcat</link> + </member> + <member> + <link linkend="strindex">strindex</link> + </member> + <member> + <link linkend="sci2exp">sci2exp</link> + </member> + <member> + <link linkend="format">format</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strings.xml b/modules/string/help/pt_BR/strings.xml new file mode 100755 index 000000000..74e5b8ecb --- /dev/null +++ b/modules/string/help/pt_BR/strings.xml @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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: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="strings" xml:lang="en"> + <refnamediv> + <refname>strings</refname> + <refpurpose>objeto Scilab, strings (cadeias de caracteres)</refpurpose> + </refnamediv> + <refsection> + <title>Descrio</title> + <para> + Strings so definidos como <literal>'string'</literal> (entre aspas + simples) ou <literal>"string"</literal> (entre aspas duplas); matrizes de + strings so definidascomo matrizes constantes, como de uso. + </para> + <para> + A concatenao de dois strings feita por -<literal>+</literal> : + <literal>string1+string2</literal>. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +['esta',''; 'uma matriz','2x2'] +"matrix"=="mat"+"rix" + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="part">part</link> + </member> + <member> + <link linkend="length">length</link> + </member> + <member> + <link linkend="strcat">strcat</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/stripblanks.xml b/modules/string/help/pt_BR/stripblanks.xml new file mode 100755 index 000000000..1734e39e1 --- /dev/null +++ b/modules/string/help/pt_BR/stripblanks.xml @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="stripblanks" xml:lang="en"> + <refnamediv> + <refname>stripblanks</refname> + <refpurpose>retira espaos em branco (e tabulaes) no incio ou no fim de + strings + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>txt=stripblanks(txt[,tabs])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>txt</term> + <listitem> + <para>um string ou uma matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>tabs</term> + <listitem> + <para>se TRUE, retira tambm tabulaes (o valor padro + FALSE) + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para>stripblanks retira espaos em branco (e tabulaes) no incio ou no + fim de strings. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +a=' 123 '; +'!'+a+'!' +'!'+stripblanks(a)+'!' +a=[' 123 ',' xyz'] +strcat(stripblanks(a)) + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strncpy.xml b/modules/string/help/pt_BR/strncpy.xml new file mode 100755 index 000000000..cba5f2866 --- /dev/null +++ b/modules/string/help/pt_BR/strncpy.xml @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strncpy" xml:lang="en"> + <refnamediv> + <refname>strncpy</refname> + <refpurpose>copia caracteres de strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = strncpy(str1,num)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>str1</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>num</term> + <listitem> + <para>matriz. Nmeros mximos de caracteres a serem copiados da + fonte + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = strncpy(str1,num)</literal> copia os primeiros num + caracteres da fonte para o destino. + </para> + <para>num deve ter as mesmas dimenses que str1, ou deve ser um + nmero. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +strncpy('scilab',3) +strncpy(['scilab','SciLab';'strncpy','strstr'],3) +strncpy(['scilab','SciLab';'strncpy','strstr'],[1,2;3,4]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="strcat">strcat</link> + </member> + <member> + <link linkend="strcmp">strcmp</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strrchr.xml b/modules/string/help/pt_BR/strrchr.xml new file mode 100755 index 000000000..0f5f83936 --- /dev/null +++ b/modules/string/help/pt_BR/strrchr.xml @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strrchr" xml:lang="en"> + <refnamediv> + <refname>strrchr</refname> + <refpurpose>acha a ltima ocorrncia de um caractere em um + string + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = strrchr(str1,char)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>str1</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>char</term> + <listitem> + <para>caractere</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = strrchr(str1,char)</literal> retorna a ltima + ocorrncia de caractere no string str + </para> + <para>num deve ter as mesmas dimenses que str1, ou apenas um caracteres + char. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +strrchr('Este e um string de amostra','s') +strrchr(['Este e um string de amostra','no scilab'],'s') +strrchr(['Este e um string de amostra','no scilab'],['s','a']) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="strchr">strchr</link> + </member> + <member> + <link linkend="strstr">strstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strrev.xml b/modules/string/help/pt_BR/strrev.xml new file mode 100755 index 000000000..e309022b4 --- /dev/null +++ b/modules/string/help/pt_BR/strrev.xml @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strrev" xml:lang="en"> + <refnamediv> + <refname>strrev</refname> + <refpurpose>retorna um string invertido</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = strrev(str1)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>str1</term> + <listitem> + <para>um string ou uma matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>um string ou uma matriz de strings</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = strrev(str1)</literal> retorna o string em ordem + inversa + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +rev = strrev('This is a simple string') +strrev(rev) +strrev(['This is a simple string','scilab']) + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strsplit.xml b/modules/string/help/pt_BR/strsplit.xml new file mode 100755 index 000000000..b46d004d3 --- /dev/null +++ b/modules/string/help/pt_BR/strsplit.xml @@ -0,0 +1,77 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strsplit" xml:lang="en"> + <refnamediv> + <refname>strsplit</refname> + <refpurpose>divide um string em um vetor de strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>v = strsplit(str,ind)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>string</para> + </listitem> + </varlistentry> + <varlistentry> + <term>ind</term> + <listitem> + <para>um vetor de ndices estritamente crescentes no intervalo + <literal>[1 length(str)-1] </literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>v</term> + <listitem> + <para>o vetor coluna resultante de strings (dimenso + <literal>size(ind,'*')+1 </literal>). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>v= strsplit(str,ind)</literal> divide o string + <literal>str</literal> em um vetor de strings nos pontos dados pelos + ndices em <literal>ind</literal> (aps cada caractere apontado pelo + ndice em ind). + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +S='strsplit divide um string em um vetor de strings'; +strsplit(S,[15 25 30]) +ind=strindex(S,' ') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="strcat"> strcat</link> + </member> + <member> + <link linkend="tokens"> tokens</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strspn.xml b/modules/string/help/pt_BR/strspn.xml new file mode 100755 index 000000000..223f23d45 --- /dev/null +++ b/modules/string/help/pt_BR/strspn.xml @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strspn" xml:lang="en"> + <refnamediv> + <refname>strspn</refname> + <refpurpose>retorna a extenso do conjunto de caracteres no + string + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = strspn(str1,str2)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>str1</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>str2</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>matriz</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = strspn(str1,str2)</literal> retorna o comprimento da + poro inicial de str1 que consiste apenas de caracteres que fazem parte + de str2. + </para> + <para>str2 deve ter as mesmas dimenses que str2, ou str1 pode ser um + string. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +i = strspn("129o","1234567890"); +mprintf ("O comprimento do numero inicial e %d.\n",i); +i = strspn(["129o","130o"],["1234567890","130o"]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="strcspn">strcspn</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strstr.xml b/modules/string/help/pt_BR/strstr.xml new file mode 100755 index 000000000..fd7802e4a --- /dev/null +++ b/modules/string/help/pt_BR/strstr.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) 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="strstr" xml:lang="en"> + <refnamediv> + <refname>strstr</refname> + <refpurpose>localiza sub-strings</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = strstr(haystack,needle)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>haystack</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>needle</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = strstr(haystack,needle)</literal> retorna uma matriz + de strings comeando onde da primeira ocorrncia de needle em haystack at + o fim de haystack, ou '' se needle no parte de haystack. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +strstr('Este um string simples','simples') +strstr('Este um string simples','samples') +strstr(['Este um string simples','no scilab'],'') +strstr(['Este um string simples','no scilab'],['um','scilab']) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="strrchr">strrchr</link> + </member> + <member> + <link linkend="strchr">strchr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strsubst.xml b/modules/string/help/pt_BR/strsubst.xml new file mode 100755 index 000000000..af9916450 --- /dev/null +++ b/modules/string/help/pt_BR/strsubst.xml @@ -0,0 +1,97 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strsubst" xml:lang="en"> + <refnamediv> + <refname>strsubst</refname> + <refpurpose>substitui um string por outro dentro de um string</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqüência de Chamamento</title> + <synopsis>string_out=strsubst(string_in,searchStr,replaceStr) + string_out=strsubst(string_in,searchStr,replaceStr,[flag]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Parâmetros</title> + <variablelist> + <varlistentry> + <term>string_in</term> + <listitem> + <para>matriz de strings. Os strings nos quais serão procuradas + ocorrências de <literal>searchStr</literal> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>searchStr</term> + <listitem> + <para> + string a se procurar em <literal>string</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>replaceStr</term> + <listitem> + <para>string. O string de reposição</para> + </listitem> + </varlistentry> + <varlistentry> + <term>str_out</term> + <listitem> + <para>matriz de strings. O resultado da substituição em + <literal>searchStr</literal> por <literal>replaceStr</literal> em + <literal>string</literal> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>flag</term> + <listitem> + <para>string ("r" para expressão regular)</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrição</title> + <para> + <literal>strsubst</literal> substitui todas as ocorrências de + <literal>searchStr</literal> em <literal>string</literal> por + <literal>replaceStr</literal>. + </para> + <para>Quando se utiliza o quarto argumento "r", searchStr deve ser um + string de uma expressão regular. Então, strsubst o fará corresponder com + string e substituirá de acordo com a regra expressas regulares. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +strsubst('SCI/demos/scicos','SCI','.') +strsubst('SCI/demos/scicos','/',' ') +strsubst('2' ,'/2(]*)?$\1/' ,'0','r') + ]]></programlisting> + </refsection> + <refsection> + <title>Ver Também</title> + <simplelist type="inline"> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="strings">strings</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strtod.xml b/modules/string/help/pt_BR/strtod.xml new file mode 100755 index 000000000..e35a211db --- /dev/null +++ b/modules/string/help/pt_BR/strtod.xml @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="windows-1251"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strtod" xml:lang="en"> + <refnamediv> + <refname>strtod</refname> + <refpurpose>converte um string para um double</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqüência de Chamamento</title> + <synopsis>d = strtod(str) + [d,endstr] = strtod(str) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Parâmetros</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>string ou matriz de strings</para> + </listitem> + </varlistentry> + <varlistentry> + <term>d</term> + <listitem> + <para>escalar real ou matriz de reais</para> + </listitem> + </varlistentry> + <varlistentry> + <term>endstr</term> + <listitem> + <para>string ou matriz de strings (próximo caractere em str + após o valor numérico). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrição</title> + <para> + <literal>[d,endstr] = strtod(str)</literal> analisa o string str + interpretando o seu conteúdo como um número de ponto flutuante e + retorna o seu valor como um real. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +strtod('123.556Este é um real de amostra') +[d,endstr] = strtod('123.556Este é um real de amostra) +strtod(['123.556Este é um real de amostra','888.666 aqui']) +[d,endstr] =strtod(['123.556Este é um real de amostra','888.666 aqui']) + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/strtok.xml b/modules/string/help/pt_BR/strtok.xml new file mode 100755 index 000000000..02dc3581b --- /dev/null +++ b/modules/string/help/pt_BR/strtok.xml @@ -0,0 +1,78 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strtok" xml:lang="en"> + <refnamediv> + <refname>strtok</refname> + <refpurpose>divide um string em fichas (tokens)</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>res = strtok(str,delimiters)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>string</para> + </listitem> + </varlistentry> + <varlistentry> + <term>delimiters</term> + <listitem> + <para>string</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>string</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>res = strtok(str,delimiters)</literal> divide str em + fichas, que so seqncias de caracteres contguos separados por qualquer + um dos caracteres que fazem parte do string delimiters (delimiters = + delimitadores). + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +TOKENS = []; +token = strtok("Um string de ,,fichas e algumas fichas mais"," ,"); +TOKENS = [TOKENS,token]; +while( token <> '' ) + token = strtok(" ,"); + TOKENS = [TOKENS,token]; +end +disp(TOKENS); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="strrchr">strrchr</link> + </member> + <member> + <link linkend="strchr">strchr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/tokenpos.xml b/modules/string/help/pt_BR/tokenpos.xml new file mode 100755 index 000000000..1205ecc25 --- /dev/null +++ b/modules/string/help/pt_BR/tokenpos.xml @@ -0,0 +1,81 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="tokenpos" xml:lang="en"> + <refnamediv> + <refname>tokenpos</refname> + <refpurpose>retorna as posies das fichas (token) em um + string + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>kdf=tokenpos(str [,delimiter])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>string. O string onde se deve procurar fichas</para> + </listitem> + </varlistentry> + <varlistentry> + <term>delimiter</term> + <listitem> + <para>(opcional) um caractere ou vetor de caracteres. Os + delimitadores de fichas. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>kdf</term> + <listitem> + <para>matriz de duas colunas, a primeira coluna fornece os ndices + dos primeiros caracteres das fichas, a segunda fornece os ndices + dos ltimos caracteres das fichas. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>kdf=tokenpos(str [,delimiter]) </literal> busca as fichas + inclusas no string <literal>str</literal>. O valor padro de + <literal>delimiter</literal> [" ",<Tab>] onde <Tab> + <literal>ascii(9)</literal>. Retorna os ndices dos primeiros e ltimos + caracteres de cada ficha encontrada. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +str='Isto um string'; +kdf=tokenpos(str) +first=part(str,kdf(1,1):kdf(1,2)) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="strindex">strindex</link> + </member> + <member> + <link linkend="tokens">tokens</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/pt_BR/tokens.xml b/modules/string/help/pt_BR/tokens.xml new file mode 100755 index 000000000..aa01e0ba0 --- /dev/null +++ b/modules/string/help/pt_BR/tokens.xml @@ -0,0 +1,77 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="tokens" xml:lang="en"> + <refnamediv> + <refname>tokens</refname> + <refpurpose>retorna as fichas (tokens) de um string</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>T=tokens(str [,delimiter])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>string, o local de procura dos tokens</para> + </listitem> + </varlistentry> + <varlistentry> + <term>delimiter</term> + <listitem> + <para>(opcional) um caractere ou um vetor de caracteres. Os + delimitadores de fichas. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>T</term> + <listitem> + <para>vetor coluna de fichas encontradas</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + <literal>T=tokens(str [,delimiter]) </literal> procura pelos tokens + inclusos no string <literal>str</literal>. O padro de + <literal>delimiter</literal> [" ",<Tab>] onde <Tab> + <literal>ascii(9)</literal>. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +tokens('Isto um string') + +tokens('SCI/demos/scicos','/') + +tokens('y=a+b*2',['=','+','*']) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="strindex">strindex</link> + </member> + <member> + <link linkend="tokenpos">tokenpos</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/addchapter.sce b/modules/string/help/ru_RU/addchapter.sce new file mode 100755 index 000000000..ef3bc5339 --- /dev/null +++ b/modules/string/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("Строки",SCI+"/modules/string/help/ru_RU",%T); + diff --git a/modules/string/help/ru_RU/ascii.xml b/modules/string/help/ru_RU/ascii.xml new file mode 100755 index 000000000..7cd9d363a --- /dev/null +++ b/modules/string/help/ru_RU/ascii.xml @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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: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="ascii" xml:lang="ru"> + <refnamediv> + <refname>ascii</refname> + <refpurpose>преобразование в строку ASCII</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>a = ascii(txt) + txt = ascii(a) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>txt</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>a</term> + <listitem> + <para>вектор целочисленных значений: ASCII-коды.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Эта функция преобразует Scilab-строку в вектор ASCII-кодов (первые + 127 кодов являются ASCII) или вектор ASCII-кодов в Scilab-строки. + </para> + <para> + Если <varname>txt</varname> является матрицей строк, то + <code>ascii(txt)</code> эквивалентна <code>ascii(strcat(txt))</code>. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +ascii(["hello";"world"]) +ascii("scilab") +ascii([115 99 105 108 97 98]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="code2str">code2str</link> + </member> + <member> + <link linkend="str2code">str2code</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/asciimat.xml b/modules/string/help/ru_RU/asciimat.xml new file mode 100755 index 000000000..723e8cc65 --- /dev/null +++ b/modules/string/help/ru_RU/asciimat.xml @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 2004-2007 - INRIA - Vincent COUVERT + * + * 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="ru" xml:id="asciimat"> + <refnamediv> + <refname>asciimat</refname> + <refpurpose>преобразование матрицы строк в ASCII-коды и обратно</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis> + a = asciimat(txt) + txt = asciimat(a) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>txt</term> + <listitem> + <para> + символьная строка или матрица строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>a</term> + <listitem> + <para> + вектор или матрица целочисленных ASCII-кодов. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Эта функция преобразует Scilab-строку в ASCII-код или + матрицу ASCII-кодов в Scilab-строку. Аргумент на выходе + является матрицей, у которой то же количество строк, что и у + матрицы на входе, что является отличием от функции + <function>ascii</function>. + </para> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="ascii">ascii</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/blanks.xml b/modules/string/help/ru_RU/blanks.xml new file mode 100755 index 000000000..89bc3ff83 --- /dev/null +++ b/modules/string/help/ru_RU/blanks.xml @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="ru" xml:id="blanks"> + <refnamediv> + <refname>blanks</refname> + <refpurpose>создание строки из пробелов</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>txt = blanks(n)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>txt</term> + <listitem> + <para>отдельная символьная строка.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>n</term> + <listitem> + <para>целое число, количество пробелов.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>blanks(n)</code> даёт строку из <varname>n</varname> пробелов. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +disp(['xxx' blanks(20) 'yyy']) + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/char.xml b/modules/string/help/ru_RU/char.xml new file mode 100755 index 000000000..7499fbfc6 --- /dev/null +++ b/modules/string/help/ru_RU/char.xml @@ -0,0 +1,110 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 2008 - INRIA - Farid BELAHCENE + * + * 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="char" xml:lang="ru"> + <refnamediv> + <refname>char</refname> + <refpurpose>преобразует в массив символов</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>y=char(x) + y = char(st1, st2, st3,...) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>x</term> + <listitem> + <para> + cell-массив строковых значений или массив ASCII-кодов. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>st1, st2, st3</term> + <listitem> + <para>массивы строковых значений.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>y</term> + <listitem> + <para>вектор-столбец строковых значений.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <emphasis role="bold">Один входной аргумент:</emphasis> + </para> + <para> + Для заданного cell-массива строковых значений <varname>x</varname> данная функция + возвращает вектор строковых значений <varname>y</varname> в котором строки являются + конкатенированными элементами соответствующих строк cell-массива строковых значений. + </para> + <para> + Для заданного массива ASCII-кодов <varname>x</varname> данная функция + возвращает массив строковых значений <varname>y</varname>, соответствующих + ASCII-кодам. Если размеры <varname>x</varname> равны <literal>[n1, n2, n3, n4,...]</literal>, + то возвращаемое значение имеет те же размеры, что и входное значение за + исключением второго размера, т. е. размеры <varname>y</varname> равны + <literal>[n1, n3, n4,...]</literal>. + </para> + <para> + <emphasis role="bold">Более одного входного аргумента:</emphasis> + </para> + <para> + Для заданных массивов строковых значений <literal>st1, st2, st3,...</literal> эта функция + возвращает вектор строковых значений в котором строки являются конкатенированными + элементами соответствующих строк <literal>st1, st2, st3,...</literal>. В векторе + <varname>y</varname> всех строковые значения <literal>sti</literal> дополняются + пробелами чтобы получить ту же длину, что и максимальная длина <literal>sti</literal>. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +// Пример с гиперматрицей ASCII-кодов: +x=hypermat([4,2,3],61:84); +y=char(x) +size(x) +size(y) + +// Пример со множеством входных аргументов: +st1="zeros"; +st2=["one","two"]; +st3=["three"]; +y=char(st1,st2,st3) +size(y) + +//все строки строковых значений дополняются "пробелами" так, чтобы +//иметь одинаковую длину: 6 +length(y) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="ascii">ascii</link> + </member> + <member> + <link linkend="asciimat">asciimat</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/convstr.xml b/modules/string/help/ru_RU/convstr.xml new file mode 100755 index 000000000..c9af2aa7e --- /dev/null +++ b/modules/string/help/ru_RU/convstr.xml @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="ru" xml:id="convstr"> + <refnamediv> + <refname>convstr</refname> + <refpurpose>преобразование регистра</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>[y] = convstr(str, [flag])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str, y</term> + <listitem> + <para>матрица символьных строк.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>flag</term> + <listitem> + <para>необязательный символьный флаг с возможными значениями:</para> + <variablelist> + <varlistentry> + <term>'u'</term> + <listitem> + <para>для верхнего регистра;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>'l'</term> + <listitem> + <para>для нижнего регистра.</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Функция <function>convstr</function> преобразует матрицу строк + <varname>str</varname> в нижний регистр (для <varname>flag</varname> <literal>= "l"</literal>; + значение по умолчанию) или в верхний регистр (для + <varname>flag</varname> <literal>= "u"</literal>). + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +A=['this','is';'my','matrix']; +convstr(A,'u') + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/emptystr.xml b/modules/string/help/ru_RU/emptystr.xml new file mode 100755 index 000000000..7333ea97e --- /dev/null +++ b/modules/string/help/ru_RU/emptystr.xml @@ -0,0 +1,97 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="ru" xml:id="emptystr"> + <refnamediv> + <refname>emptystr</refname> + <refpurpose>формирование строки нулевой длины</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>s = emptystr() + s = emptystr(a) + s = emptystr(m, n) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>a</term> + <listitem> + <para> + матрица размером <literal>m</literal> на + <literal>n</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>s</term> + <listitem> + <para> + матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>m, n</term> + <listitem> + <para>целые числа.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Функция <function>emptystr</function> возвращает матрицу символьных + строк нулевой длины. + </para> + <para> + Без входного аргумента <function>emptystr</function> возвращает символьную строку нулевой длины. + </para> + <para> + С матрицей <varname>a</varname> в качестве входного аргумента + функция <function>emptystr</function> возвращает матрицу символьных + строк нулевой длины того же размера. + </para> + <para> + С двумя целочисленными аргументами функция <function>emptystr</function> + возвращает матрицу символьных строк нулевой длины размером + <varname>m</varname> на <varname>n</varname>. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +x=emptystr(); +for k=1:10 + x = x + ',' + string(k) + emptystr(1,k) + string(k) +end + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="part">part</link> + </member> + <member> + <link linkend="length">length</link> + </member> + <member> + <link linkend="string">string</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/eval.xml b/modules/string/help/ru_RU/eval.xml new file mode 100755 index 000000000..1129a3b9a --- /dev/null +++ b/modules/string/help/ru_RU/eval.xml @@ -0,0 +1,59 @@ +<?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="eval" xml:lang="ru"> + <refnamediv> + <refname>eval</refname> + <refpurpose>вычисление матрицы строк</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>[H] = eval(Z)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>Z</term> + <listitem> + <para>матрица символьных строк.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Функция <function>eval</function> возвращает вычисление матрицы символьных строк <varname>Z</varname>. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +a=1; +b=2; +Z=['a','sin(b)']; +eval(Z) //возвращает матрицу [1, 0.909]; + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="evstr">evstr</link> + </member> + <member> + <link linkend="execstr">execstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/evstr.xml b/modules/string/help/ru_RU/evstr.xml new file mode 100755 index 000000000..94ccf74a8 --- /dev/null +++ b/modules/string/help/ru_RU/evstr.xml @@ -0,0 +1,122 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * + * 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="evstr" xml:lang="ru"> + <refnamediv> + <refname>evstr</refname> + <refpurpose>вычисление выражений</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis> + H = evstr(Z) + [H, ierr] = evstr(Z) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>Z</term> + <listitem> + <para> + матрица символьных строк <varname>M</varname> или + <code>list(M,Subexp)</code> + </para> + <variablelist> + <varlistentry> + <term>M</term> + <listitem> + <para>матрица символьных строк.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>Subexp</term> + <listitem> + <para>вектор символьных строк.</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + <varlistentry> + <term>H</term> + <listitem> + <para>матрица.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>ierr</term> + <listitem> + <para>целое число, указатель ошибки.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Возвращает результат вычисления матрицы символьных строк + <varname>M</varname>. Каждый элемент матрицы должен определять + корректное Scilab-выражение. + </para> + <para> + Если вычисление выражения <varname>M</varname> ведёт к ошибке, то в + случае с одним возвращаемым значением, <code>H = evstr(M)</code>, + возникает ошибка как обычно. В случае с двумя возвращаемыми + значениями, <code>[H,ierr] = evstr(M)</code>, ошибки не возникает, + но возвращается номер ошибки в <varname>ierr</varname>. + </para> + <para> + Если <varname>Z</varname> - список, то <varname>Subexp</varname> - + вектор символьных строк, который определяет подвыражения, которые + вычисляются до вычисления <varname>M</varname>. К этим + подвыражениям следует обращаться как <literal>%(k)</literal> в + <varname>M</varname>, где <literal>k</literal> - это индекс + подвыражения в <varname>Subexp</varname>. + </para> + <para> + <code>evstr('a = 1')</code> не корректно (вместо этого используйте + функцию <function>execstr</function>). + </para> + <para> + <literal>Nan</literal>, <literal>NaN</literal> будут + интерпретироваться как <constant>%nan</constant>. + </para> + <para> + <literal>Inf</literal> будет интерпретироваться как <constant>%inf</constant>. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"> + a = 1; b = 2; + Z = ['a', 'b'] ; + evstr(Z) + Z = list(['%(1)','%(1)-%(2)'],['a+1','b+1']); + evstr(Z) + + evstr('NaN'), evstr('Inf') + //Вариант с двумя возвращаемыми значениями + [H, ierr] = evstr(Z) // ошибки нет + Z = ['a', 'b', 'c'] ;// переменная c не определена + [H, ierr] = evstr(Z) // error 4: Неизвестная переменная: c + </programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="execstr">execstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/grep.xml b/modules/string/help/ru_RU/grep.xml new file mode 100755 index 000000000..ba4d3efb1 --- /dev/null +++ b/modules/string/help/ru_RU/grep.xml @@ -0,0 +1,131 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="grep" xml:lang="ru"> + <refnamediv> + <refname>grep</refname> + <refpurpose>поиск соответствий строки в векторе строк</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>row = grep(haystack, needle ) + [row, which] = grep(haystack, needle ) + row = grep(haystack, needle, [flag]) + [row, which] = grep(haystack, needle, [flag]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>haystack</term> + <listitem> + <para>вектор-строка символьных строк.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>needle</term> + <listitem> + <para> + символьная строка или вектор-строка символьных строк. + Строка (строки), которая ищется в <varname>haystack</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>row</term> + <listitem> + <para> + вектор индексов: строка, где было найдено соответствие + или пустая матрица, если соответствие не найдено. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>which</term> + <listitem> + <para> + вектор индексов: индекс найденной строки + <varname>needle</varname> или пустая матрица, если + соответствия не найдено. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>flag</term> + <listitem> + <para> + символ (<literal>"r"</literal> для регулярного выражения). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Для каждого элемента <varname>haystack</varname> функция <function>grep</function> + ищет соответствие подстроки со строкой в <varname>needle</varname>. + Индекс элементов <varname>haystack</varname>, где было найдено + соответствие, возвращается в выходном аргументе + <varname>row</varname>. Необязательный выходной аргумент + <varname>which</varname> даёт индекс первого найденного строкового + значения в <varname>needle</varname>. + </para> + <para> + Когда используется третий параметр <varname>flag</varname><literal>="r"</literal>, + то ожидается, что <varname>needle</varname> будет строкой + регулярного выражения. В этом случае <function>grep</function> + использует <varname>needle</varname> в качестве регулярного + выражения и сравнивает его с <varname>haystack</varname> в + соответствии с правилами регулярного выражения. См. подробности по регулярным выражениям в функции <link linkend="regexp">regexp</link>. + </para> + </refsection> + <refsection> + <title>Пример №1</title> + <para> + В следующем примере мы ищем одну или две строки в тексте, который + хранится в переменной <varname>txt</varname>. + </para> + <programlisting role="example"><![CDATA[ +txt=['поиск соответствий строк в векторе строк' + 'поиск положения символьной строки в другой строке' + 'Сравнение Строк']; +grep(txt,'строк') +grep(txt,['строк' 'Строк']) +[r,w]=grep(txt,['строк' 'Строк']) + ]]></programlisting> + </refsection> + <refsection> + <title>Пример №2</title> + <para> + В следующем примере выполняется поиск с помощью регулярных выражений. + </para> + <programlisting role="example"><![CDATA[ +str = ["hat";"cat";"hhat";"chat";"hcat";"ccchat";"at";"dog"] +grep(str,'/[hc]+at/','r') +grep(str,'/[hc]?at/','r') +grep(str,'/cat|dog/','r') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="strindex">strindex</link> + </member> + <member> + <link linkend="regexp">regexp</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/isalphanum.xml b/modules/string/help/ru_RU/isalphanum.xml new file mode 100755 index 000000000..77f9e9ebe --- /dev/null +++ b/modules/string/help/ru_RU/isalphanum.xml @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="ru" xml:id="isalphanum"> + <refnamediv> + <refname>isalphanum</refname> + <refpurpose> + проверка того, что символы строки являются буквенно-цифровыми + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = isalphanum(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>символьная строка.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>матрица логических значений.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>res = isalphanum(str)</code> возвращает массив того же + размера, что и <varname>str</varname>, содержащий логические + значения <constant>%t</constant> (истина) там, где элементы + <varname>str</varname> являются буквенно-цифровыми, и логические + значения <constant>%f</constant> (ложь) там, где они не являются. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +s = 'A1,B2,C3'; +isalphanum(s) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="isletter">isletter</link> + </member> + <member> + <link linkend="isdigit">isdigit</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/isascii.xml b/modules/string/help/ru_RU/isascii.xml new file mode 100755 index 000000000..a4407b405 --- /dev/null +++ b/modules/string/help/ru_RU/isascii.xml @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="ru" xml:id="isascii"> + <refnamediv> + <refname>isascii</refname> + <refpurpose> + проверяет - является ли символ 7-битным US-ASCII-символом + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = isascii(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>символьная строка или массив целых чисел.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>матрица логических значений.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>res = isascii(str)</code> возвращает <constant>%t</constant> + (ИСТИНА), если элементы <varname>str</varname> соответствуют 7-битному + коду US-ASCII-символов между 0 и восьмеричным 0177 + включительно (или являются US-ASCII-символами). + В противном случае возвращает <constant>%f</constant> (ЛОЖЬ). + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +letters = [115. 99. 105. 108. 97. 98.] +isascii(letters) +ascii(letters) +isascii('scilab') +isascii('Сайлаб') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="isalphanum">isalphanum</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/isdigit.xml b/modules/string/help/ru_RU/isdigit.xml new file mode 100755 index 000000000..0c4661972 --- /dev/null +++ b/modules/string/help/ru_RU/isdigit.xml @@ -0,0 +1,72 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="ru" xml:id="isdigit"> + <refnamediv> + <refname>isdigit</refname> + <refpurpose> + проверка того, что символы в строке являются цифрами между 0 и 9 + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = isdigit(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>символьная строка.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>матрица логических значений.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <literal>res = isdigit(str)</literal> возвращает массив того же + размера, что и <varname>str</varname>, содержащий логическое + значение <constant>%t</constant> (ИСТИНА) там, где элементы + <varname>str</varname> являются цифрами, и логическое значение + <constant>%f</constant> (ЛОЖЬ) там, где они не являются. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +s = 'A1,B2,C3'; +isdigit(s) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="isalphanum">isalphanum</link> + </member> + <member> + <link linkend="isletter">isletter</link> + </member> + <member> + <link linkend="isnum">isnum</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/isletter.xml b/modules/string/help/ru_RU/isletter.xml new file mode 100755 index 000000000..e0701b27a --- /dev/null +++ b/modules/string/help/ru_RU/isletter.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) 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" +xml:lang="ru" xml:id="isletter"> + <refnamediv> + <refname>isletter</refname> + <refpurpose> + проверка того, что символы в строке являются буквами алфавита + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = isletter(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>символьная строка.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>матрица логических значений.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>res = isletter(str)</code> возвращает массив того же + размера, что и <varname>str</varname>, содержащий логическое + значение <constant>%t</constant> (ИСТИНА) там, где элементы + <varname>str</varname> являются буквами алфавита, и логическое + значение <constant>%f</constant> (ЛОЖЬ) там, где они не являются. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +s = 'A1,B2,C3'; +isletter(s) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="isalphanum">isalphanum</link> + </member> + <member> + <link linkend="isdigit">isdigit</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/isnum.xml b/modules/string/help/ru_RU/isnum.xml new file mode 100755 index 000000000..398d1f85d --- /dev/null +++ b/modules/string/help/ru_RU/isnum.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) 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" +xml:lang="ru" xml:id="isnum"> + <refnamediv> + <refname>isnum</refname> + <refpurpose> + проверка того, что строка представляет число + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = isnum(str)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>матрица логических значений.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>res = isnum(str)</code> возвращает <constant>%t</constant>, если <varname>str</varname> представляет число. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +isnum(['1' , .. + '-1.23' , .. + '+1e+23', .. + '1d+23' , .. + 'A' , .. + '%pi']) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="isletter">isletter</link> + </member> + <member> + <link linkend="isdigit">isdigit</link> + </member> + <member> + <link linkend="isalphanum">isalphanum</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/justify.xml b/modules/string/help/ru_RU/justify.xml new file mode 100755 index 000000000..e2284e994 --- /dev/null +++ b/modules/string/help/ru_RU/justify.xml @@ -0,0 +1,103 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- +* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +* Copyright (C) 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" + xml:lang="ru" xml:id="justify"> + <refnamediv> + <refname>justify</refname> + <refpurpose>выравнивание массива символов</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>Tj = justify(T, opt)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>T</term> + <listitem> + <para>матрица символьных строк.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>Tj</term> + <listitem> + <para> + матрица символьных строк. Результат выравнивания. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>opt</term> + <listitem> + <para> + символьная опция с возможными значениями: + </para> + <variablelist> + <varlistentry> + <term>'r' или 'right'</term> + <listitem> + <para>для выравнивания по правому краю;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>'l' или 'left'</term> + <listitem> + <para>для выравнивания по левому краю;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>'c' или 'center'</term> + <listitem> + <para>для выравнивания по центру.</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Функция <function>justify</function> выравнивает столбцы матрицы строк в соответствии с заданной опцией <varname>opt</varname>. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +t=['1234','x','adfdfgdfghfgj' + '1','354556','dgf' + 'sdfgd','','sdfsf']; +justify(t,'l') +justify(t,'c') +justify(t,'r') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="length">length</link> + </member> + <member> + <link linkend="part">part</link> + </member> + </simplelist> + </refsection> +</refentry> + diff --git a/modules/string/help/ru_RU/length.xml b/modules/string/help/ru_RU/length.xml new file mode 100755 index 000000000..d1916dddf --- /dev/null +++ b/modules/string/help/ru_RU/length.xml @@ -0,0 +1,118 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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" xml:id="length" xml:lang="ru"> + <refnamediv> + <refname>length</refname> + <refpurpose>длина объекта</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>n = length(M)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>M</term> + <listitem> + <para> + матрица (обычная или полиномиальная или символьных строк) или список. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>n</term> + <listitem> + <para> + целое число или матрица целочисленных значений. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Для обычной или полиномиальной матрицы <varname>n</varname> является целым числом, равным произведению количества строк и + столбцов <varname>M</varname>. (Также корректно и для матрицы + логических значений <varname>M</varname>). + </para> + <para> + Для матриц, составленных из символьных строк (и, в частности, для + символьной строки), функция <function>length</function> возвращает + в <varname>n</varname> длину элементов матрицы символьных строк + <varname>M</varname>. + </para> + <para> + Длина списка - это количество элементов в списке (также получается с помощью функции <function>size</function>). + </para> + <para> + Длина матричноориентированного списка (mlist) равна по умолчанию + количеству элементов в этом списке, но вы можете перегрузить <function>length</function> (см. пример). + </para> + <para> + <code>length('123')</code> равно <literal>3</literal>. + <code>length([1,2;3,4])</code> равно <literal>4</literal>. + </para> + <para> + <warning> + Внимание: <function>length</function> разрежённой матрицы + возвращает максимум размерностей а не произведение + размерностей. (Например: <code>length(sparse(eye(12,2)))</code> + возвращает <code>max(12,2)</code> а не <literal>24</literal>). + Пожалуйста, к разрежённой матрице применяйте + <literal>size(...,'*')</literal>. + </warning> + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +length([123 ; 456 ]) +length(['hello world',SCI]) + ]]></programlisting> + <programlisting role="example"><![CDATA[ +a = mlist(["myMlistT" "field1" "field2"],"aexample","bexampleb"); +length(a) +// возвращает 3, поведение по умолчанию, если length не перегружена для +// матричноориентированного списка (mlist) + +// создадим функцию перегрузки для матричноориентированного списка типа +// myMlistT +function r = %myMlistT_length(M) + r = length(M.field1) +endfunction +length(a) +// returns 8 result of length(a.field1) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="size">size</link> + </member> + </simplelist> + </refsection> + <refsection> + <title>История</title> + <revhistory> + <revision> + <revnumber>5.4.0</revnumber> + <revremark> + Эта функция позволяет перегрузку для типа mlist. + </revremark> + </revision> + </revhistory> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/part.xml b/modules/string/help/ru_RU/part.xml new file mode 100755 index 000000000..a3d828b7a --- /dev/null +++ b/modules/string/help/ru_RU/part.xml @@ -0,0 +1,100 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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" xml:id="part" xml:lang="ru"> + <refnamediv> + <refname>part</refname> + <refpurpose>выделение строк</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>[strings_out] = part(strings_in, v)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>strings_in, strings_out</term> + <listitem> + <para>матрицы символьных строк.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>v</term> + <listitem> + <para>вектор-строка целочисленных значений.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Обозначим как <literal>s[k]</literal> <literal>k</literal>-тый + символ строки <literal>s</literal> (или пробел, если + <literal>k >length(s)</literal>). + </para> + <para> + Функция <function>part</function> возвращает + <varname>strings_out</varname>, матрицу символьных строк, такую, что + <literal>strings_out(i,j)</literal> является строкой + <literal>"s[v(1)]...s[v(n)]"</literal> + (<literal>s = strings_in(i,j)</literal>). + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +// возвращает символы с 8 по 11 +part("Как использовать ""part"" ?",8:11) + +// возвращает символы с 2 по 4 для каждого элемента +// отсутствие символов заменяется '' +c = part(['a','abc','abcd'],2:4) + +// возвращает 1-й символ каждого элемента плюс символы с +// 4 по 7 каждого элемента +c = part(['abcdefg','hijklmn','opqrstu'],[1,4:7]); + +// возвращает 4-й символ каждого элемента, плюс символы с +// 1 по 7 и плюс 4-й символ каждого элемента +c = part(['abcdefg','hijklmn','opqrstu'],[4,1:7,4]); + +// возвращает 1-й символ плюс ещё 1-й символ и плюс +// 2-й символ +c=part(['a','abc','abcd'],[1,1,2]) + +// a a a +part(['a','abc','abcd'],[1]) + +// aa aa aa +part(['a','abc','abcd'],[1,1]) + +// aa aab aab +part(['a','abc','abcd'],[1,1,2]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="strsplit">strsplit</link> + </member> + <member> + <link linkend="length">length</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/regexp.xml b/modules/string/help/ru_RU/regexp.xml new file mode 100755 index 000000000..10d9600b0 --- /dev/null +++ b/modules/string/help/ru_RU/regexp.xml @@ -0,0 +1,162 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- +* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +* Copyright (C) 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" +xml:id="regexp" xml:lang="ru"> + <refnamediv> + <refname>regexp</refname> + <refpurpose> + поиск подстроки, соответствующей строке регулярного выражения + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis> + [start] = regexp(input, pattern, [flag]) + [start, end] = regexp(input, pattern, [flag]) + [start, end, match] = regexp(input, pattern, [flag]) + [start, end, match, foundString] = regexp(input, pattern, [flag]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>input</term> + <listitem> + <para>символьная строка.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>pattern</term> + <listitem> + <para> + символьная строка, шаблон (по правилам регулярных + выражений). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>start</term> + <listitem> + <para> + начальный индекс каждой подстроки + <varname>input</varname>, которая соответствует строке + регулярного выражения <varname>pattern</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>end</term> + <listitem> + <para> + конечный индекс каждой подстроки + <varname>input</varname>, которая соответствует строке + регулярного выражения <varname>pattern</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>match</term> + <listitem> + <para> + текст каждой подстроки <varname>input</varname>, + которая соответствует шаблону <varname>pattern</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>foundString</term> + <listitem> + <para> + текст, выделенный элементами шаблона, заключёнными в скобки. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>[flag]</term> + <listitem> + <para> + <literal>'o'</literal> для одного соответствия шаблону. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Правила регулярного выражения схожи с языком Perl. Для быстрого старта смотрите + <ulink url="http://perldoc.perl.org/perlrequick.html">http://perldoc.perl.org/perlrequick.html</ulink>. + Для более глубокого изучения смотрите + <ulink url="http://perldoc.perl.org/perlretut.html">http://perldoc.perl.org/perlretut.html</ulink>, + а для справки смотрите + <ulink url="http://perldoc.perl.org/perlre.html">http://perldoc.perl.org/perlre.html</ulink>. + </para> + <para> + Отличие от Perl заключается в том, что соответствие позиции, а не символа (например, с <literal>/^/</literal> или + <literal>/(?=o)/</literal>) будет успешным в Perl, но не в Scilab'е. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +regexp('xabyabbbz','/ab*/','o') +regexp('a!','/((((((((((a))))))))))\041/') +regexp('ABCC','/^abc$/i') +regexp('ABC','/ab|cd/i') +[a b c]=regexp('XABYABBBZ','/ab*/i') + +piString="3.14" +[a,b,c,piStringSplit]=regexp(piString,"/(\d+)\.(\d+)/") +disp(piStringSplit(1)) +disp(piStringSplit(2)) + +[a,b,c,d]=regexp('xabyabbbz','/ab(.*)b(.*)/') +size(d) + +// получение имени сервера из URL +myURL="http://www.scilab.org/download/"; +[a,b,c,d]=regexp(myURL,'@^(?:http://)?([^/]+)@i') + +str='foobar: 2012'; +// использование именованных элементов шаблона +[a,b,c,d]=regexp(str,'/(?P<name>\w+): (?P<digit>\d+)/') +d(1)=="foobar" +d(2)=="2012" + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="strindex">strindex</link> + </member> + </simplelist> + </refsection> + <refsection> + <title>История</title> + <revhistory> + <revision> + <revnumber>5.4.0</revnumber> + <revremark> + Добавлен новый выходной аргумент, foundString, для + получения соответствий элементам шаблона. + </revremark> + </revision> + </revhistory> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/sci2exp.xml b/modules/string/help/ru_RU/sci2exp.xml new file mode 100755 index 000000000..d8f7c9947 --- /dev/null +++ b/modules/string/help/ru_RU/sci2exp.xml @@ -0,0 +1,116 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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" xml:lang="ru" xml:id="sci2exp"> + <refnamediv> + <refname>sci2exp</refname> + <refpurpose>преобразует выражение в строку</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>t = sci2exp(a [,nam] [,lmax])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>a</term> + <listitem> + <para>Scilab-выражение, может быть:</para> + <variablelist> + <varlistentry> + <term>- </term> + <listitem> + <para>константа;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>- </term> + <listitem> + <para>полином;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>- </term> + <listitem> + <para>матрица строк;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>- </term> + <listitem> + <para>список;</para> + </listitem> + </varlistentry> + <varlistentry> + <term>- </term> + <listitem> + <para>матрица логических значений.</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + <varlistentry> + <term>nam</term> + <listitem> + <para>символьная строка.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>t</term> + <listitem> + <para> + вектор строк, содержащих выражение или инструкцию. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>lmax</term> + <listitem> + <para> + целое число, содержащее максимальную длину строки. По + умолчанию оно равно <literal>90</literal>, + <literal>lmax=0</literal> указывает, что нет управления + длиной отдельной строки; возвращается одиночная строка. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Функция <function>sci2exp</function> преобразует выражение в строку + инструкции, если указано <varname>nam</varname> или в строку + выражения. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +a=[1 2;3 4] +sci2exp(a,'aa') +sci2exp(a,'aa',0) +sci2exp(ssrand(2,2,2)) +sci2exp(poly([1 0 3 4],'s'),'fi') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="prettyprint">prettyprint</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strcat.xml b/modules/string/help/ru_RU/strcat.xml new file mode 100755 index 000000000..af352171f --- /dev/null +++ b/modules/string/help/ru_RU/strcat.xml @@ -0,0 +1,119 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- +* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +* Copyright (C) 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" xml:id="strcat" xml:lang="ru"> + <refnamediv> + <refname>strcat</refname> + <refpurpose>связывает символьные строки</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis> + txt = strcat(strings [,string_added]) + txt = strcat(strings [,string_added, ["flag"]]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>strings</term> + <listitem> + <para>вектор или матрица строк.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>string_added</term> + <listitem> + <para> + добавляемая строка, значение по умолчанию равно символьной строке нулевой длины <literal>""</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>txt</term> + <listitem> + <para>строка.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>"flag"</term> + <listitem> + <para> + символьное значение (<literal>"r"</literal> для связки строк в матрице <varname>strings</varname>, + <literal>"c"</literal> для связки столбцов в матрице <varname>strings</varname>). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>txt = strcat(strings)</code> связывает символьные строки: + <literal>txt = strings(1) + ... + strings(n)</literal>. + </para> + <para> + <code>txt = strcat(strings, string_added)</code> возвращает + <literal>txt = strings(1) + string_added + ... + string_added + strings(n)</literal>. + </para> + <para> + Символ "плюс" делает то же самое, что <code>strcat(["a","b"]).</code>. + </para> + <para> + Если размер <varname>strings</varname> равен единице, то + возвращается <code>txt = strings(1)</code>; + </para> + <para> + <code>strcat('A','B')</code> возвращает <literal>'A'</literal> а не + <literal>'AB'</literal>, как <code>strcat(['A','B'])</code>. + </para> + <para> + Если <varname>strings</varname> является матрицей строк, то + <code>strcat(strings,"",'r')</code> возвращает вектор-строку строк. + Элементы вектор-строки является результатом связки строк. + <code>strcat(strings,"",'c')</code> возвращает вектор-столбец + строк. Элементы вектор-столбца являются результатом связки столбцов. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +strcat(string(1:10),',') +strcat(["a","b"]) +strcat(["a","b"],'|') +strcat('A') +strcat('A','B') +strcat(['A','B']) +strcat(['A','B'],'') + +m =["a" "b" ; "c" "d"]; +strcat(m, "r") +strcat(m, "", "r") +strcat(m, "", "c") + +strcat(m, "_and_", "r") +strcat(m, "_and_", "c") + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="strings">strings</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strchr.xml b/modules/string/help/ru_RU/strchr.xml new file mode 100755 index 000000000..4b2ceb0ad --- /dev/null +++ b/modules/string/help/ru_RU/strchr.xml @@ -0,0 +1,81 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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" xml:lang="ru" xml:id="strchr"> + <refnamediv> + <refname>strchr</refname> + <refpurpose> + поиск первого появления символа в строке + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = strchr(haystack, char)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>haystack</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>char</term> + <listitem> + <para>символ.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>res = strchr(haystack, char)</code> возвращает первое появление символа в строке <varname>haystack</varname>. + </para> + <para> + <varname>char</varname> должна содержать только одиночную строку или + столько строк, сколько их в <varname>haystack</varname> (каждая из + которых длиной в один символ). + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +strchr('Это строка примера','р') +strchr(['Это строка примера','в системе Scilab'],'е') +strchr(['Это строка примера','в системе Scilab'],['р','с']) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="strrchr">strrchr</link> + </member> + <member> + <link linkend="strstr">strstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strcmp.xml b/modules/string/help/ru_RU/strcmp.xml new file mode 100755 index 000000000..d074d0cc1 --- /dev/null +++ b/modules/string/help/ru_RU/strcmp.xml @@ -0,0 +1,103 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strcmp" xml:lang="ru"> + <refnamediv> + <refname>strcmp</refname> + <refpurpose>сравнение символьных строк</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = strcmp(string_one, string_two, ['i'])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>string_one</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>string_two</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>'i'</term> + <listitem> + <para> + необязательный параметр для того, чтобы сделать <function>strcmpi</function> + (независимость от регистра), значение по умолчанию - <literal>'s'</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>матрица целочисленных значений.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>res = strcmp(string_one, string_two)</code> (или + <code>res = strcmp(string_one, string_two, 's')</code>) возвращает + интегральное значение, указывающее отношение между строками. + </para> + <para> + Значение больше нуля указывает, что первый символ, который не соответствует, имеет большее значение в <varname>string_one</varname>, чем в <varname>string_two</varname>, а значение меньше нуля указывает обратное. + </para> + <para> + Значение равное нулю указывает на то, что + <varname>string_one</varname> и <varname>string_two</varname> + равны. + </para> + <para> + <code>res = strcmp(string_one, string_two, 'i')</code> возвращает + <literal>0</literal>, если <varname>string_one</varname> равна + <varname>string_two</varname> (независимо от регистра), а + <literal>1</literal> указывает обратное. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +TXT1 = ['scilab','SciLab';'Strcmp','STRcmp']; +TXT2 = ['ScIlAb','sciLab';'sTrCmP','StrCMP']; +strcmp(TXT1,TXT2) +strcmp(TXT1,'scilab') +strcmp(TXT1,'SciLab') +strcmp(TXT1,TXT2,'i') +strcmp(TXT1,TXT2,'s') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="strcat">strcat</link> + </member> + <member> + <link linkend="strcmpi">strcmpi</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strcmpi.xml b/modules/string/help/ru_RU/strcmpi.xml new file mode 100755 index 000000000..5eafb654b --- /dev/null +++ b/modules/string/help/ru_RU/strcmpi.xml @@ -0,0 +1,83 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="ru" xml:id="strcmpi"> + <refnamediv> + <refname>strcmpi</refname> + <refpurpose> + сравнение символьных строк (без учёта регистра) + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = strcmpi(string_one, string_two)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>string_one</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>string_two</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>матрица целочисленных значений.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>res = strcmpi(string_one, string_two)</code> возвращает + интегральное значение, указывающее отношение между строками. + </para> + <para> + Значение равно <literal>0</literal>, если + <varname>string_one</varname> равна <varname>string_two</varname> + (независимо от регистра), а <literal>1</literal> указывает обратное. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +TXT1 = ['scilab','SciLab';'Strcmp','STRcmp']; +TXT2 = ['ScIlAb','sciLab';'sTrCmP','StrCMP']; +strcmpi(TXT1,TXT2) +strcmpi(TXT1,'scilab') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="strcat">strcat</link> + </member> + <member> + <link linkend="strcmp">strcmp</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strcspn.xml b/modules/string/help/ru_RU/strcspn.xml new file mode 100755 index 000000000..0991bd43c --- /dev/null +++ b/modules/string/help/ru_RU/strcspn.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) 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="strcspn" xml:lang="ru"> + <refnamediv> + <refname>strcspn</refname> + <refpurpose>получение интервала до символа в строке</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = strcspn(string_one, string_two)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>string_one</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>string_two</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>матрица.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>res = strcspn(string_one,string_two)</code> сканирует + <varname>string_one</varname> на предмет первого появления любого из + символов, которые являются частью <varname>string_two</varname>, + возвращая количество символов <varname>string_one</varname>, прочитанных до этого первого появления. + </para> + <para> + <varname>string_two</varname> должна быть того же размера, что и <varname>string_one</varname>, либо <varname>string_two</varname> + должна быть строкой. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +strcspn("fcba73","1234567890") +strcspn(["fcba73","f7cba73"],"1234567890") +strcspn(["fcba73","f7cba73"],["312","34567890"]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="strspn">strspn</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strindex.xml b/modules/string/help/ru_RU/strindex.xml new file mode 100755 index 000000000..f7f7c24ec --- /dev/null +++ b/modules/string/help/ru_RU/strindex.xml @@ -0,0 +1,138 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strindex" xml:lang="ru"> + <refnamediv> + <refname>strindex</refname> + <refpurpose> + поиск положения символьной строки в другой строке + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis> + ind = strindex(haystack, needle, [flag]) + [ind, which] = strindex(haystack, needle, [flag]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>haystack</term> + <listitem> + <para> + символьная строка. Строка, в которой ищутся совпадения + с <varname>needle</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>needle</term> + <listitem> + <para> + символьная строка или вектор символьных строк. Строка + (строки) которая ищется в <varname>haystack</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>ind</term> + <listitem> + <para>вектор индексов.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>which</term> + <listitem> + <para>вектор индексов.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>flag</term> + <listitem> + <para> + строка (<literal>"r"</literal> для регулярного + выражения). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Функция <function>strindex</function> ищет индексы, где найдена + <literal>needle(i)</literal> в <varname>haystack</varname>. + </para> + <para> + Для каждого <literal>k</literal> существует такая + <literal>i</literal>, что <code>part(haystack,ind(k)+(0:length(needle(i))-1))</code> + является той же самой строкой, что и <literal>needle(i)</literal>. + Если указан аргумент <varname>which</varname>, то он содержит эти + <literal>i</literal>. Когда используется третий параметр + <literal>"r"</literal>, то <varname>needle</varname> должна быть + строкой регулярного выражения, и тогда + <function>strindex</function> будет сравнивать её с + <varname>haystack</varname> по правилам регулярного выражения. + </para> + <para> + <function>strindex</function> без аргумента регулярного выражения + основывается на алгоритме Кнута-Морриса-Пратта [Knuth-Morris-Pratt]. + </para> + <para> + Этот алгоритм более мощный, чем тот, который использовался в Scilab + 4.x. В некоторых частных случаях результат может быть различным. + </para> + <para>Пример:</para> + <para>// Scilab 5.x</para> + <para>-->[k,w]=strindex('aab',['a','ab'])</para> + <para>w = 1. 1. 2. k = 1. 2. 2.</para> + <para>// Scilab 4.x</para> + <para>-->[k,w]=strindex('aab',['a','ab'])</para> + <para>w = 1. 1. k = 1. 2.</para> + <para> + Правила регулярного выражения сходны с языком Perl. Для быстрого старта см.<ulink url="http://perldoc.perl.org/perlrequick.html">http://perldoc.perl.org/perlrequick.html</ulink>. + Для более глубокого изучения см. <ulink url="http://perldoc.perl.org/perlretut.html">http://perldoc.perl.org/perlretut.html</ulink>, + а для справки см. <ulink url="http://perldoc.perl.org/perlre.html">http://perldoc.perl.org/perlre.html</ulink>. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +k=strindex('SCI/demos/scicos','/') +k=strindex('SCI/demos/scicos','SCI/') +k=strindex('SCI/demos/scicos','!') +k=strindex('aaaaa','aa') +k=strindex('SCI/demos/scicos',['SCI','sci']) +[k,w]=strindex('1+3*abc/2.33',['+','-','*','/']) +k=strindex('2' ,'/2(]*)?$\1/' ,'r') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="strings">strings</link> + </member> + <member> + <link linkend="regexp">regexp</link> + </member> + <member> + <link linkend="strsubst">strsubst</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/string.xml b/modules/string/help/ru_RU/string.xml new file mode 100755 index 000000000..407cc33db --- /dev/null +++ b/modules/string/help/ru_RU/string.xml @@ -0,0 +1,140 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * Copyright (C) DIGITEO - 2012 - Allan CORNET + * + * 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="string" xml:lang="ru"> + <refnamediv> + <refname>string</refname> + <refpurpose>преобразование в строку</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis> + string(x) + [out, in, text] = string(x) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>x</term> + <listitem> + <para> + булева, комплексная, вещественная, целочисленная, полиномиальная матрица, неявный размер, библиотека или функция. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Функция <function>string</function> преобразует матрицу + <varname>x</varname> в матрицу строк. + </para> + <para> + Если <varname>x</varname> является функцией, то <code>[out, in, text] = string(x)</code> возвращает три вектора строк: <varname>out</varname> - вектор выходных переменных, <varname>in</varname> - вектор входных переменных, а <varname>text</varname> - вектор (вектор-столбец) исходного кода функции. + </para> + <para> + Если <varname>x</varname> является переменной типа + <literal>lib</literal> (библиотекой), то <varname>text</varname> + является вектор-столбцом символьных строк. Первый элемент содержит + путь до файла библиотеки, а другой - имя функций, которые она + определяет. + </para> + <para> + Символьные строки определяются как <literal>'строка'</literal> + (между одинарными кавычками) или <literal>"строка"</literal> (между + двойными кавычками); матрицы строк определяются как обычные матрицы констант. + </para> + <para> + Связка строк выполняется с помощью операции <literal>+</literal>. + </para> + <para> + Для комплексной, вещественной, целочисленной, полиномиальной + матрицы вывод функции <function>string</function> управляется с + помощью функции <link linkend="format">format</link> (см. примеры). + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"> + string(rand(2, 2)) + + deff("y = mymacro(x)", "y = x + 1") + [out, in, text] = string(mymacro) + x = 123.356; + disp("Результат равен " + string(x)); + + disp("/" + string(~%t) + "/"); + disp("/" + string(%i+1) + "/"); + disp("/" + string(int16(-123)) + "/"); + disp("/" + string(1 + %s + %s^3) + "/"); + + string(corelib) + + v = format(); + disp(string(%pi)) + format(24); + disp(string(%pi)) + format(v(2)) + string(1:4:$) + </programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="part">part</link> + </member> + <member> + <link linkend="length">length</link> + </member> + <member> + <link linkend="quote">кавычка</link> + </member> + <member> + <link linkend="evstr">evstr</link> + </member> + <member> + <link linkend="execstr">execstr</link> + </member> + <member> + <link linkend="strsubst">strsubst</link> + </member> + <member> + <link linkend="strcat">strcat</link> + </member> + <member> + <link linkend="strindex">strindex</link> + </member> + <member> + <link linkend="sci2exp">sci2exp</link> + </member> + <member> + <link linkend="format">format</link> + </member> + </simplelist> + </refsection> + <refsection> + <title>История</title> + <revhistory> + <revision> + <revnumber>5.4.0</revnumber> + <revremark> + implicit size type managed as input argument. + </revremark> + </revision> + </revhistory> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strings.xml b/modules/string/help/ru_RU/strings.xml new file mode 100755 index 000000000..1a228718a --- /dev/null +++ b/modules/string/help/ru_RU/strings.xml @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="ru" xml:id="strings"> + <refnamediv> + <refname>strings</refname> + <refpurpose>объект Scilab'а, символьные строки</refpurpose> + </refnamediv> + <refsection> + <title>Описание</title> + <para> + Строки определяются как <code>'строка'</code> (между одинарными + кавычками) или <code>"строка"</code> (между двойными кавычками); + матрицы строк определяются как обычные матрицы. + </para> + <para> + Связка двух строк выполняется с помощью операции <literal>+</literal>: <code>string1 + string2</code>. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +['это','матрица'; 'размером','2x2'] +"матрица"=="мат"+"рица" + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="part">part</link> + </member> + <member> + <link linkend="length">length</link> + </member> + <member> + <link linkend="strcat">strcat</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/stripblanks.xml b/modules/string/help/ru_RU/stripblanks.xml new file mode 100755 index 000000000..0ffa2b0d0 --- /dev/null +++ b/modules/string/help/ru_RU/stripblanks.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) 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="ru" xml:id="stripblanks"> + <refnamediv> + <refname>stripblanks</refname> + <refpurpose> + отсекает пробелы (и табуляцию) в начале и в конце строк + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>txt = stripblanks(txt[,tabs])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>txt</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>tabs</term> + <listitem> + <para> + логическое значение, если <constant>%t</constant>, то + символы табуляции также будут отсечены (значение по умолчанию - <constant>%f</constant>). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Функция <function>stripblanks</function> отсекает пробелы (и табуляцию) в начале и конце строк. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +a=' 123 '; +'!'+a+'!' +'!'+stripblanks(a)+'!' +a=[' 123 ',' xyz'] +strcat(stripblanks(a)) + +a = msprintf("\t \tПривет, мир!\t\t") +strcat(stripblanks(a,%f)+'?') +strcat(stripblanks(a,%t)+'?') + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strncpy.xml b/modules/string/help/ru_RU/strncpy.xml new file mode 100755 index 000000000..ff9fbd63b --- /dev/null +++ b/modules/string/help/ru_RU/strncpy.xml @@ -0,0 +1,85 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="ru" xml:id="strncpy"> + <refnamediv> + <refname>strncpy</refname> + <refpurpose>копирование символов из строк</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = strncpy(str1, num)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str1</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>num</term> + <listitem> + <para> + целое число или матрица целых чисел, максимальное + количество символов, которые нужно скопировать из + исходника. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>res = strncpy(str1, num)</code> копирует первые + <varname>num</varname> символов из исходника <varname>str1</varname> + в назначение <varname>res</varname>. + </para> + <para> + <varname>num</varname> должен быть тех же размеров, что и + <varname>str1</varname>, либо <varname>num</varname> должен быть + целым числом. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +strncpy('scilab',3) +strncpy(['scilab','SciLab';'strncpy','strstr'],3) +strncpy(['scilab','SciLab';'strncpy','strstr'],[1,2;3,4]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="strcat">strcat</link> + </member> + <member> + <link linkend="strcmp">strcmp</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strrchr.xml b/modules/string/help/ru_RU/strrchr.xml new file mode 100755 index 000000000..35dbbdb98 --- /dev/null +++ b/modules/string/help/ru_RU/strrchr.xml @@ -0,0 +1,82 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="ru" xml:id="strrchr"> + <refnamediv> + <refname>strrchr</refname> + <refpurpose> + поиск последнего появления символа в строке + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = strrchr(str1, char)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str1</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>char</term> + <listitem> + <para>символ или матрица символов.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>res = strrchr(str1, char)</code> возвращает последнее + появление символа <varname>char</varname> в строке + <varname>str1</varname>. + </para> + <para> + <varname>char</varname> должен иметь те же размеры, что и + <varname>str1</varname>, либо он должен быть только одним символом. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +strrchr('Это строка примера','р') +strrchr(['Это строка примера','в системе Scilab'],'е') +strrchr(['Это строка примера','в системе Scilab'],['р','с']) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="strchr">strchr</link> + </member> + <member> + <link linkend="strstr">strstr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strrev.xml b/modules/string/help/ru_RU/strrev.xml new file mode 100755 index 000000000..dddea3f47 --- /dev/null +++ b/modules/string/help/ru_RU/strrev.xml @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="ru" xml:id="strrev"> + <refnamediv> + <refname>strrev</refname> + <refpurpose>возвращает перевёрнутую строку</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = strrev(str1)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str1</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>res = strrev(str1)</code> возвращает перевёрнутую строку. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +rev = strrev('Это простая строка') +strrev(rev) +strrev(['Это простая строка','scilab']) + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strsplit.xml b/modules/string/help/ru_RU/strsplit.xml new file mode 100755 index 000000000..36ea1aae0 --- /dev/null +++ b/modules/string/help/ru_RU/strsplit.xml @@ -0,0 +1,164 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strsplit" xml:lang="ru"> + <refnamediv> + <refname>strsplit</refname> + <refpurpose>деление строки на вектор строк</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis> + v = strsplit(str,ind) + [v, matched_separators] = strsplit(str) + [v, matched_separators] = strsplit(str, matrix_of_strings, limit) + [v, matched_separators] = strsplit(str, regexp_pattern, limit) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>символьная строка, которую следует разделить.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>ind</term> + <listitem> + <para> + вектор индексов в строго возрастающем порядке в интервале <literal>[1 length(str)-1]</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>v</term> + <listitem> + <para> + результирующий вектор-столбец строк (размер ><literal>size(ind,'*')+1</literal>). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>matched_separators</term> + <listitem> + <para> + вектор-столбец совпавших разделителей. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>matrix_of_strings</term> + <listitem> + <para> + матрица строк, которые ищутся в <varname>str</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>regexp_pattern</term> + <listitem> + <para>шаблон регулярного выражения.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>limit</term> + <listitem> + <para>максимальный предел элементов.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>v= strsplit(str, ind)</code> делит строку + <varname>str</varname> на вектор строк в местах, указанных с + помощью индексов <varname>ind</varname> (после каждого символа, + на который указывает индекс в <varname>ind</varname>). + </para> + <para> + <code>strsplit(str)</code> возвращает то же, что и + <code>strsplit(str,1:length(str)-1).</code> + </para> + <para> + <code>strsplit(str, regexp_pattern, limit)</code> возвращает вектор + строк, каждая из которых является подстрокой из + <varname>str</varname>, сформированной делением + <varname>str</varname> на интервалы, сформированные шаблоном + регулярного выражения, чувствительного к регистру. + </para> + <para> + Если есть <literal>n</literal> совпадений с шаблоном, то + возвращённый массив будет содержать <literal>n+1</literal> + элементов. + </para> + <para> + Например, если нет совпадений с шаблоном, то будет возвращён массив + только с одним элементом. Конечно это так же будет и в случае, + когда <varname>str</varname> пустая. + </para> + <para> + Если установлен предел <varname>limit</varname>, то возвращённый + массив будет содержать максимальное разрешённое количество + элементов с последним элементом, содержащим весь остаток строки. + </para> + <para> + <code>strsplit(str, matrix_of_strings, limit)</code> делит + <varname>str</varname> любое количество элементов. Это позволяет + пользователям, не знающим регулярные выражения, делить по разным + разделителям. + </para> + <para> + Если вызывается <code>strsplit()</code> со вторым выходным + аргументом, то возвращается вектор-столбец совпавших разделителей. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +S='strsplit делит строку на вектор строк'; +strsplit(S,[15 21 25]) +ind=strindex(S,' ') + +[r_1, r_2] = strsplit("abcd") + +[r_1, r_2] = strsplit("root:x:0:0:root:/root:/bin/bash",":",5) + +[r_1, r_2] = strsplit("abc,def:ijk,:lmo","/:|,/") + +[r_1, r_2] = strsplit("abc,def:ijk,:lmo",[":";","]) + +strsplit("abcdef2ghijkl3mnopqr6stuvw7xyz","/\d+/") + +[r_1, r_2] = strsplit("abcdef2ghijkl3mnopqr6stuvw7xyz","/\d+/",2) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="part"> part</link> + </member> + <member> + <link linkend="strcat"> strcat</link> + </member> + <member> + <link linkend="tokens"> tokens</link> + </member> + <member> + <link linkend="regexp"> regexp</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strspn.xml b/modules/string/help/ru_RU/strspn.xml new file mode 100755 index 000000000..d039b3925 --- /dev/null +++ b/modules/string/help/ru_RU/strspn.xml @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strspn" xml:lang="ru"> + <refnamediv> + <refname>strspn</refname> + <refpurpose>получение интервала набора символов в строке</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = strspn(str1, str2)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str1</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>str2</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>матрица символьных строк.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>res = strspn(str1, str2)</code> возвращает длину начальной + части <varname>str1</varname>, которая состоит только из символов, + которые являются частью <varname>str2</varname>. + </para> + <para> + <varname>str2</varname> должна иметь те же размеры, что и <varname>str1</varname>, либо <varname>str2</varname> должна быть строкой. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +i = strspn("129th","1234567890"); +mprintf ("Длина исходного номера: %d.\n",i); +i = strspn(["129th","130th"],["1234567890","130t"]) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="strcspn">strcspn</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strstr.xml b/modules/string/help/ru_RU/strstr.xml new file mode 100755 index 000000000..62b11c746 --- /dev/null +++ b/modules/string/help/ru_RU/strstr.xml @@ -0,0 +1,81 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strstr" xml:lang="ru"> + <refnamediv> + <refname>strstr</refname> + <refpurpose>обнаружение подстроки</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = strstr(haystack, needle)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>haystack</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>needle</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>res = strstr(haystack, needle)</code> возвращает матрицу строк + начиная от того места, где в <varname>haystack</varname> впервые + встретилась <varname>needle</varname> и до конца + <varname>haystack</varname>, либо <literal>''</literal>, если + <varname>needle</varname> не является частью <varname>haystack</varname>. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +strstr('Это простая строка','простая') +strstr('Это простая строка','пример') +strstr(['Это простая строка','в scilab'],'в') +strstr(['Это строка для примера','в scilab'],['а','scilab']) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="strrchr">strrchr</link> + </member> + <member> + <link linkend="strchr">strchr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strsubst.xml b/modules/string/help/ru_RU/strsubst.xml new file mode 100755 index 000000000..5f91105f4 --- /dev/null +++ b/modules/string/help/ru_RU/strsubst.xml @@ -0,0 +1,109 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strsubst" xml:lang="ru"> + <refnamediv> + <refname>strsubst</refname> + <refpurpose> + замена одной символьной строки другой + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis> + string_out = strsubst(string_in, searchStr, replaceStr) + string_out = strsubst(string_in, searchStr, replaceStr, [flag]) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>string_in</term> + <listitem> + <para> + матрица символьных строк. Строки, в которых ищутся + совпадения с <varname>searchStr</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>searchStr</term> + <listitem> + <para> + символьная строка. Строка, которая ищется в + <varname>string_in</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>replaceStr</term> + <listitem> + <para> + Символьная строка. Строка замены. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>string_out</term> + <listitem> + <para> + матрица символьных строк. Результат замены строки <varname>searchStr</varname> строкой + <varname>replaceStr</varname> в <varname>string_in</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>flag</term> + <listitem> + <para> + символ (<literal>"r"</literal> для регулярного выражения). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Функция <function>strsubst</function> заменяет все совпадения со + строкой <varname>searchStr</varname> в матрице строк + <varname>string_in</varname> строкой <varname>replaceStr</varname>. + </para> + <para> + Когда используется четвёртый параметр <literal>"r"</literal>, то + строка <varname>searchStr</varname> должна быть регулярным + выражением. Тогда <function>strsubst</function> будет будет + сопоставлять её с <varname>string_in</varname> и заменять в + соответствии с правилами регулярных выражений. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +strsubst('SCI/demos/scicos','SCI','.') +strsubst('SCI/demos/scicos','/',' ') +strsubst('2' ,'/2(]*)?$\1/' ,'0','r') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="string">string</link> + </member> + <member> + <link linkend="strings">strings</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strtod.xml b/modules/string/help/ru_RU/strtod.xml new file mode 100755 index 000000000..a95a806eb --- /dev/null +++ b/modules/string/help/ru_RU/strtod.xml @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="strtod" xml:lang="ru"> + <refnamediv> + <refname>strtod</refname> + <refpurpose> + преобразование строки в число удвоенной точности + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis> + d = strtod(str) + [d, endstr] = strtod(str) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para> + символьная строка или матрица символьных строк. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>d</term> + <listitem> + <para> + вещественное число или матрица вещественных чисел. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>endstr</term> + <listitem> + <para> + символьная строка или матрица символьных строк + (следующий символ в <varname>str</varname> после + числового значения). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>[d, endstr] = strtod(str)</code> анализирует строки + <varname>str</varname>, интерпретируя их содержимое как числа с + плавающей запятой, и возвращает их значения в виде вещественных + чисел. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +strtod('123.556Это вещественное число для примера') +[d,endstr] = strtod('123.556Это вещественное число для примера') +strtod(['123.556This is a sample real','888.666 здесь']) +[d,endstr] =strtod(['123.556Это вещественное число для примера','888.666 здесь']) + ]]></programlisting> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/strtok.xml b/modules/string/help/ru_RU/strtok.xml new file mode 100755 index 000000000..ede33e85d --- /dev/null +++ b/modules/string/help/ru_RU/strtok.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) 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="ru" xml:id="strtok"> + <refnamediv> + <refname>strtok</refname> + <refpurpose>разделение строки на лексемы</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>res = strtok(str, delimiters)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para>символьная строка.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>delimiters</term> + <listitem> + <para>символьная строка, разделители</para> + </listitem> + </varlistentry> + <varlistentry> + <term>res</term> + <listitem> + <para>символьная строка.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + Последовательность вызовов <code>res = strtok(str, delimiters)</code> + этой функции делит строку <varname>str</varname> на лексемы, которые + являются непрерывными последовательностями символов, разделённых + любым из тех символов, которые входят в разделители + <varname>delimiters</varname>. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +TOKENS = []; +token = strtok("Строка лексем (токенов) - последовательностей ,,символов и ещё немного лексем"," ,"); +TOKENS = [TOKENS,token]; +while( token <> '' ) + token = strtok(" ,"); + TOKENS = [TOKENS,token]; +end +disp(TOKENS); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="strrchr">strrchr</link> + </member> + <member> + <link linkend="strchr">strchr</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/tokenpos.xml b/modules/string/help/ru_RU/tokenpos.xml new file mode 100755 index 000000000..96aeb89b2 --- /dev/null +++ b/modules/string/help/ru_RU/tokenpos.xml @@ -0,0 +1,84 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) 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="ru" xml:id="tokenpos"> + <refnamediv> + <refname>tokenpos</refname> + <refpurpose> + возвращает положение лексем в символьной строке + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>kdf = tokenpos(str [,delimiter])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para> + символьная строка. Строка в которой ищутся лексемы. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>delimiter</term> + <listitem> + <para> + (необязательный) символ или вектор символов. Разделители лексем. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>kdf</term> + <listitem> + <para> + матрица из двух столбцов; первый столбец даёт индекс + начала лексемы, второй даёт индекс последнего символа + лексемы. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>kdf = tokenpos(str [,delimiter]) </code> ищет лексемы, + содержащиеся в строке <varname>str</varname>. Значение разделителя <varname>delimiter</varname> по умолчанию <literal>[" ",<Tab>]</literal>, + где <literal><Tab></literal> стоит вместо + <code>ascii(9)</code>. Эта функция возвращает индексы первого и + последнего символов каждой найденной лексемы. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +str = 'Это символьная строка.'; +kdf = tokenpos(str) +first = part(str, kdf(1,1):kdf(1,2)) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="strindex">strindex</link> + </member> + <member> + <link linkend="tokens">tokens</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/string/help/ru_RU/tokens.xml b/modules/string/help/ru_RU/tokens.xml new file mode 100755 index 000000000..e08b8f4b0 --- /dev/null +++ b/modules/string/help/ru_RU/tokens.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) 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="ru" xml:id="tokens"> + <refnamediv> + <refname>tokens</refname> + <refpurpose>возвращает лексемы символьной строки</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Последовательность вызова</title> + <synopsis>T = tokens(str [,delimiter])</synopsis> + </refsynopsisdiv> + <refsection> + <title>Аргументы</title> + <variablelist> + <varlistentry> + <term>str</term> + <listitem> + <para> + символьная строка. Строка в которой ищутся лексемы. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>delimiter</term> + <listitem> + <para> + (необязательный) символ или вектор символов. Разделители лексем. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>T</term> + <listitem> + <para> + вектор-столбец найденных лексем. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Описание</title> + <para> + <code>T = tokens(str [,delimiter])</code> ищет лексемы, содержащиеся + в строке <varname>str</varname>. Значение разделителя + <varname>delimiter</varname> по умолчанию <literal>[" ",<Tab>]</literal>, + где <literal><Tab></literal> стоит вместо <code>ascii(9)</code>. + </para> + </refsection> + <refsection> + <title>Примеры</title> + <programlisting role="example"><![CDATA[ +tokens('Это символьная строка.') +tokens('SCI/demos/scicos','/') +tokens('y=a+b*2',['=','+','*']) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Смотрите также</title> + <simplelist type="inline"> + <member> + <link linkend="strindex">strindex</link> + </member> + <member> + <link linkend="tokenpos">tokenpos</link> + </member> + </simplelist> + </refsection> +</refentry> |