Subversion Repositories openrisc_2011-10-31

------------------------------------------------------------------------------

--                                                                          --

--                         GNAT COMPILER COMPONENTS                         --

--                                                                          --

--                 I N T E R F A C E S . C . S T R I N G S                  --

--                                                                          --

--                                 S p e c                                  --

--                                                                          --

--          Copyright (C) 1993-2009, Free Software Foundation, Inc.         --

--                                                                          --

-- This specification is derived from the Ada Reference Manual for use with --

-- GNAT. The copyright notice above, and the license provisions that follow --

-- apply solely to the  contents of the part following the private keyword. --

--                                                                          --

-- 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.      --

--                                                                          --

------------------------------------------------------------------------------

package Interfaces.C.Strings is

   pragma Preelaborate;

   type char_array_access is access all char_array;

   pragma No_Strict_Aliasing (char_array_access);

   --  Since this type is used for external interfacing, with the pointer

   --  coming from who knows where, it seems a good idea to turn off any

   --  strict aliasing assumptions for this type.

   type chars_ptr is private;

   type chars_ptr_array is array (size_t range <>) of chars_ptr;

   Null_Ptr : constant chars_ptr;

   function To_Chars_Ptr

     (Item      : char_array_access;

      Nul_Check : Boolean := False) return chars_ptr;

   function New_Char_Array (Chars : char_array) return chars_ptr;

   function New_String (Str : String) return chars_ptr;

   procedure Free (Item : in out chars_ptr);

   Dereference_Error : exception;

   function Value (Item : chars_ptr) return char_array;

   function Value

     (Item   : chars_ptr;

      Length : size_t) return char_array;

   function Value (Item : chars_ptr) return String;

   function Value

     (Item   : chars_ptr;

      Length : size_t) return String;

   function Strlen (Item : chars_ptr) return size_t;

   procedure Update

     (Item   : chars_ptr;

      Offset : size_t;

      Chars  : char_array;

      Check  : Boolean := True);

   procedure Update

     (Item   : chars_ptr;

      Offset : size_t;

      Str    : String;

      Check  : Boolean := True);

   Update_Error : exception;

private

   type chars_ptr is access all Character;

   pragma Convention (C, chars_ptr);

   pragma No_Strict_Aliasing (chars_ptr);

   --  Since this type is used for external interfacing, with the pointer

   --  coming from who knows where, it seems a good idea to turn off any

   --  strict aliasing assumptions for this type.

   Null_Ptr : constant chars_ptr := null;

end Interfaces.C.Strings;