Next / Previous / Contents / Shipman's homepage

18.8. Narrative.readChild() (static method)

Similar to Narrative.readNode(), but looks for the content in an optional child of the given node. See Section 18.7, “Narrative.readNode(): Read XML (static method)”.

birdnotes.py
# - - -   N a r r a t i v e . r e a d C h i l d

    @staticmethod
    def readChild(node, childName):
        """Look for a child with narrative content.
        """

        #-- 1 --
        # [ childList  :=  list of all children named childName ]
        childList = node.xpath(childName)

        #-- 2 --
        # [ if childList is nonempty ->
        #     return a Narrative instance representing the
        #     narrative content of childList[0]
        #   else -> return None ]
        if  len(childList) > 0:
            return Narrative.readNode(childList[0])
        else:
            return None