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
222
223
224
225
226
227
228
229
230
231
232
|
<!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 Manual: Functions and Variables for binary input and output</title>
<meta name="description" content="Maxima Manual: Functions and Variables for binary input and output">
<meta name="keywords" content="Maxima Manual: Functions and Variables for binary input and output">
<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_264.html#g_t_0423_043a_0430_0437_0430_0442_0435_043b_044c-_0444_0443_043d_043a_0446_0438_0439-_0438-_043f_0435_0440_0435_043c_0435_043d_043d_044b_0445" rel="index" title="Указатель функций и переменных">
<link href="maxima_toc.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="maxima_220.html#numericalio_002dpkg" rel="up" title="numericalio-pkg">
<link href="maxima_224.html#opsubst_002dpkg" rel="next" title="opsubst-pkg">
<link href="maxima_222.html#Functions-and-Variables-for-plain_002dtext-input-and-output" rel="previous" title="Functions and Variables for plain-text input and output">
<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="ru" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Functions-and-Variables-for-binary-input-and-output"></a>
<div class="header">
<p>
Previous: <a href="maxima_222.html#Functions-and-Variables-for-plain_002dtext-input-and-output" accesskey="p" rel="previous">Functions and Variables for plain-text input and output</a>, Up: <a href="maxima_220.html#numericalio_002dpkg" accesskey="u" rel="up">numericalio-pkg</a> [<a href="maxima_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="maxima_264.html#g_t_0423_043a_0430_0437_0430_0442_0435_043b_044c-_0444_0443_043d_043a_0446_0438_0439-_0438-_043f_0435_0440_0435_043c_0435_043d_043d_044b_0445" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Functions-and-Variables-for-binary-input-and-output-1"></a>
<h3 class="section">62.3 Functions and Variables for binary input and output</h3>
<a name="assume_005fexternal_005fbyte_005forder"></a><a name="Item_003a-numericalio_002fdeffn_002fassume_005fexternal_005fbyte_005forder"></a><dl>
<dt><a name="index-assume_005fexternal_005fbyte_005forder"></a>Function: <strong>assume_external_byte_order</strong> <em>(<var>byte_order_flag</var>)</em></dt>
<dd><p>Tells <code>numericalio</code> the byte order for reading and writing binary data.
Two values of <var>byte_order_flag</var> are recognized:
<code>lsb</code> which indicates least-significant byte first, also called little-endian byte order;
and <code>msb</code> which indicates most-significant byte first, also called big-endian byte order.
</p>
<p>If not specified, <code>numericalio</code> assumes the external byte order is most-significant byte first.
</p>
</dd></dl>
<a name="openr_005fbinary"></a><a name="Item_003a-numericalio_002fdeffn_002fopenr_005fbinary"></a><dl>
<dt><a name="index-openr_005fbinary"></a>Function: <strong>openr_binary</strong> <em>(<var>file_name</var>)</em></dt>
<dd><p>Returns an input stream of 8-bit unsigned bytes to read the file named by <var>file_name</var>.
</p>
<p>See also <code><a href="#openw_005fbinary">openw_binary</a></code> and <code><a href="maxima_254.html#openr">openr</a></code>.
</p>
</dd></dl>
<a name="openw_005fbinary"></a><a name="Item_003a-numericalio_002fdeffn_002fopenw_005fbinary"></a><dl>
<dt><a name="index-openw_005fbinary"></a>Function: <strong>openw_binary</strong> <em>(<var>file_name</var>)</em></dt>
<dd><p>Returns an output stream of 8-bit unsigned bytes to write the file named by <var>file_name</var>.
</p>
<p>See also <code><a href="#openr_005fbinary">openr_binary</a></code>, <code><a href="#opena_005fbinary">opena_binary</a></code> and <code><a href="maxima_254.html#openw">openw</a></code>.
</p>
</dd></dl>
<a name="opena_005fbinary"></a><a name="Item_003a-numericalio_002fdeffn_002fopena_005fbinary"></a><dl>
<dt><a name="index-opena_005fbinary"></a>Function: <strong>opena_binary</strong> <em>(<var>file_name</var>)</em></dt>
<dd><p>Returns an output stream of 8-bit unsigned bytes to append the file named by <var>file_name</var>.
</p>
</dd></dl>
<a name="read_005fbinary_005fmatrix"></a><a name="Item_003a-numericalio_002fdeffn_002fread_005fbinary_005fmatrix"></a><dl>
<dt><a name="index-read_005fbinary_005fmatrix"></a>Function: <strong>read_binary_matrix</strong> <em>(<var>S</var>, <var>M</var>)</em></dt>
<dd><p>Reads binary 8-byte floating point numbers from the source <var>S</var> into the matrix <var>M</var>
until <var>M</var> is full, or the source is exhausted.
Elements of <var>M</var> are read in row-major order.
</p>
<p>The source <var>S</var> may be a file name or a stream.
</p>
<p>The byte order in elements of the source is specified by <code>assume_external_byte_order</code>.
</p>
<p>See also <code><a href="maxima_222.html#read_005fmatrix">read_matrix</a></code>.
</p>
</dd></dl>
<a name="read_005fbinary_005farray"></a><a name="Item_003a-numericalio_002fdeffn_002fread_005fbinary_005farray"></a><dl>
<dt><a name="index-read_005fbinary_005farray"></a>Function: <strong>read_binary_array</strong> <em>(<var>S</var>, <var>A</var>)</em></dt>
<dd><p>Reads binary 8-byte floating point numbers from the source <var>S</var> into the array <var>A</var>
until <var>A</var> is full, or the source is exhausted.
<var>A</var> must be an array created by <code>array</code> or <code>make_array</code>.
Elements of <var>A</var> are read in row-major order.
</p>
<p>The source <var>S</var> may be a file name or a stream.
</p>
<p>The byte order in elements of the source is specified by <code>assume_external_byte_order</code>.
</p>
<p>See also <code><a href="maxima_222.html#read_005farray">read_array</a></code>.
</p>
</dd></dl>
<a name="read_005fbinary_005flist"></a><a name="Item_003a-numericalio_002fdeffn_002fread_005fbinary_005flist"></a><dl>
<dt><a name="index-read_005fbinary_005flist"></a>Function: <strong>read_binary_list</strong> <em><br> <tt>read_binary_list</tt> (<var>S</var>) <br> <tt>read_binary_list</tt> (<var>S</var>, <var>L</var>)</em></dt>
<dd>
<p><code>read_binary_list(<var>S</var>)</code> reads the entire content of the source <var>S</var>
as a sequence of binary 8-byte floating point numbers, and returns it as a list.
The source <var>S</var> may be a file name or a stream.
</p>
<p><code>read_binary_list(<var>S</var>, <var>L</var>)</code> reads 8-byte binary floating point numbers
from the source <var>S</var> until the list <var>L</var> is full, or the source is exhausted.
</p>
<p>The byte order in elements of the source is specified by <code>assume_external_byte_order</code>.
</p>
<p>See also <code><a href="maxima_222.html#read_005flist">read_list</a></code>.
</p>
</dd></dl>
<a name="write_005fbinary_005fdata"></a><a name="Item_003a-numericalio_002fdeffn_002fwrite_005fbinary_005fdata"></a><dl>
<dt><a name="index-write_005fbinary_005fdata"></a>Function: <strong>write_binary_data</strong> <em>(<var>X</var>, <var>D</var>)</em></dt>
<dd>
<p>Writes the object <var>X</var>, comprising binary 8-byte IEEE 754 floating-point numbers,
to the destination <var>D</var>.
Other kinds of numbers are coerced to 8-byte floats.
<code>write_binary_data</code> cannot write non-numeric data.
</p>
<p>The object <var>X</var> may be a list, a nested list, a matrix,
or an array created by <code>array</code> or <code>make_array</code>;
<var>X</var> cannot be a hashed array or any other type of object.
<code>write_binary_data</code> writes nested lists, matrices, and arrays in row-major order.
</p>
<p>The destination <var>D</var> may be a file name or a stream.
When the destination is a file name,
the global variable <code>file_output_append</code> governs
whether the output file is appended or truncated.
When the destination is a stream,
no special action is taken by <code>write_binary_data</code> after all the data are written;
in particular, the stream remains open.
</p>
<p>The byte order in elements of the destination
is specified by <code>assume_external_byte_order</code>.
</p>
<p>See also <code><a href="maxima_222.html#write_005fdata">write_data</a></code>.
</p>
</dd></dl>
<hr>
<div class="header">
<p>
Previous: <a href="maxima_222.html#Functions-and-Variables-for-plain_002dtext-input-and-output" accesskey="p" rel="previous">Functions and Variables for plain-text input and output</a>, Up: <a href="maxima_220.html#numericalio_002dpkg" accesskey="u" rel="up">numericalio-pkg</a> [<a href="maxima_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="maxima_264.html#g_t_0423_043a_0430_0437_0430_0442_0435_043b_044c-_0444_0443_043d_043a_0446_0438_0439-_0438-_043f_0435_0440_0435_043c_0435_043d_043d_044b_0445" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|
