str
Builtin index · Collections & strings
result = str(x)
Input: x · Output: result
What it is
Renders x (any value/type) the same way print/disp would.
Overloads
One call shape — this function is not overloaded.
Code Input Output Description
result = str(x)x Str not documented yet
result Str
Returns a Str.
Examples
From the documentation, and run by the build -- the output and the figure below are what the engine actually produced. Simplest first.
x = 1 :10
print ("sum = " + str (sum (x)))
write_report ("summary.html" )
print (file_exists ("summary.html" )) # true
from file-io
df = table (a = randn (30 , seed = 3 ), b = randn (30 , seed = 4 ), c = randn (30 , seed = 5 ))
eda (df) # correlation heatmap + one histogram per numeric column, auto-gridded
print ("columns: " + str (cols (df)))
a, a: 1
1
a, b: 0.048
0.048
a, c: 0.051
0.051
b, a: 0.048
0.048
b, b: 1
1
b, c: -0.117
-0.117
c, a: 0.051
0.051
c, b: -0.117
-0.117
c, c: 1
1
a
b
c
a
b
c
Correlation
0.302
0.302
-2.271
-2.271
0.21
0.21
-0.674
-0.674
-0.388
-0.388
-1.967
-1.967
0.801
0.801
-2.074
-2.074
0.57
0.57
0.164
0.164
-0.939
-0.939
-1.956
-1.956
0.864
0.864
-1.204
-1.204
0.152
0.152
0.238
0.238
-1.99
-1.99
1.128
1.128
-1.676
-1.676
1.75
1.75
0.907
0.907
-0.406
-0.406
1.146
1.146
0.706
0.706
-2.005
-2.005
0.42
0.42
-0.78
-0.78
-0.885
-0.885
0.386
0.386
1.542
1.542
0.526
0.526
$9\times10^{-4}$
9×10 −4
1.113
1.113
-0.142
-0.142
0.83
0.83
1.226
1.226
-0.987
-0.987
1.79
1.79
-2.247
-2.247
-0.425
-0.425
0.304
0.304
0.834
0.834
0.144
0.144
-0.664
-0.664
-0.404
-0.404
0.091
0.091
0.751
0.751
1.335
1.335
0.67
0.67
-0.005
-0.005
-0.819
-0.819
-1.183
-1.183
-1.224
-1.224
-1.306
-1.306
0.993
0.993
-0.278
-0.278
1.171
1.171
0.469
0.469
1.072
1.072
-1.095
-1.095
0.521
0.521
1.397
1.397
-0.292
-0.292
1.682
1.682
-0.281
-0.281
1.3
1.3
-0.484
-0.484
1.198
1.198
0.819
0.819
-0.644
-0.644
-0.528
-0.528
-0.404
-0.404
0.44
0.44
-1.584
-1.584
-0.873
-0.873
-0.55
-0.55
1.347
1.347
-0.657
-0.657
-0.588
-0.588
-2.034
-2.034
0.136
0.136
0.091
0.091
0.565
0.565
-0.569
-0.569
-0.532
-0.532
0.649
0.649
-0.159
-0.159
0.838
0.838
0.081
0.081
0.532
0.532
-1.335
-1.335
-0.046
-0.046
-1.818
-1.818
-0.219
-0.219
2.756
2.756
0.385
0.385
0.101
0.101
1.32
1.32
-0.146
-0.146
0.809
0.809
a
0
2
4
6
8
-2
0
2
4
x=0, y=0
x=1.8, y=0.063
x=1.2, y=0.126
x=3.5, y=0.188
x=3, y=0.249
x=4.8, y=0.31
x=-1.965, y=3
x=-1.354, y=3
x=-0.743, y=3
x=-0.131, y=8
x=0.48, y=7
x=1.091, y=6
b
0
2
4
6
8
10
0
10
20
30
40
x=-3.073, y=1
x=-2.189, y=1
x=-1.304, y=7
x=-0.42, y=2
x=0.465, y=11
x=1.349, y=8
c
from plotting
f = fopen ("log.txt" , "w" )
write_line (f, "run started" )
write_line (f, "value = " + str (42 ))
close (f)
print (file_size ("log.txt" )) # 23 -- "run started\n" + "value = 42\n"
from file-io
m = randn (10 , 10 , seed = 4 )
heatmap (m, colormap ="viridis" )
colorbar
title ("Random field" )
print ("value range: [" + str (min (m)) + ", " + str (max (m)) + "]" )
output value range: [-2.270955, 2.7556]
0
0.5
1.0
1.5
2.0
2.5
3.0
3.5
4.0
4.5
5.0
0
1
2
3
4
5
x=0.12, y=1
x=0.36, y=0
x=0.6, y=0
x=0.84, y=0
x=1.08, y=0
x=1.32, y=1
x=1.56, y=0
x=1.8, y=1
x=2.04, y=0
x=2.28, y=0
x=2.52, y=0
x=2.76, y=0
x=3, y=1
x=3.24, y=0
x=3.48, y=1
x=3.72, y=0
x=3.96, y=0
x=4.2, y=0
x=4.44, y=0
x=4.68, y=1
0.302
0.302
-2.271
-2.271
0.21
0.21
-0.674
-0.674
-0.388
-0.388
-1.967
-1.967
0.801
0.801
-2.074
-2.074
0.57
0.57
0.164
0.164
-0.939
-0.939
-1.956
-1.956
0.864
0.864
-1.204
-1.204
0.152
0.152
0.238
0.238
-1.99
-1.99
1.128
1.128
-1.676
-1.676
1.75
1.75
0.907
0.907
-0.406
-0.406
1.146
1.146
0.706
0.706
-2.005
-2.005
0.42
0.42
-0.78
-0.78
-0.885
-0.885
0.386
0.386
1.542
1.542
0.526
0.526
$9\times10^{-4}$
9×10 −4
1.113
1.113
-0.142
-0.142
0.83
0.83
1.226
1.226
-0.987
-0.987
1.79
1.79
-2.247
-2.247
-0.425
-0.425
0.304
0.304
0.834
0.834
0.144
0.144
-0.664
-0.664
-0.404
-0.404
0.091
0.091
0.751
0.751
1.335
1.335
0.67
0.67
-0.005
-0.005
-0.819
-0.819
-1.183
-1.183
-1.224
-1.224
-1.306
-1.306
0.993
0.993
-0.278
-0.278
1.171
1.171
0.469
0.469
1.072
1.072
-1.095
-1.095
0.521
0.521
1.397
1.397
-0.292
-0.292
1.682
1.682
-0.281
-0.281
1.3
1.3
-0.484
-0.484
1.198
1.198
0.819
0.819
-0.644
-0.644
-0.528
-0.528
-0.404
-0.404
0.44
0.44
-1.584
-1.584
-0.873
-0.873
-0.55
-0.55
1.347
1.347
-0.657
-0.657
-0.588
-0.588
-2.034
-2.034
0.136
0.136
0.091
0.091
0.565
0.565
-0.569
-0.569
-0.532
-0.532
0.649
0.649
-0.159
-0.159
0.838
0.838
0.081
0.081
0.532
0.532
-1.335
-1.335
-0.046
-0.046
-1.818
-1.818
-0.219
-0.219
2.756
2.756
0.385
0.385
0.101
0.101
1.32
1.32
-0.146
-0.146
0.809
0.809
Random field
-1.0
-0.8
-0.6
-0.4
-0.2
0
0.2
0.4
0.6
0.8
1.0
0
1
2
3
4
5
x=0, y=0
x=1.8, y=0.063
x=1.2, y=0.126
x=3.5, y=0.188
x=3, y=0.249
x=4.8, y=0.31
0
0.1
0.2
0.3
0.4
0.5
0.6
0.7
0.8
0.9
1.0
0
10
20
30
40
from plotting
How it works
str(x) — render any value the same way print/disp would, as a string. Exists mainly so loop bodies can build per-iteration labels ("s" + str(i+1)) — see the + string-concat case in binop below, which this pairs with.
From the note above this builtin in the interpreter, where the reasoning was written down as it was built.