H5_VERSION_LE

Content Layer

id	1195548671

Content Column

width	50.00001%
id	1195578110
class	rm_pagetree_col mobile-hide

Content Block

id	1195578111

Content Column

width	50.00001%
id	1195548673
class	hdf-rm-main-column

Content Block

id	1195548672

Include Content

render-without-blocks	true
page	.rm-navbar

HTML Wrap

class	hdf-print-only

Page Title

HTML Wrap

class	hdf-rm-summary-block

Hdf rm anchor

AnchorName	summary

Excerpt
Determines whether the version of the library being used is less than or equal to the specified version

HTML Wrap

class	hdf-rm-content-block

Hdf rm anchor

AnchorName	procedure

Procedure:

HTML Wrap

class	hdf-rm-section

HTML Wrap

class	hdf_procedure

H5_VERSION_LE(maj, min, rel)

Hdf rm anchor

AnchorName	signature

Signature:

HTML Wrap

class	hdf-rm-section

HTML Wrap

class	hdf-togglebox hdf-c

HTML Add Class

	hdf-togglebutton-visible
	hdf-togglebutton-visible
selector	.hdf-togglebutton.hdf-c

HTML
<pre><code class="language-c">H5_VERSION_LE ( int maj, int min, int rel )</code></pre>

Hdf rm anchor

AnchorName	parameters

Parameters:

HTML Wrap

class	hdf-rm-section

int `maj`	IN: Major version number A non-negative integer value
int `min`	IN: Minor version number A non-negative integer value
int `rel`	IN: Release number A non-negative integer value

Hdf rm anchor

AnchorName	description

Description:

HTML Wrap

class	hdf-rm-section

The H5_VERSION_GE and H5_VERSION_LE macros are used at compile time to conditionally include or exclude code based on the version of the HDF5 library against which an application will be linked.

The H5_VERSION_LE macro compares the version of the HDF5 library being used against the version number specified in the parameters.

For more information about release versioning, see HDF5 Library Release Version Numbers.

Hdf rm anchor

AnchorName	returns

Returns:

If

A value of 1 is returned if the library version is less than or equal to the version number specified

If

.

A value of 0 is returned if the library version is greater than the version number specified.

A A library version is less than the specified version number if its major version is smaller than the specified major version number. If the major version numbers are the same, it is less than the specified version number if its minor version is smaller than the specified minor version number. If the minor version numbers are the same, then a library version would be less than the specified version number if its release number is smaller than the specified release number.

HTML Wrap

class	hdf-rm-section

TRUE FALSE

Hdf rm anchor

AnchorName	example

Example:

HTML Wrap

class	hdf-rm-section

Suppose an application wants to call different functions based on the version of the HDF5 library to which an application will be linked. For example, the link functions, H5Lxxx, are new in the 1.8 versions of HDF5, and some group functions, H5Gxxx, are deprecated in the 1.8 versions. The following code uses H5Gunlink if the library version is 1.6.10 or earlier or uses H5Ldelete if the library version is not 1.6.10 or earlier. Similarly, the code calls H5Gopen or H5Lexists to make sure the group has been deleted.

    #if H5_VERSION_LE(1,6,10)
        ret = H5Gunlink(file, "Group");
        CHECK(ret, FAIL, "H5Gunlink");

        H5E_BEGIN_TRY {
            grp = H5Gopen(file, "Group");
        } H5E_END_TRY;
        VERIFY(grp, FAIL, "H5Gopen");
    #else
        ret = H5Ldelete(file, "Group", H5P_DEFAULT);
        CHECK(ret, FAIL, "H5Lunlink");

        status = H5Lexists(file, "Group", H5P_DEFAULT);
        VERIFY(status, FALSE, "H5Lexists");
    #endif

Comment

HTML Wrap

class	hdf-togglebox hdf-c

Bitbucket Server file

repoSlug	hdf5
branchId	refs/heads/1.10/master
projectKey	HDFFV
filepath	examples/h5_subset.c
showLineNumbers	true
lineStart	32
progLang	cpp
lineEnd	42
applicationLink	5ac7b370-7412-3c8c-ad20-807a68261336

Hdf rm anchor

AnchorName	history

History:

HTML Wrap

class	hdf-rm-section

Release	Change
1.8.7	C macro introduced in this release.

Page tree

Versions Compared

Old Version 5

New Version Current

Key

Procedure:

Signature:

Parameters:

Description:

Returns:

Example:

History:

The HDF Group

Site

Resources

Connect