File: en_explode.html

package info (click to toggle)
basic256 1.1.4.0-2
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 24,460 kB
  • sloc: cpp: 10,148; yacc: 3,023; java: 1,091; lex: 1,051; sh: 117; xml: 33; makefile: 15
file content (139 lines) | stat: -rw-r--r-- 7,292 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
<!DOCTYPE html>
<html lang="en" dir="ltr" class="no-js">
<head>
    <meta charset="utf-8" />
    <title>en:explode [BASIC 256 - Language Documentation]</title>
<link rel="stylesheet" type="text/css" href="lib/exe/cssc171c1dfe8519125bb40a349172b001a.css"/>
    </head>
<body>
    <div id="dokuwiki__site"><div id="dokuwiki__top" class="site dokuwiki mode_show tpl_dokuwiki     ">
<div id="dokuwiki__header"><div class="pad group">
    <div class="headings group">
        <h1><a href="start.html"  accesskey="h" title="[H]"><img src="lib/tpl/dokuwiki/images/logo.png" width="64" height="64" alt="" /> <span>BASIC 256 - Language Documentation</span></a></h1>
            </div>
    </div>
            <div class="breadcrumbs">
                            <div class="youarehere"><span class="bchead">You are here: </span><span class="home"><bdi><a href="start.html" class="wikilink1" title="start">start</a></bdi></span> » <bdi><a href="en_start.html" class="wikilink1" title="en:start">en</a></bdi> » <bdi><span class="curid"><a href="en_explode.html" class="wikilink1" title="en:explode">explode</a></span></bdi></div>
                    </div>
    <hr class="a11y" />
</div></div>
        <div class="wrapper group">
            <div id="dokuwiki__content"><div class="pad group">
                <div class="pageId"><span>en:explode</span></div>
                <div class="page group">
<div id="dw__toc">
<h3 class="toggle">Table of Contents</h3>
<div>
<ul class="toc">
<li class="level2"><div class="li"><a href="en_explode.html#explode_function">Explode (Function)</a></div>
<ul class="toc">
<li class="level3"><div class="li"><a href="en_explode.html#format">Format</a></div></li>
<li class="level3"><div class="li"><a href="en_explode.html#description">Description</a></div></li>
<li class="level3"><div class="li"><a href="en_explode.html#example">Example</a></div></li>
<li class="level3"><div class="li"><a href="en_explode.html#see_also">See Also</a></div></li>
<li class="level3"><div class="li"><a href="en_explode.html#history">History</a></div></li>
</ul></li>
</ul>
</div>
</div>
<h2 class="sectionedit1" id="explode_function">Explode (Function)</h2>
<div class="level2">
</div>
<h3 class="sectionedit2" id="format">Format</h3>
<div class="level3">
<p>
<a class="explain" href="en_arrays.html">string_array_variable$</a> = <strong>explode</strong> ( <em><a class="explain" href="en_expressions.html#string_expressions">string_expr</a></em> , <em><a class="explain" href="en_expressions.html#string_expressions">delimiter_expr</a></em> )<br/>
<a class="explain" href="en_arrays.html">string_array_variable$</a> = <strong>explode</strong> ( <em><a class="explain" href="en_expressions.html#string_expressions">string_expr</a></em> , <em><a class="explain" href="en_expressions.html#string_expressions">delimiter_expr</a></em> , <em><a class="explain" href="en_expressions.html#boolean_expressions">boolean_expr</a></em> )<br/>
</p>
<p>
returns <em><a class="explain" href="en_arrays.html">string_array</a></em> that must be assigned to a <em><a class="explain" href="en_arrays.html">string_array_variable$</a></em>
</p>
</div>
<h3 class="sectionedit3" id="description">Description</h3>
<div class="level3">
<p>
Splits up the <em><a class="explain" href="en_expressions.html#string_expressions">string_expr</a></em> into substrings wherever the <em><a class="explain" href="en_expressions.html#string_expressions">delimiter_expr</a></em> occurs.  Substrings are stored in either the string or numeric array defined in the assignment statement.  The array will be re-dimensioned to the exact size to store all of the substrings.
</p>
<p>
You may also specify an optional boolean value to specify that the search will treat upper and lower case letters the same.
</p>
</div>
<h3 class="sectionedit4" id="example">Example</h3>
<div class="level3">
<pre class="code"># explode on spaces
a$ = &quot;We all live in a yellow submarine.&quot;
print a$
w$ = explode(a$,&quot; &quot;)
for t = 0 to w$[?]-1
   print &quot;w$[&quot;+t+&quot;]=&quot; + w$[t]
next t
# explode on A or a
a$ = &quot;klj;lkjalkjAlkj;&quot;
print a$
w$ = explode(a$,&quot;A&quot;,true)
for t = 0 to w$[?]-1
   print &quot;w$[&quot;+t+&quot;]=&quot; + w$[t]
next t
# explode numbers on comma
a$=&quot;1,2,3,77,foo,9.987,6.45&quot;
print a$
n = explode(a$,&quot;,&quot;)
for t = 0 to n[?]-1
   print &quot;n[&quot;+t+&quot;]=&quot; + n[t]
next t</pre>
<p>
will display
</p>
<pre class="code">We all live in a yellow submarine.
w$[0]=We
w$[1]=all
w$[2]=live
w$[3]=in
w$[4]=a
w$[5]=yellow
w$[6]=submarine.
klj;lkjalkjAlkj;
w$[0]=klj;lkj
w$[1]=lkj
w$[2]=lkj;
1,2,3,77,foo,9.987,6.45
n[0]=1
n[1]=2
n[2]=3
n[3]=77
n[4]=0
n[5]=9.987
n[6]=6.45</pre>
</div>
<h3 class="sectionedit5" id="see_also">See Also</h3>
<div class="level3">
</div>
<div class="plugin_include_content plugin_include__en:start">
<div class="level3">
<p>
<a href="en_asc.html" class="wikilink1" title="en:asc">Asc</a>, <a href="en_chr.html" class="wikilink1" title="en:chr">Chr</a>, <a href="en_count.html" class="wikilink1" title="en:count">Count</a>, <a href="en_countx.html" class="wikilink1" title="en:countx">Countx</a>, <span class="curid"><a href="en_explode.html" class="wikilink1" title="en:explode">Explode</a></span>, <a href="en_explodex.html" class="wikilink1" title="en:explodex">Explodex</a>, <a href="en_implode.html" class="wikilink1" title="en:implode">Implode</a>, <a href="en_instr.html" class="wikilink1" title="en:instr">Instr</a>, <a href="en_instrx.html" class="wikilink1" title="en:instrx">Instrx</a>, <a href="en_left.html" class="wikilink1" title="en:left">Left</a>, <a href="en_length.html" class="wikilink1" title="en:length">Length</a>, <a href="en_lower.html" class="wikilink1" title="en:lower">Lower</a>, <a href="en_md5.html" class="wikilink1" title="en:md5">MD5</a>, <a href="en_mid.html" class="wikilink1" title="en:mid">Mid</a>, <a href="en_midx.html" class="wikilink1" title="en:midx">Midx</a>, <a href="en_replace.html" class="wikilink1" title="en:replace">Replace</a>, <a href="en_replacex.html" class="wikilink1" title="en:replacex">Replacex</a>, <a href="en_right.html" class="wikilink1" title="en:right">Right</a>, <a href="en_string.html" class="wikilink1" title="en:string">String</a>, <a href="en_upper.html" class="wikilink1" title="en:upper">Upper</a>
</p>
</div>
</div>
<div class="level3">
</div>
<h3 class="sectionedit9" id="history">History</h3>
<div class="level3">
<div class="table sectionedit10"><table class="inline">
	<tr class="row0">
		<td class="col0">0.9.6.55</td><td class="col1">New to Version</td>
	</tr>
</table></div>
</div>
                                    </div>
                <div class="docInfo"><bdi>en/explode.txt</bdi> · Last modified: 2014/02/09 20:47 by <bdi>admin</bdi></div>
                            </div></div>
            <hr class="a11y" />
        </div>
<div id="dokuwiki__footer"><div class="pad">
    <div class="license">Except where otherwise noted, content on this wiki is licensed under the following license: <bdi><a href="http://creativecommons.org/licenses/by-sa/3.0/" rel="license" class="urlextern">CC Attribution-Share Alike 3.0 Unported</a></bdi></div>
</div></div>
    </div></div>
    <div id="screen__mode" class="no"></div>
</body>
</html>