blob: a892f0d4cadb1ec75e0de3d36b16e0b2ff41a1f2 [file] [log] [blame]
------------------------------------------------------------------------------
-- --
-- GNAT RUN-TIME COMPONENTS --
-- --
-- A D A . S T R I N G S . U N B O U N D E D . T E X T _ I O --
-- --
-- S p e c --
-- --
-- Copyright (C) 1997-2022, 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 3, 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. --
-- --
-- As a special exception under Section 7 of GPL version 3, you are granted --
-- additional permissions described in the GCC Runtime Library Exception, --
-- version 3.1, as published by the Free Software Foundation. --
-- --
-- You should have received a copy of the GNU General Public License and --
-- a copy of the GCC Runtime Library Exception along with this program; --
-- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
-- <http://www.gnu.org/licenses/>. --
-- --
-- GNAT was originally developed by the GNAT team at New York University. --
-- Extensive contributions were provided by Ada Core Technologies Inc. --
-- --
------------------------------------------------------------------------------
-- This child package of Ada.Strings.Unbounded provides some specialized
-- Text_IO routines that work directly with unbounded strings, avoiding the
-- inefficiencies of access via the standard interface, and also taking
-- direct advantage of the variable length semantics of these strings.
with Ada.Text_IO;
package Ada.Strings.Unbounded.Text_IO is
function Get_Line return Unbounded_String;
function Get_Line (File : Ada.Text_IO.File_Type) return Unbounded_String;
-- Reads up to the end of the current line, returning the result
-- as an unbounded string of appropriate length. If no File parameter
-- is present, input is from Current_Input.
procedure Get_Line
(File : Ada.Text_IO.File_Type;
Item : out Unbounded_String);
procedure Get_Line (Item : out Unbounded_String);
-- Similar to the above, but in procedure form with an out parameter
procedure Put (U : Unbounded_String);
procedure Put (File : Ada.Text_IO.File_Type; U : Unbounded_String);
procedure Put_Line (U : Unbounded_String);
procedure Put_Line (File : Ada.Text_IO.File_Type; U : Unbounded_String);
-- These are equivalent to the standard Text_IO routines passed the
-- value To_String (U), but operate more efficiently, because the extra
-- copy of the argument is avoided.
end Ada.Strings.Unbounded.Text_IO;