Set the XML node's pretext value to that of the supplied chain.

Declared in file: hzDocument.h
Defined in file : hzDocXml.cpp

Function Logic:

Function body:

hzEcode hzXmlNode::SetPretext (hzChain& Z)
{
   //  Set the XML node's pretext value to that of the supplied chain.
   //  
   //  Arguments: 1) Z The hzChain containing the pretext value
   //  
   //  Returns: E_OVERFLOW If the chain content exceeds the maximum allowed size for a hzString
   //     E_OK  If the operation is successful
   _hzfunc("hzXmlNode::SetPretext") ;
   hzString    P ;             //  Pretext value
   hzEcode     rc = E_OK ;     //  Return code
   if (!m_pHostDoc)
       hzexit(E_NOINIT, "Node has no host document") ;
   if (Z.Size() > HZSTRING_MAXLEN)
       { P = "overflow" ; rc = E_OVERFLOW ; }
   else
       P = Z ;
   if (!m_pHostDoc->m_Dict.Exists(P))
       m_pHostDoc->m_Dict.Insert(P) ;
   m_Ptxt = m_pHostDoc->m_Dict[P] ;
   return rc ;
}