| ------------------------------------------------------------------------------ |
| -- -- |
| -- GNAT RUNTIME COMPONENTS -- |
| -- -- |
| -- A D A . C O M M A N D _ L I N E . R E M O V E -- |
| -- -- |
| -- S p e c -- |
| -- -- |
| -- $Revision: 1.1 $ |
| -- -- |
| -- Copyright (C) 1999 Free Software Foundation, Inc. -- |
| -- -- |
| -- GNAT is free software; you can redistribute it and/or modify it under -- |
| -- terms of the GNU General Public License as published by the Free Soft- -- |
| -- ware Foundation; either version 2, or (at your option) any later ver- -- |
| -- sion. GNAT is distributed in the hope that it will be useful, but WITH- -- |
| -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY -- |
| -- 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. -- |
| -- -- |
| -- As a special exception, if other files instantiate generics from this -- |
| -- unit, or you link this unit with other files to produce an executable, -- |
| -- this unit does not by itself cause the resulting executable to be -- |
| -- covered by the GNU General Public License. This exception does not -- |
| -- however invalidate any other reasons why the executable file might be -- |
| -- covered by the GNU Public License. -- |
| -- -- |
| -- GNAT was originally developed by the GNAT team at New York University. -- |
| -- It is now maintained by Ada Core Technologies Inc (http://www.gnat.com). -- |
| -- -- |
| ------------------------------------------------------------------------------ |
| |
| -- This package is intended to be used in conjunction with its parent unit, |
| -- Ada.Command_Line. It provides facilities for logically removing arguments |
| -- from the command line, so that subsequent calls to Argument_Count and |
| -- Argument will reflect the removals. |
| |
| -- For example, if the original command line has three arguments A B C, so |
| -- that Argument_Count is initially three, then after removing B, the second |
| -- argument, Argument_Count will be 2, and Argument (2) will return C. |
| |
| package Ada.Command_Line.Remove is |
| pragma Preelaborate (Remove); |
| |
| procedure Remove_Argument (Number : in Positive); |
| -- Removes the argument identified by Number, which must be in the |
| -- range 1 .. Argument_Count (i.e. an in range argument number which |
| -- reflects removals). If Number is out of range Constraint_Error |
| -- will be raised. |
| -- |
| -- Note: the numbering of arguments greater than Number is affected |
| -- by the call. If you need a loop through the arguments, removing |
| -- some as you go, run the loop in reverse to avoid confusion from |
| -- this renumbering: |
| -- |
| -- for J in reverse 1 .. Argument_Count loop |
| -- if Should_Remove (Arguments (J)) then |
| -- Remove_Argument (J); |
| -- end if; |
| -- end loop; |
| -- |
| -- Reversing the loop in this manner avoids the confusion. |
| |
| procedure Remove_Arguments (From : Positive; To : Natural); |
| -- Removes arguments in the given From..To range. From must be in the |
| -- range 1 .. Argument_Count and To in the range 0 .. Argument_Count. |
| -- Constraint_Error is raised if either argument is out of range. If |
| -- To is less than From, then the call has no effect. |
| |
| procedure Remove_Argument (Argument : String); |
| -- Removes the argument which matches the given string Argument. Has |
| -- no effect if no argument matches the string. If more than one |
| -- argument matches the string, all are removed. |
| |
| procedure Remove_Arguments (Argument_Prefix : String); |
| -- Removes all arguments whose prefix matches Argument_Prefix. Has |
| -- no effect if no argument matches the string. For example a call |
| -- to Remove_Arguments ("--") removes all arguments starting with --. |
| |
| end Ada.Command_Line.Remove; |
