------------------------------------------------------------------------------

--                                                                          --

--             ASIS Tester And iNTerpreter (ASIStant) COMPONENTS            --

--                                                                          --

--                 A S I S T A N T . F I N D _ E L E M E N T                --

--                                                                          --

--                         F u n c t i o n   S p e c                        --

--                                                                          --

--          Copyright (c) 1997-1999, Free Software Foundation, Inc.         --

--                                                                          --

-- ASIStant is free software; you can redistribute it and/or modify it      --

-- under terms of the  GNU General Public License  as published by the Free --

-- Software Foundation;  either version 2,  or  (at your option)  any later --

-- version. ASIStant is distributed  in the hope  that it will be useful,   --

-- but WITHOUT ANY WARRANTY; without even the implied warranty of MER-      --

-- CHANTABILITY or  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General  --

-- Public License for more details. You should have received a copy of the  --

-- GNU General Public License distributed with GNAT; see file COPYING. If   --

-- not, write to the Free Software Foundation, 59 Temple Place Suite 330,   --

-- Boston, MA 02111-1307, USA.                                              --

--                                                                          --

-- ASIStant is an evolution of ASIStint tool that was created by            --

-- Vasiliy Fofanov as part of a collaboration between Software Engineering  --

-- Laboratory of the Swiss Federal Institute of Technology in Lausanne,     --

-- Switzerland, and the Scientific Research Computer Center of the Moscow   --

-- University, Russia, supported by the Swiss National Science Foundation   --

-- grant #7SUPJ048247, "Development of ASIS for GNAT with industry quality" --

--                                                                          --

-- The original version of this function was created by Ilia Chentsov.      --

--                                                                          --

-- ASIStant is distributed as a part of the ASIS implementation for GNAT    --

-- (ASIS-for-GNAT) and is maintained by Ada Core Technologies Inc           --

-- (http://www.gnat.com).                                                   --

------------------------------------------------------------------------------


with Asis;

function ASIStant.Find_Element
  (Unit : in Asis.Compilation_Unit;
   Line, Col : in Integer) return Asis.Element;
--  Searches for the 'smallest' element at position Line:Col in

--  the unit Unit (that is, the element that contains this text position but

--  is not a parent to any other element containing this text position).

--  If the Unit is Nil_Compilation_Unit or if no element in this unit includes

--  position Line:Col, the function returns Nil_Element.