2008-05-27 Vincent Celier <celier@adacore.com>

[pf3gnuchains/gcc-fork.git] / gcc / ada / s-imgwch.ads

diff --git a/gcc/ada/s-imgwch.ads b/gcc/ada/s-imgwch.ads
index 3dbff97..17e717f 100644 (file)
--- a/gcc/ada/s-imgwch.ads
+++ b/gcc/ada/s-imgwch.ads
@@ -6,7 +6,7 @@
 --                                                                          --
 --                                 S p e c                                  --
 --                                                                          --
---           Copyright (C) 1992-2005 Free Software Foundation, Inc.         --
+--          Copyright (C) 1992-2007, 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- --
@@ -34,12 +34,25 @@
 --  Wide_[Wide_]Character'Image
 
 package System.Img_WChar is
-pragma Pure (Img_WChar);
+   pragma Pure;
 
-   function Image_Wide_Character (V : Wide_Character) return String;
-   --  Computes Wide_Character'Image (V) and returns the computed result
+   procedure Image_Wide_Character
+     (V        : Wide_Character;
+      S        : in out String;
+      P        : out Natural;
+      Ada_2005 : Boolean);
+   --  Computes Wide_Character'Image (V) and stores the result in S (1 .. P)
+   --  setting the resulting value of P. The caller guarantees that S is long
+   --  enough to hold the result, and that S'First is 1. The parameter Ada_2005
+   --  is True if operating in Ada 2005 mode (or beyond). This is required to
+   --  deal with the annoying FFFE/FFFF incompatibility.
 
-   function Image_Wide_Wide_Character (V : Wide_Wide_Character) return String;
-   --  Computes Wide_Wide_Character'Image (V) and returns the computed result
+   procedure Image_Wide_Wide_Character
+     (V : Wide_Wide_Character;
+      S : in out String;
+      P : out Natural);
+   --  Computes Wide_Wide_Character'Image (V) and stores the result in
+   --  S (1 .. P) setting the resulting value of P. The caller guarantees
+   --  that S is long enough to hold the result, and that S'First is 1.
 
 end System.Img_WChar;