summaryrefslogtreecommitdiffstats
path: root/c++/src/H5CppDoc.h
blob: f3ed040c0b00c4a9b2ce749cd0302f1c6ef50b4f (plain)
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
// C++ informative line for the emacs editor: -*- C++ -*-
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 * Copyright by The HDF Group.                                               *
 * Copyright by the Board of Trustees of the University of Illinois.         *
 * All rights reserved.                                                      *
 *                                                                           *
 * This file is part of HDF5.  The full HDF5 copyright notice, including     *
 * terms governing use, modification, and redistribution, is contained in    *
 * the files COPYING and Copyright.html.  COPYING can be found at the root   *
 * of the source code distribution tree; Copyright.html can be found at the  *
 * root level of an installed copy of the electronic HDF5 document set and   *
 * is linked from the top-level documents page.  It can also be found at     *
 * http://hdfgroup.org/HDF5/doc/Copyright.html.  If you do not have          *
 * access to either file, you may request a copy from help@hdfgroup.org.     *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */

#ifndef __H5CppDoc_H
#define __H5CppDoc_H

//-------------------------------------------------------------------------
// The following section will be used to generate the 'Mainpage'
// and the 'Examples' for the RM.
// ------------------------------------------------------------------------

/*! \mainpage notitle
 *
 * \section intro_sec Introduction
 *
 * The C++ API provides C++ wrappers for the HDF5 C library.
 * It is assumed that the user has knowledge of the HDF5 file format
 * and its components.  If you are not familiar with HDF5 file format,
 * and would like to find out more, please refer to the HDF5 documentation
 * at http://www.hdfgroup.org/HDF5/doc/index.html
 *
 * Because the HDF5 library maps very well to
 * the object oriented design approach, classes in the C++ API can
 * closely represent the interfaces of the HDF5 APIs, as followed:
 *
 * \verbatim
        HDF5 C APIs                       C++ Classes
        -----------                       -----------
        Attribute Interface (H5A)         Attribute
        Datasets Interface (H5D)          DataSet
        Error Interface (H5E)             Exception
        File Interface (H5F)              H5File
        Group Interface (H5G)             Group
        Identifier Interface (H5I)        IdComponent
        Property List Interface (H5P)     PropList and subclasses
        Dataspace Interface (H5S)         DataSpace
        Datatype Interface (H5T)          DataType and subclasses
  \endverbatim
 * \section install_sec Installation
 *
 * Please refer to the file release_docs/INSTALL_Windows.txt
 * under the top directory for information about installing, building,
 * and testing the C++ API.
 *
 *
 */

///	This example shows how to create datasets.
///\par
///\example     create.cpp

///\par
///	This example shows how to write datasets.
///\example     writedata.cpp

///\par
///	This example shows how to read datasets.
///\example     readdata.cpp

///\par
///	This example shows how to create a compound datatype,
///	write an array which has the compound datatype to the file,
///	and read back fields' subsets.
///\example     compound.cpp

///\par
///	This example shows how to work with extendible datasets.
///\example     extend_ds.cpp

///\par
///	This example shows how to read data from a chunked dataset.
///\example     chunks.cpp

///\par
///	This example shows how to work with groups.
///\example     h5group.cpp

#endif // __H5CppDoc_H