

<!--
  * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  * 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.     *
  * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 -->


<!-- NEW PAGE -->
<!-- HEADER RIGHT "H5Rdereference" -->
<hr>
<dl>

<dt><div align=right><font color=999999 size=-1><i>
    Last modified: 3 March 2016
    </i></font></div>

<dt><strong>Name:</strong> <a name="Reference-Dereference">H5Rdereference</a>
<dt><strong>Signature:</strong>
    <dd><em>hid_t</em> <code>H5Rdereference</code>(
    <em>hid_t</em> <code>loc_id</code>,
    <em>H5R_type_t</em> <code>ref_type</code>,
    <em>void *</em><code>ref</code>
    )
    <p>
    <dd><em>hid_t</em> <code>H5Rdereference</code>(
    <em>hid_t</em> <code>loc_id</code>,
    <em>hid_t</em> <code>oapl_id</code>,
    <em>H5R_type_t</em> <code>ref_type</code>,
    <em>void *</em><code>ref</code>
    )
<p>
<dt><strong>Purpose:</strong>
    <dd>Opens the HDF5 object referenced.
<p>
<dt><strong>Description:</strong>
    <dd><code>H5Rdereference</code> is a macro that is mapped to either
      <a href="#Reference-Dereference1"><code>H5Rdereference1</code></a> or
      <a href="#Reference-Dereference2"><code>H5Rdereference2</code></a>,
      depending on the needs of the application.
      <p>
      Such macros are provided to facilitate application compatibility.
      Their use and mappings are fully described in 
      &ldquo;<a href="APICompatMacros.html">API Compatibility Macros 
      in HDF5</a>&rdquo;; 
      we urge you to read that document closely.
      <p>
      When both the HDF5 Library and the application are built and 
      installed with no specific compatibility flags, 
      <code>H5Rdereference</code> is mapped to the most recent version of
      the function, currently 
      <a href="#Reference-Dereference2"><code>H5Rdereference2</code></a>.
      If the library and/or application is compiled for Release 1.6 or 1.8
      emulation, <code>H5Rdereference</code> will be mapped to 
      <a href="#Reference-Dereference1"><code>H5Rdereference1</code></a>.
      Function-specific flags are available to override these settings 
      on a function-by-function basis when the application is compiled. 
      <p>
      Specific compile-time compatibility flags and the resulting 
      mappings are as follows:

      <dir>
      <table border=0 cellpadding=4>
        <tr valign=top align=left> 
          <th>Compatibility setting</th>
          <th><code>H5Rdereference</code> mapping</th>
        </tr><tr valign=top align=left>
          <td colspan=2><hr><u><a href="APICompatMacros.html#GlobalSettings">Global settings</a></u></td>
        </tr><tr valign=top align=left>
          <td>No compatibility flag</td>
          <td><code>H5Rdereference2</code>&nbsp;</td>
        </tr><tr valign=top align=left>
          <td>Enable deprecated symbols</td>
          <td><code>H5Rdereference2</code>&nbsp;</td>
        </tr><tr valign=top align=left>
          <td>Disable deprecated symbols</td>
          <td><code>H5Rdereference2</code>&nbsp;</td>
        </tr><tr valign=top align=left>
          <td>Emulate Release 1.6 interface<code>&nbsp;&nbsp;&nbsp;&nbsp;</code></td>
          <td><code>H5Rdereference1</code>&nbsp;</td>
        </tr><tr valign=top align=left>
          <td>Emulate Release 1.8 interface<code>&nbsp;</code></td>
          <td><code>H5Rdereference1</code>&nbsp;</td>
        </tr><tr valign=top align=left>
          <td colspan=2><hr><u><a href="APICompatMacros.html#FunctionLevelSettings">Function-level macros</a></u></td>
        </tr><tr valign=top align=left>
          <td><code>H5Rdereference_vers = 2</code></td>
          <td><code>H5Rdereference2</code></td>
        </tr><tr valign=top align=left>
          <td><code>H5Rdereference_vers = 1</code></td>
          <td><code>H5Rdereference1</code></td>
        </tr>
      </table>
      </dir>
      
<!-- NEW PAGE -->
  <p>
<dt><strong>Fortran90 Interface:</strong> h5rdereference_f
    <dd>

    <dd>
    <p><strong>To dereference an object:</strong> 
    <br>

        <?php include("H5R/h5rdereference_object_f_F90.htm"); ?>

<!-- NEW PAGE -->
    <p><strong>To dereference a region:</strong>	
    <br>

        <?php include("H5R/h5rdereference_region_f_F90.htm"); ?>

  <p>
<dt><strong>Fortran2003 Interface:</strong> h5rdereference_f
    <dd>

        <?php include("H5R/h5rdereference_f_F03.htm"); ?>

<!-- NEW PAGE -->
  <p>
<dt><strong>History:</strong>
    <dd><table width="90%">
        <tr>
          <td valign="top" align="left" width="10%">
            <strong>Release</strong>&nbsp;&nbsp;&nbsp;&nbsp;</td>
          <td valign="top" align="left">
            <strong>Change</strong></td></tr>
        <tr>
          <td valign="top">1.10.0</td>
          <td valign="top">The C function 
            <code>H5Rdereference</code> renamed to <code>H5Rdereference1</code> 
            and deprecated in this release.
            <br>
            The C macro <code>H5Rdereference</code> 
            and the C function <code>H5Rdereference2</code>
            introduced in this release.</td></tr>
    </table>
</dl>


