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
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 The GSL Team.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "GNU General Public License" and "Free Software
Needs Free Documentation", the Front-Cover text being "A GNU Manual",
and with the Back-Cover Text being (a) (see below). A copy of the
license is included in the section entitled "GNU Free Documentation
License".
(a) The Back-Cover Text is: "You have the freedom to copy and modify this
GNU Manual." -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Scientific Library – Reference Manual: Sparse Matrices Reading and Writing</title>
<meta name="description" content="GNU Scientific Library – Reference Manual: Sparse Matrices Reading and Writing">
<meta name="keywords" content="GNU Scientific Library – Reference Manual: Sparse Matrices Reading and Writing">
<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="index.html#Top" rel="start" title="Top">
<link href="Function-Index.html#Function-Index" rel="index" title="Function Index">
<link href="Sparse-Matrices.html#Sparse-Matrices" rel="up" title="Sparse Matrices">
<link href="Sparse-Matrices-Copying.html#Sparse-Matrices-Copying" rel="next" title="Sparse Matrices Copying">
<link href="Sparse-Matrices-Initializing-Elements.html#Sparse-Matrices-Initializing-Elements" rel="previous" title="Sparse Matrices Initializing Elements">
<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}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Sparse-Matrices-Reading-and-Writing"></a>
<div class="header">
<p>
Next: <a href="Sparse-Matrices-Copying.html#Sparse-Matrices-Copying" accesskey="n" rel="next">Sparse Matrices Copying</a>, Previous: <a href="Sparse-Matrices-Initializing-Elements.html#Sparse-Matrices-Initializing-Elements" accesskey="p" rel="previous">Sparse Matrices Initializing Elements</a>, Up: <a href="Sparse-Matrices.html#Sparse-Matrices" accesskey="u" rel="up">Sparse Matrices</a> [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Reading-and-Writing-Matrices"></a>
<h3 class="section">41.5 Reading and Writing Matrices</h3>
<a name="index-sparse-matrices_002c-reading"></a>
<a name="index-sparse-matrices_002c-writing"></a>
<dl>
<dt><a name="index-gsl_005fspmatrix_005ffwrite"></a>Function: <em>int</em> <strong>gsl_spmatrix_fwrite</strong> <em>(FILE * <var>stream</var>, const gsl_spmatrix * <var>m</var>)</em></dt>
<dd><p>This function writes the elements of the matrix <var>m</var> to the stream
<var>stream</var> in binary format. The return value is 0 for success and
<code>GSL_EFAILED</code> if there was a problem writing to the file. Since the
data is written in the native binary format it may not be portable
between different architectures.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005fspmatrix_005ffread"></a>Function: <em>int</em> <strong>gsl_spmatrix_fread</strong> <em>(FILE * <var>stream</var>, gsl_spmatrix * <var>m</var>)</em></dt>
<dd><p>This function reads into the matrix <var>m</var> from the open stream
<var>stream</var> in binary format. The matrix <var>m</var> must be preallocated
with the correct storage format, dimensions and have a sufficiently large <code>nzmax</code>
in order to read in all matrix elements, otherwise <code>GSL_EBADLEN</code>
is returned. The return value is 0 for success and
<code>GSL_EFAILED</code> if there was a problem reading from the file. The
data is assumed to have been written in the native binary format on the
same architecture.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005fspmatrix_005ffprintf"></a>Function: <em>int</em> <strong>gsl_spmatrix_fprintf</strong> <em>(FILE * <var>stream</var>, const gsl_spmatrix * <var>m</var>, const char * <var>format</var>)</em></dt>
<dd><p>This function writes the elements of the matrix <var>m</var> line-by-line to
the stream <var>stream</var> using the format specifier <var>format</var>, which
should be one of the <code>%g</code>, <code>%e</code> or <code>%f</code> formats for
floating point numbers. The function returns 0 for success and
<code>GSL_EFAILED</code> if there was a problem writing to the file. The
input matrix <var>m</var> may be in any storage format, and the output file
will be written in MatrixMarket format.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005fspmatrix_005ffscanf"></a>Function: <em>gsl_spmatrix *</em> <strong>gsl_spmatrix_fscanf</strong> <em>(FILE * <var>stream</var>)</em></dt>
<dd><p>This function reads sparse matrix data in the MatrixMarket format
from the stream <var>stream</var> and stores it in a newly allocated matrix
which is returned in triplet format. The function returns 0 for success and
<code>GSL_EFAILED</code> if there was a problem reading from the file. The
user should free the returned matrix when it is no longer needed.
</p></dd></dl>
<hr>
<div class="header">
<p>
Next: <a href="Sparse-Matrices-Copying.html#Sparse-Matrices-Copying" accesskey="n" rel="next">Sparse Matrices Copying</a>, Previous: <a href="Sparse-Matrices-Initializing-Elements.html#Sparse-Matrices-Initializing-Elements" accesskey="p" rel="previous">Sparse Matrices Initializing Elements</a>, Up: <a href="Sparse-Matrices.html#Sparse-Matrices" accesskey="u" rel="up">Sparse Matrices</a> [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|
