Perform a lookup for a string assumed to be a member of one or more groups and stop at the first group the member fits.

Declared in file: hzNamering.h
Defined in file : hzNamering.cpp

Function Logic:

Function body:

hzString hzNamering::RootLocate (hzString& member)
{
   //  Perform a lookup for a string assumed to be a member of one or more groups and stop at the first group the member fits.
   //  
   //  Arguments: 1) member Name of name-ring member sought
   //  
   //  Returns: Instance of hzString by value being root of the first group the member fits.
   _hzfunc("hzNamering::RootLocate(1)") ;
   hzString    S ;     //  Target  string
   uint32_t    nPos ;  //  First name group found
   if (member)
   {
       mx->m_Lock.LockWrite() ;
       nPos = mx->m_Roots.First(member) ;
       if (nPos >&eq; 0)
           S = mx->m_Roots.GetObj(nPos) ;
       mx->m_Lock.Unlock() ;
   }
   return S ;
}