/usr/share/pyshared/h5py/h5i.pyx is in python-h5py 2.0.1-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 | #+
#
# This file is part of h5py, a low-level Python interface to the HDF5 library.
#
# Copyright (C) 2008 Andrew Collette
# http://h5py.alfven.org
# License: BSD (See LICENSE.txt for full license)
#
# $Date$
#
#-
"""
Identifier interface for object inspection.
"""
include "config.pxi"
# === Public constants and data structures ====================================
BADID = H5I_BADID
FILE = H5I_FILE
GROUP = H5I_GROUP
DATASPACE = H5I_DATASPACE
DATASET = H5I_DATASET
ATTR = H5I_ATTR
REFERENCE = H5I_REFERENCE
GENPROP_CLS = H5I_GENPROP_CLS
GENPROP_LST = H5I_GENPROP_LST
DATATYPE = H5I_DATATYPE
cpdef ObjectID wrap_identifier(hid_t ident):
cdef H5I_type_t typecode
cdef ObjectID obj
typecode = H5Iget_type(ident)
if typecode == H5I_FILE:
import h5f
obj = h5f.FileID(ident)
elif typecode == H5I_DATASET:
import h5d
obj = h5d.DatasetID(ident)
elif typecode == H5I_GROUP:
import h5g
obj = h5g.GroupID(ident)
elif typecode == H5I_ATTR:
import h5a
obj = h5a.AttrID(ident)
elif typecode == H5I_DATATYPE:
import h5t
obj = h5t.typewrap(ident)
elif typecode == H5I_GENPROP_LST:
import h5p
obj = h5p.propwrap(ident)
else:
raise ValueError("Unrecognized type code %d" % typecode)
return obj
# === Identifier API ==========================================================
def get_type(ObjectID obj not None):
""" (ObjectID obj) => INT type_code
Determine the HDF5 typecode of an arbitrary HDF5 object. The return
value is always one of the type constants defined in this module; if
the ID is invalid, BADID is returned.
"""
return <int>H5Iget_type(obj.id)
def get_name(ObjectID obj not None):
""" (ObjectID obj) => STRING name, or None
Determine (a) name of an HDF5 object. Because an object has as many
names as there are hard links to it, this may not be unique.
If the identifier is invalid or is not associated with a name
(in the case of transient datatypes, dataspaces, etc), returns None.
For some reason, this does not work on dereferenced objects.
"""
cdef int namelen
cdef char* name
try:
namelen = <int>H5Iget_name(obj.id, NULL, 0)
except Exception:
return None
if namelen == 0: # 1.6.5 doesn't raise an exception
return None
assert namelen > 0
name = <char*>malloc(sizeof(char)*(namelen+1))
try:
H5Iget_name(obj.id, name, namelen+1)
pystring = name
return pystring
finally:
free(name)
def get_file_id(ObjectID obj not None):
""" (ObjectID obj) => FileID
Obtain an identifier for the file in which this object resides.
"""
import h5f
cdef hid_t fid
fid = H5Iget_file_id(obj.id)
if H5Iget_ref(fid) > 1:
H5Idec_ref(fid)
return h5f.FileID(fid)
def inc_ref(ObjectID obj not None):
""" (ObjectID obj)
Increment the reference count for the given object.
This function is provided for debugging only. Reference counting
is automatically synchronized with Python, and you can easily break
ObjectID instances by abusing this function.
"""
H5Iinc_ref(obj.id)
def get_ref(ObjectID obj not None):
""" (ObjectID obj) => INT
Retrieve the reference count for the given object.
"""
return H5Iget_ref(obj.id)
def dec_ref(ObjectID obj not None):
""" (ObjectID obj)
Decrement the reference count for the given object.
This function is provided for debugging only. Reference counting
is automatically synchronized with Python, and you can easily break
ObjectID instances by abusing this function.
"""
H5Idec_ref(obj.id)
|