--                                                                    --
--  package                         Copyright (c)  Dmitry A. Kazakov  --
--     GLib.Chars_Ptr_Vectors                      Luebeck            --
--  Interface                                      Spring, 2009       --
--                                                                    --
--                                Last revision :  11:45 29 Jul 2018  --
--                                                                    --
--  This  library  is  free software; you can redistribute it and/or  --
--  modify it under the terms of the GNU General Public  License  as  --
--  published by the Free Software Foundation; either version  2  of  --
--  the License, or (at your option) any later version. This library  --
--  is distributed in the hope that it will be useful,  but  WITHOUT  --
--  ANY   WARRANTY;   without   even   the   implied   warranty   of  --
--  MERCHANTABILITY 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 along with  --
--  this library; if not, write to  the  Free  Software  Foundation,  --
--  Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, 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, this unit does not by  itself  cause  the  resulting  --
--  executable to be covered by the GNU General Public License. This  --
--  exception  does not however invalidate any other reasons why the  --
--  executable file might be covered by the GNU Public License.       --
--____________________________________________________________________--

with GtkAda.Types;  use GtkAda.Types;

with Interfaces.C.Pointers;

package GLib.Chars_Ptr_Vectors is

   type Chars_Ptr_Vector is
      array (Interfaces.C.Size_t range <>) of aliased Chars_Ptr;

   package Chars_Ptr_Pointers is
      new Interfaces.C.Pointers
          (  Interfaces.C.Size_t,
             Chars_Ptr,
             Chars_Ptr_Vector,
             Null_Ptr
          );
   use Chars_Ptr_Pointers;
   type Chars_Ptr_Ptr is new Pointer;
--
-- Convert_And_Free -- Conversion of  an object of gchar **  as returned
--                     from some subprograms
--
--    Vector - Array of C-strings allocated by GTK+
--
-- This function creates an equivalent Chars_Ptr_Array  and  then  frees
-- the  argument  using  g_strfreev.  The  result   does   not   contain
-- terminating NUL. The caller is responsible to free array elements.
--
-- Returns :
--
--    An equivalent of Chars_Ptr_Array type
--
   function Convert_And_Free (Vector : Chars_Ptr_Ptr)
      return Chars_Ptr_Array;
--
-- Convert -- Conversion of an object of const gchar * const *
--
--    Vector - Array of C-strings from GTK+
--
-- The elements of the result shall not be freed.
--
-- Returns :
--
--    An equivalent of Chars_Ptr_Array type
--
   function Convert (Vector : Chars_Ptr_Ptr) return Chars_Ptr_Array;

   procedure Free (Vector : Chars_Ptr_Ptr);
   pragma Import (C, Free, "g_strfreev");

end GLib.Chars_Ptr_Vectors;