

<!--
  * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  * 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 "H5Pget" -->
<hr>
<dl>

  <dt><div align=right><font color=999999 size=-1><i>
      Last modified: 29 September 2011
      </i></font></div>

  <dt><strong>Name:</strong> <a name="Property-Get">H5Pget</a>
  <dt><strong>Signature:</strong>
    <dd><em>herr_t</em> <code>H5Pget</code>(
                  <em>hid_t</em> <code>plid</code>,
                  <em>const char *</em><code>name</code>,
                  <em>void *</em><code>value</code>
	)

  <p>
  <dt><strong>Purpose:</strong>
    <dd>Queries the value of a property.

  <p>
  <dt><strong>Description:</strong>
    <dd><code>H5Pget</code> retrieves a copy of the value for a property  
    in a property list.  If there is a <code>get</code> callback routine 
    registered for this property, the copy of the value of the property 
    will first be passed to that routine and any changes to the copy of 
    the value will be used when returning the property value from this 
    routine.   
    
    <p>
    This routine may be called for zero-sized properties with the 
    <code>value</code> set to NULL.  The <code>get</code> routine 
    will be called with a NULL value if the callback exists.
     
    <p>
    The property name must exist or this routine will fail.  
   
    <p>
    If the <code>get</code> callback routine returns an error,
    <code>value</code> will not be modified.   

  <p>
  <dt><strong>Parameters:</strong>
    <dd><table>
    <tr>
        <td><em>hid_t</em> <code>plid</code></td>
        <td>IN: Identifier of the property list to query</td></tr>
    <tr>
        <td><em>const&nbsp;char&nbsp;*</em><code>name&nbsp;&nbsp;&nbsp;&nbsp;</code></td>
        <td>IN: Name of property to query</td></tr>
    <tr>
        <td><em>void *</em><code>value</code></td>
        <td>OUT: Pointer to a location to which to copy the value of 
	         of the property</td></tr>
    </table></dd>

  <p>
  <dt><strong>Returns:</strong>
    <dd>Success: a non-negative value
    <dd>Failure: a negative value

  <p>
  <dt><strong>Fortran90 Interface:</strong> h5pget_f
    <dd>

        <?php include("H5P/h5pget_f_F90.htm"); ?>

 <!-- NEW PAGE -->
  <p>
  <dt><strong>Fortran2003 Interface:</strong> h5pget_f
    <dd>

        <?php include("H5P/h5pget_f_F03.htm"); ?>

  <p></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.8.8</td>
          <td valign="top">
              Fortran updated to Fortran2003.</td></tr>
    </table>


</dl>

