1------------------------------------------------------------------------------ 2-- -- 3-- GNAT RUNTIME COMPONENTS -- 4-- -- 5-- S Y S T E M . W C H _ W T S -- 6-- -- 7-- S p e c -- 8-- -- 9-- Copyright (C) 1992-1998 Free Software Foundation, Inc. -- 10-- -- 11-- GNAT is free software; you can redistribute it and/or modify it under -- 12-- terms of the GNU General Public License as published by the Free Soft- -- 13-- ware Foundation; either version 2, or (at your option) any later ver- -- 14-- sion. GNAT is distributed in the hope that it will be useful, but WITH- -- 15-- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY -- 16-- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License -- 17-- for more details. You should have received a copy of the GNU General -- 18-- Public License distributed with GNAT; see file COPYING. If not, write -- 19-- to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, -- 20-- MA 02111-1307, USA. -- 21-- -- 22-- As a special exception, if other files instantiate generics from this -- 23-- unit, or you link this unit with other files to produce an executable, -- 24-- this unit does not by itself cause the resulting executable to be -- 25-- covered by the GNU General Public License. This exception does not -- 26-- however invalidate any other reasons why the executable file might be -- 27-- covered by the GNU Public License. -- 28-- -- 29-- GNAT was originally developed by the GNAT team at New York University. -- 30-- Extensive contributions were provided by Ada Core Technologies Inc. -- 31-- -- 32------------------------------------------------------------------------------ 33 34-- This package contains the routine used to convert wide strings to 35-- strings for use by wide character attributes (value, image etc.) and 36-- also by the numeric IO subpackages of Ada.Text_IO.Wide_Text_IO. 37 38with System.WCh_Con; 39 40package System.WCh_WtS is 41pragma Pure (WCh_WtS); 42 43 function Wide_String_To_String 44 (S : Wide_String; 45 EM : System.WCh_Con.WC_Encoding_Method) 46 return String; 47 -- This routine simply takes its argument and converts it to a string, 48 -- using the internal compiler escape sequence convention (defined in 49 -- package Widechar) to translate characters that are out of range 50 -- of type String. In the context of the Wide_Value attribute, the 51 -- argument is the original attribute argument, and the result is used 52 -- in a call to the corresponding Value attribute function. If the method 53 -- for encoding is a shift-in, shift-out convention, then it is assumed 54 -- that normal (non-wide character) mode holds at the start and end of 55 -- the result string. EM indicates the wide character encoding method. 56 -- Note: in the WCEM_Brackets case, we only use the brackets encoding 57 -- for characters greater than 16#FF#. 58 59end System.WCh_WtS; 60