1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
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>
|