File: maxima_16.html

package info (click to toggle)
maxima 5.47.0-9
  • links: PTS
  • area: main
  • in suites: forky, sid
  • size: 193,104 kB
  • sloc: lisp: 434,678; fortran: 14,665; tcl: 10,990; sh: 4,577; makefile: 2,763; ansic: 447; java: 328; python: 262; perl: 201; xml: 60; awk: 28; sed: 15; javascript: 2
file content (221 lines) | stat: -rw-r--r-- 10,388 bytes parent folder | download | duplicates (2)
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Maxima 5.47.0 Manual: Functions and Variables for Strings</title>

<meta name="description" content="Maxima 5.47.0 Manual: Functions and Variables for Strings">
<meta name="keywords" content="Maxima 5.47.0 Manual: Functions and Variables for Strings">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link href="maxima_toc.html#Top" rel="start" title="Top">
<link href="maxima_423.html#Function-and-Variable-Index" rel="index" title="Function and Variable Index">
<link href="maxima_toc.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="maxima_14.html#Strings" rel="up" title="Strings">
<link href="maxima_17.html#Constants" rel="next" title="Constants">
<link href="maxima_15.html#Introduction-to-Strings" rel="previous" title="Introduction to Strings">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
body {color: black; background: white;  margin-left: 8%; margin-right: 13%;
      font-family: "FreeSans", sans-serif}
h1 {font-size: 150%; font-family: "FreeSans", sans-serif}
h2 {font-size: 125%; font-family: "FreeSans", sans-serif}
h3 {font-size: 100%; font-family: "FreeSans", sans-serif}
a[href] {color: rgb(0,0,255); text-decoration: none;}
a[href]:hover {background: rgb(220,220,220);}
div.textbox {border: solid; border-width: thin; padding-top: 1em;
    padding-bottom: 1em; padding-left: 2em; padding-right: 2em}
div.titlebox {border: none; padding-top: 1em; padding-bottom: 1em;
    padding-left: 2em; padding-right: 2em; background: rgb(200,255,255);
    font-family: sans-serif}
div.synopsisbox {
    border: none; padding-top: 1em; padding-bottom: 1em; padding-left: 2em;
    padding-right: 2em; background: rgb(255,220,255);}
pre.example {border: 1px solid rgb(180,180,180); padding-top: 1em;
    padding-bottom: 1em; padding-left: 1em; padding-right: 1em;
    background-color: rgb(238,238,255)}
div.spacerbox {border: none; padding-top: 2em; padding-bottom: 2em}
div.image {margin: 0; padding: 1em; text-align: center}
div.categorybox {border: 1px solid gray; padding-top: 1em; padding-bottom: 1em;
    padding-left: 1em; padding-right: 1em; background: rgb(247,242,220)}
img {max-width:80%; max-height: 80%; display: block; margin-left: auto; margin-right: auto}

-->
</style>

<link rel="icon" href="figures/favicon.ico">
<script src="https://polyfill.io/v3/polyfill.min.js?features=es6>"></script>
<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Functions-and-Variables-for-Strings"></a>
<div class="header">
<p>
Previous: <a href="maxima_15.html#Introduction-to-Strings" accesskey="p" rel="previous">Introduction to Strings</a>, Up: <a href="maxima_14.html#Strings" accesskey="u" rel="up">Strings</a> &nbsp; [<a href="maxima_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="maxima_423.html#Function-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Functions-and-Variables-for-Strings-1"></a>
<h4 class="subsection">5.2.2 Functions and Variables for Strings</h4>

<a name="concat"></a><a name="Item_003a-DataTypes_002fdeffn_002fconcat"></a><dl>
<dt><a name="index-concat"></a>Function: <strong>concat</strong> <em>(<var>arg_1</var>, <var>arg_2</var>, &hellip;)</em></dt>
<dd>
<p>Concatenates its arguments.  The arguments must evaluate to atoms.  The return
value is a symbol if the first argument is a symbol and a string otherwise.
</p>
<p><code>concat</code> evaluates its arguments.  The single quote <code>'</code> prevents
evaluation.
</p>
<p>See also <code><a href="#sconcat">sconcat</a></code>, that works on non-atoms, too, <code><a href="maxima_378.html#simplode">simplode</a></code>,
<code><a href="#string">string</a></code> and <code><a href="maxima_378.html#eval_005fstring">eval_string</a></code>.
For complex string conversions see also <code><a href="maxima_376.html#printf">printf</a></code>.
</p>
<div class="example">
<pre class="example">(%i1) y: 7$
(%i2) z: 88$
(%i3) concat (y, z/2);
(%o3)                          744
(%i4) concat ('y, z/2);
(%o4)                          y44
</pre></div>

<p>A symbol constructed by <code>concat</code> may be assigned a value and appear in
expressions.  The <code><a href="maxima_40.html#g_t_003a_003a">::</a></code> (double colon) assignment operator evaluates its
left-hand side.
</p>
<div class="example">
<pre class="example">(%i5) a: concat ('y, z/2);
(%o5)                          y44
(%i6) a:: 123;
(%o6)                          123
(%i7) y44;
(%o7)                          123
(%i8) b^a;
                               y44
(%o8)                         b
(%i9) %, numer;
                               123
(%o9)                         b
</pre></div>

<p>Note that although <code>concat (1, 2)</code> looks like a number, it is a string.
</p>
<div class="example">
<pre class="example">(%i10) concat (1, 2) + 3;
(%o10)                       12 + 3
</pre></div>

<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Expressions">Expressions</a>
&middot;<a href="maxima_424.html#Category_003a-Strings">Strings</a>
&middot;</div></dd></dl>

<a name="sconcat"></a><a name="Item_003a-DataTypes_002fdeffn_002fsconcat"></a><dl>
<dt><a name="index-sconcat"></a>Function: <strong>sconcat</strong> <em>(<var>arg_1</var>, <var>arg_2</var>, &hellip;)</em></dt>
<dd>
<p>Concatenates its arguments into a string.  Unlike <code><a href="#concat">concat</a></code>, the
arguments do <i>not</i> need to be atoms.
</p>
<p>See also <code><a href="#concat">concat</a></code>, <code><a href="maxima_378.html#simplode">simplode</a></code>, <code><a href="#string">string</a></code> and <code><a href="maxima_378.html#eval_005fstring">eval_string</a></code>.
For complex string conversions see also <code><a href="maxima_376.html#printf">printf</a></code>.
</p>
<div class="example">
<pre class="example">(%i1) sconcat (&quot;xx[&quot;, 3, &quot;]:&quot;, expand ((x+y)^3));
(%o1)             xx[3]:y^3+3*x*y^2+3*x^2*y+x^3
</pre></div>

<p>Another purpose for <code>sconcat</code> is to convert arbitrary objects to strings. 
</p><div class="example">
<pre class="example">(%i1) sconcat (x);
(%o1)                           x
</pre><pre class="example">(%i2) stringp(%);
(%o2)                         true
</pre></div>

<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Expressions">Expressions</a>
&middot;<a href="maxima_424.html#Category_003a-Strings">Strings</a>
&middot;</div></dd></dl>


<a name="string"></a><a name="Item_003a-DataTypes_002fdeffn_002fstring"></a><dl>
<dt><a name="index-string"></a>Function: <strong>string</strong> <em>(<var>expr</var>)</em></dt>
<dd>
<p>Converts <code>expr</code> to Maxima&rsquo;s linear notation just as if it had been typed
in.
</p>
<p>The return value of <code>string</code> is a string, and thus it cannot be used in a
computation.
</p>
<p>See also <code><a href="#concat">concat</a></code>, <code><a href="#sconcat">sconcat</a></code>, <code><a href="maxima_378.html#simplode">simplode</a></code> and
<code><a href="maxima_378.html#eval_005fstring">eval_string</a></code>.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Strings">Strings</a>
&middot;</div></dd></dl>


<a name="stringdisp"></a><a name="Item_003a-DataTypes_002fdefvr_002fstringdisp"></a><dl>
<dt><a name="index-stringdisp"></a>Option variable: <strong>stringdisp</strong></dt>
<dd><p>Default value: <code>false</code>
</p>
<p>When <code>stringdisp</code> is <code>true</code>, strings are displayed enclosed in double
quote marks.  Otherwise, quote marks are not displayed.
</p>
<p><code>stringdisp</code> is always <code>true</code> when displaying a function definition.
</p>
<p>Examples:
</p>
<div class="example">
<pre class="example">(%i1) stringdisp: false$
</pre><pre class="example">(%i2) &quot;This is an example string.&quot;;
(%o2)              This is an example string.
</pre><pre class="example">(%i3) foo () :=
      print (&quot;This is a string in a function definition.&quot;);
(%o3) foo() := 
              print(&quot;This is a string in a function definition.&quot;)
</pre><pre class="example">(%i4) stringdisp: true$
</pre><pre class="example">(%i5) &quot;This is an example string.&quot;;
(%o5)             &quot;This is an example string.&quot;
</pre></div>

<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Display-flags-and-variables">Display flags and variables</a>
&middot;</div></dd></dl>

<a name="Item_003a-Constants_002fnode_002fConstants"></a><hr>
<div class="header">
<p>
Previous: <a href="maxima_15.html#Introduction-to-Strings" accesskey="p" rel="previous">Introduction to Strings</a>, Up: <a href="maxima_14.html#Strings" accesskey="u" rel="up">Strings</a> &nbsp; [<a href="maxima_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="maxima_423.html#Function-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>