17c3fbc60b822bd5b3d5c53935e293180c981e6d
[alexxy/gromacs.git] / src / gromacs / fileio / gmxfio-xdr.h
1 /*
2  * This file is part of the GROMACS molecular simulation package.
3  *
4  * Copyright (c) 1991-2000, University of Groningen, The Netherlands.
5  * Copyright (c) 2001-2004, The GROMACS development team.
6  * Copyright (c) 2013,2014,2015, by the GROMACS development team, led by
7  * Mark Abraham, David van der Spoel, Berk Hess, and Erik Lindahl,
8  * and including many others, as listed in the AUTHORS file in the
9  * top-level source directory and at http://www.gromacs.org.
10  *
11  * GROMACS is free software; you can redistribute it and/or
12  * modify it under the terms of the GNU Lesser General Public License
13  * as published by the Free Software Foundation; either version 2.1
14  * of the License, or (at your option) any later version.
15  *
16  * GROMACS is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
19  * Lesser General Public License for more details.
20  *
21  * You should have received a copy of the GNU Lesser General Public
22  * License along with GROMACS; if not, see
23  * http://www.gnu.org/licenses, or write to the Free Software Foundation,
24  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA.
25  *
26  * If you want to redistribute modifications to GROMACS, please
27  * consider that scientific software is very special. Version
28  * control is crucial - bugs must be traceable. We will be happy to
29  * consider code for inclusion in the official distribution, but
30  * derived work must not be called official GROMACS. Details are found
31  * in the README & COPYING files - if they are missing, get the
32  * official version at http://www.gromacs.org.
33  *
34  * To help us fund GROMACS development, we humbly ask that you cite
35  * the research papers on the package. Check out http://www.gromacs.org.
36  */
37 #ifndef GMX_FILEIO_GMXFIO_XDR_H
38 #define GMX_FILEIO_GMXFIO_XDR_H
39
40 #include "gromacs/fileio/xdrf.h"
41 #include "gromacs/math/vectypes.h"
42 #include "gromacs/utility/basedefinitions.h"
43 #include "gromacs/utility/real.h"
44
45 #ifdef __cplusplus
46 extern "C" {
47 #endif
48
49 struct t_fileio;
50
51 XDR *gmx_fio_getxdr(struct t_fileio *fio);
52 /* Return the file pointer itself */
53
54 gmx_bool gmx_fio_writee_string(struct t_fileio *fio, const char *item,
55                                const char *desc, const char *srcfile, int line);
56
57 /* reading or writing, depending on the file's opening mode string */
58 gmx_bool gmx_fio_doe_real(struct t_fileio *fio, real *item,
59                           const char *desc, const char *srcfile, int line);
60 gmx_bool gmx_fio_doe_float(struct t_fileio *fio, float *item,
61                            const char *desc, const char *srcfile, int line);
62 gmx_bool gmx_fio_doe_double(struct t_fileio *fio, double *item,
63                             const char *desc, const char *srcfile, int line);
64 gmx_bool gmx_fio_doe_gmx_bool(struct t_fileio *fio, gmx_bool *item,
65                               const char *desc, const char *srcfile, int line);
66 gmx_bool gmx_fio_doe_int(struct t_fileio *fio, int *item,
67                          const char *desc, const char *srcfile, int line);
68 gmx_bool gmx_fio_doe_int64(struct t_fileio *fio, gmx_int64_t *item,
69                            const char *desc, const char *srcfile, int line);
70 gmx_bool gmx_fio_doe_uchar(struct t_fileio *fio, unsigned char *item,
71                            const char *desc, const char *srcfile, int line);
72 gmx_bool gmx_fio_doe_ushort(struct t_fileio *fio, unsigned short *item,
73                             const char *desc, const char *srcfile, int line);
74 gmx_bool gmx_fio_doe_rvec(struct t_fileio *fio, rvec *item,
75                           const char *desc, const char *srcfile, int line);
76 gmx_bool gmx_fio_doe_ivec(struct t_fileio *fio, ivec *item,
77                           const char *desc, const char *srcfile, int line);
78 gmx_bool gmx_fio_doe_string(struct t_fileio *fio, char *item,
79                             const char *desc, const char *srcfile, int line);
80
81 /* array reading & writing */
82 gmx_bool gmx_fio_ndoe_real(struct t_fileio *fio, real *item, int n,
83                            const char *desc, const char *srcfile, int line);
84 gmx_bool gmx_fio_ndoe_float(struct t_fileio *fio, float *item, int n,
85                             const char *desc, const char *srcfile, int line);
86 gmx_bool gmx_fio_ndoe_double(struct t_fileio *fio, double *item, int n,
87                              const char *desc, const char *srcfile, int line);
88 gmx_bool gmx_fio_ndoe_gmx_bool(struct t_fileio *fio, gmx_bool *item, int n,
89                                const char *desc, const char *srcfile, int line);
90 gmx_bool gmx_fio_ndoe_int(struct t_fileio *fio, int *item, int n,
91                           const char *desc, const char *srcfile, int line);
92 gmx_bool gmx_fio_ndoe_int64(struct t_fileio *fio, gmx_int64_t *item, int n,
93                             const char *desc, const char *srcfile,
94                             int line);
95 gmx_bool gmx_fio_ndoe_uchar(struct t_fileio *fio, unsigned char *item, int n,
96                             const char *desc, const char *srcfile, int line);
97 gmx_bool gmx_fio_ndoe_ushort(struct t_fileio *fio, unsigned short *item, int n,
98                              const char *desc, const char *srcfile, int line);
99 gmx_bool gmx_fio_ndoe_rvec(struct t_fileio *fio, rvec *item, int n,
100                            const char *desc, const char *srcfile, int line);
101 gmx_bool gmx_fio_ndoe_ivec(struct t_fileio *fio, ivec *item, int n,
102                            const char *desc, const char *srcfile, int line);
103 gmx_bool gmx_fio_ndoe_string(struct t_fileio *fio, char *item[], int n,
104                              const char *desc, const char *srcfile, int line);
105
106
107
108 /* convenience macros */
109 #define gmx_fio_write_string(fio, item)         gmx_fio_writee_string(fio, item, (#item), __FILE__, __LINE__)
110
111 #define gmx_fio_do_real(fio, item)              gmx_fio_doe_real(fio, &item, (#item), __FILE__, __LINE__)
112 #define gmx_fio_do_float(fio, item)             gmx_fio_doe_float(fio, &item, (#item), __FILE__, __LINE__)
113 #define gmx_fio_do_double(fio, item)            gmx_fio_doe_double(fio, &item, (#item), __FILE__, __LINE__)
114 #define gmx_fio_do_gmx_bool(fio, item)          gmx_fio_doe_gmx_bool(fio, &item, (#item), __FILE__, __LINE__)
115 #define gmx_fio_do_int(fio, item)               gmx_fio_doe_int(fio, &item, (#item), __FILE__, __LINE__)
116 #define gmx_fio_do_int64(fio, item)             gmx_fio_doe_int64(fio, &item, (#item), __FILE__, __LINE__)
117 #define gmx_fio_do_uchar(fio, item)             gmx_fio_doe_uchar(fio, &item, (#item), __FILE__, __LINE__)
118 #define gmx_fio_do_ushort(fio, item)            gmx_fio_doe_ushort(fio, &item, (#item), __FILE__, __LINE__)
119 #define gmx_fio_do_rvec(fio, item)              gmx_fio_doe_rvec(fio, &item, (#item), __FILE__, __LINE__)
120 #define gmx_fio_do_ivec(fio, item)              gmx_fio_doe_ivec(fio, &item, (#item), __FILE__, __LINE__)
121 #define gmx_fio_do_string(fio, item)            gmx_fio_doe_string(fio, item, (#item), __FILE__, __LINE__)
122
123
124 #define gmx_fio_ndo_real(fio, item, n)              gmx_fio_ndoe_real(fio, item, n, (#item), __FILE__, __LINE__)
125 #define gmx_fio_ndo_float(fio, item, n)             gmx_fio_ndoe_float(fio, item, n, (#item), __FILE__, __LINE__)
126 #define gmx_fio_ndo_double(fio, item, n)            gmx_fio_ndoe_double(fio, item, n, (#item), __FILE__, __LINE__)
127 #define gmx_fio_ndo_gmx_bool(fio, item, n)          gmx_fio_ndoe_gmx_bool(fio, item, n, (#item), __FILE__, __LINE__)
128 #define gmx_fio_ndo_int(fio, item, n)               gmx_fio_ndoe_int(fio, item, n, (#item), __FILE__, __LINE__)
129 #define gmx_fio_ndo_int64(fio, item, n)             gmx_fio_ndoe_int64(fio, item, n, (#item), __FILE__, __LINE__)
130 #define gmx_fio_ndo_uchar(fio, item, n)             gmx_fio_ndoe_uchar(fio, item, n, (#item), __FILE__, __LINE__)
131 #define gmx_fio_ndo_ushort(fio, item, n)            gmx_fio_ndoe_ushort(fio, item, n, (#item), __FILE__, __LINE__)
132 #define gmx_fio_ndo_rvec(fio, item, n)              gmx_fio_ndoe_rvec(fio, item, n, (#item), __FILE__, __LINE__)
133 #define gmx_fio_ndo_ivec(fio, item, n)              gmx_fio_ndoe_ivec(fio, item, n, (#item), __FILE__, __LINE__)
134 #define gmx_fio_ndo_string(fio, item, n)            gmx_fio_ndoe_string(fio, item, n, (#item), __FILE__, __LINE__)
135
136 #ifdef __cplusplus
137 }
138 #endif
139
140 #endif