blob: b5918d6a1bc198fdd5f6d380146c41876ccaf087 [file] [log] [blame]
------------------------------------------------------------------------------
-- --
-- GNAT RUN-TIME COMPONENTS --
-- --
-- ADA.STRINGS.WIDE_UNBOUNDED.WIDE_TEXT_IO --
-- --
-- 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.Wide_Unbounded provides specialized
-- Wide_Text_IO routines that work directly with unbounded wide 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.Wide_Text_IO;
package Ada.Strings.Wide_Unbounded.Wide_Text_IO is
function Get_Line
return Unbounded_Wide_String;
function Get_Line
(File : Ada.Wide_Text_IO.File_Type) return Unbounded_Wide_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.Wide_Text_IO.File_Type;
Item : out Unbounded_Wide_String);
procedure Get_Line (Item : out Unbounded_Wide_String);
-- Similar to the above, but in procedure form with an out parameter
procedure Put
(U : Unbounded_Wide_String);
procedure Put
(File : Ada.Wide_Text_IO.File_Type;
U : Unbounded_Wide_String);
procedure Put_Line
(U : Unbounded_Wide_String);
procedure Put_Line
(File : Ada.Wide_Text_IO.File_Type;
U : Unbounded_Wide_String);
-- These are equivalent to the standard Wide_Text_IO routines passed the
-- value To_Wide_String (U), but operate more efficiently, because the
-- extra copy of the argument is avoided.
end Ada.Strings.Wide_Unbounded.Wide_Text_IO;