------------------------------------------------------------------------------
-- --
--- GNAT RUNTIME COMPONENTS --
+-- GNAT RUN-TIME COMPONENTS --
-- --
-- A D A . S T R I N G S . W I D E _ U N B O U N D E D . A U X --
-- --
-- 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. --
+-- to the Free Software Foundation, 51 Franklin Street, Fifth Floor, --
+-- Boston, MA 02110-1301, 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, --
-- utilities.
package Ada.Strings.Wide_Unbounded.Aux is
-pragma Preelaborate (Aux);
+ pragma Preelaborate;
- function Get_Wide_String
- (U : Unbounded_Wide_String) return Wide_String_Access;
+ procedure Get_Wide_String
+ (U : Unbounded_Wide_String;
+ S : out Wide_String_Access;
+ L : out Natural);
pragma Inline (Get_Wide_String);
- -- This function returns the internal string pointer used in the
- -- representation of an unbounded string. There is no copy involved,
- -- so the value obtained references the same string as the original
- -- unbounded string. The characters of this string may not be modified
- -- via the returned pointer, and are valid only as long as the original
- -- unbounded string is not modified. Violating either of these two
- -- rules results in erroneous execution.
+ -- This procedure returns the internal string pointer used in the
+ -- representation of an unbounded string as well as the actual current
+ -- length (which may be less than S.all'Length because in general there
+ -- can be extra space assigned). The characters of this string may be
+ -- not be modified via the returned pointer, and are valid only as
+ -- long as the original unbounded string is not accessed or modified.
--
- -- This function is much more efficient than the use of To_Wide_String
+ -- This procedure is much more efficient than the use of To_Wide_String
-- since it avoids the need to copy the string. The lower bound of the
- -- referenced string returned by this call is always one.
+ -- referenced string returned by this call is always one, so the actual
+ -- string data is always accessible as S (1 .. L).
procedure Set_Wide_String
(UP : in out Unbounded_Wide_String;
OSDN Git Service
