python::Handle Class Reference

################## ## ## ############ ## ## ## ## Handle ## ## ## ## ############ ## ## ################## ## More...

List of all members.

Public Member Functions
def	__init__
def	__str__
def	isValid
def	product
Private Member Functions
def	_addressOf
def	_setStatus
def	_typeInfoGetter
	Private member functions ##.
Private Attributes
	_exception
	_type
	_typeInfo
	_wrapper

---

Detailed Description

################## ## ## ############ ## ## ## ## Handle ## ## ## ## ############ ## ## ################## ##

Python interface to FWLite Handle class

Definition at line 49 of file __init__.py.

---

Constructor & Destructor Documentation

def python::Handle::__init__	(		self,
			typeString,
			kwargs
	)

Initialize python handle wrapper 

Definition at line 52 of file __init__.py.

                           :
        """Initialize python handle wrapper """
        # turn off warnings
        oldWarningLevel = ROOT.gErrorIgnoreLevel
        ROOT.gErrorIgnoreLevel = ROOT.kError
        self._type      = typeString 
        self._wrapper   = ROOT.edm.Wrapper (self._type)()
        self._typeInfo  = self._wrapper.typeInfo()
        self._exception = RuntimeError ("getByLabel not called for '%s'", self)
        ROOT.SetOwnership (self._wrapper, False)
        # restore warning state
        ROOT.gErrorIgnoreLevel = oldWarningLevel
        # O.k.  This is a little weird.  We want a pointer to an EDM
        # wrapper, but we don't want the memory it is pointing to.
        # So, we've created it and grabbed the type info.  Since we
        # don't want a memory leak, we destroy it.
        if kwargs.get ('noDelete'):
            print "Not deleting wrapper"
            del kwargs['noDelete']
        else:
            self._wrapper.IsA().Destructor( self._wrapper )
        # Since we deleted the options as we used them, that means
        # that kwargs should be empty.  If it's not, that means that
        # somebody passed in an argument that we're not using and we
        # should complain.
        if len (kwargs):
            raise RuntimeError, "Unknown arguments %s" % kwargs

---

Member Function Documentation

def python::Handle::__str__

(

self

)

Definition at line 96 of file __init__.py.

00097                       :
00098         return "%s" % (self._type)
00099 
                                          

def python::Handle::_addressOf

(

self

)

[private]

(Internal) Return address of edm wrapper

Definition at line 107 of file __init__.py.

                         :
        """(Internal) Return address of edm wrapper"""
        return ROOT.AddressOf (self._wrapper)

def python::Handle::_setStatus	(		self,
			getByLabelSuccess,
			labelString
	)		[private]

(Internal) To be called by Events.getByLabel

Definition at line 112 of file __init__.py.

                                                         :
        """(Internal) To be called by Events.getByLabel"""
        if not getByLabelSuccess:
            self._exception = RuntimeError ("getByLabel (%s, %s) failed" \
                                            % (self, labelString))
            return
        if not self._wrapper.isPresent():
            self._exception = RuntimeError ("getByLabel (%s, %s) not present this event" \
                                            % (self, labelString))
            return
        # if we're still here, then everything is happy.  Clear the exception
        self._exception = None

def python::Handle::_typeInfoGetter

(

self

)

[private]

Private member functions ##.

(Internal) Return the type info

Definition at line 102 of file __init__.py.

                              :
        """(Internal) Return the type info"""
        return self._typeInfo

def python::Handle::isValid

(

self

)

Returns true if getByLabel call was successful and data is
present in handle.

Definition at line 83 of file __init__.py.

                      :
        """Returns true if getByLabel call was successful and data is
        present in handle."""
        return not self._exception

def python::Handle::product

(

self

)

Returns product stored in handle.

Definition at line 89 of file __init__.py.

                      :
        """Returns product stored in handle."""
        if self._exception:
            raise self._exception
        return self._wrapper.product()

---

Member Data Documentation

python::Handle::_exception [private]

Definition at line 52 of file __init__.py.

python::Handle::_type [private]

Definition at line 52 of file __init__.py.

python::Handle::_typeInfo [private]

Definition at line 52 of file __init__.py.

python::Handle::_wrapper [private]

Definition at line 52 of file __init__.py.