NAME

       Gtk2::version -  Library Version Information

SYNOPSIS

         use Gtk2 '1.023';  # require at least version 1.023 of the bindings

         if ($Gtk2::VERSION >= 1.040 and Gtk2->CHECK_VERSION (2, 4, 0)) {
            # the GtkFileChooser, new in gtk+ 2.4.0 and first supported in
            # Gtk2-Perl at 1.040, is available
         } else {
            # GtkFileChooser is not available, fall back to GtkFileSelection
         }

DESCRIPTION

       Since the Gtk2 Perl module is a bridge to an external library with its own versions and API revisions, we
       have three different versions available for inspection.  Which one you need to use at which time depends
       entirely on the situation.  Gtk2 uses the same scheme as Glib and the underlying gtk+ C library; that is,
       the standard $Gtk2::VERSION for the version of the bindings, all-caps (MAJOR|MINOR|MICRO)_VERSION
       functions for the bound version, and lower-case (major|minor|micro)_version functions for the runtime
       version.  See Glib::version and <http://developer.gnome.org/doc/API/2.0/gtk/gtk-Feature-Test-Macros.html>
       for more information.

       Note also that gtk_check_version() and GTK_CHECK_VERSION() have different semantics in C, and we have
       preserved those faithfully.

METHODS

   boolean = Gtk2->CHECK_VERSION ($required_major, $required_minor, $required_micro)
       •   $required_major (integer)

       •   $required_minor (integer)

       •   $required_micro (integer)

       Provides  a  mechanism  for  checking the version information that Gtk2 was compiled against. Essentially
       equvilent to the macro GTK_CHECK_VERSION. In  most  cases  this  function  should  be  used  rather  than
       check_version ().

   (MAJOR, MINOR, MICRO) = Gtk2->GET_VERSION_INFO
       Shorthand  to  fetch  as a list the gtk+ version for which Gtk2 was compiled.  See "Gtk2::MAJOR_VERSION",
       etc.

   integer = Gtk2::MAJOR_VERSION
       The major  version  of  the  gtk+  library  against  which  Gtk2  was  compiled.   Equivalent  to  gtk+'s
       GTK_MAJOR_VERSION.

   integer = Gtk2::MICRO_VERSION
       The  micro  version  of  the  gtk+  library  against  which  Gtk2  was  compiled.   Equivalent  to gtk+'s
       GTK_MICRO_VERSION.

   integer = Gtk2::MINOR_VERSION
       The minor  version  of  the  gtk+  library  against  which  Gtk2  was  compiled.   Equivalent  to  gtk+'s
       GTK_MINOR_VERSION.

   string = Gtk2->check_version ($required_major, $required_minor, $required_micro)
       •   $required_major (integer)

       •   $required_minor (integer)

       •   $required_micro (integer)

       Returns  undef  if  the  version of gtk+ currently in use is compatible with the given version, otherwise
       returns a string describing the mismatch.  Note that this is not the same logic as "Gtk2::CHECK_VERSION".
       This check is not terribly reliable, and should not be used  to  test  for  availability  of  widgets  or
       functions  in  the  Gtk2  module  ---  use  "Gtk2::CHECK_VERSION" for that.  See Glib::version for a more
       detailed description of when you'd want to do a runtime-version test.

   integer = Gtk2::major_version
       The major version of the gtk+ library current in use at runtime.  Equivalent to  gtk+'s  global  variable
       gtk_major_version.

   integer = Gtk2::micro_version
       The  micro  version  of the gtk+ library current in use at runtime.  Equivalent to gtk+'s global variable
       gtk_micro_version.

   integer = Gtk2::minor_version
       The minor version of the gtk+ library current in use at runtime.  Equivalent to  gtk+'s  global  variable
       gtk_minor_version.

   (major, minor, micro) = Gtk2->get_version_info
       Shorthand  to  fetch as a list the gtk+ version against which Gtk2 is linked.  See "Gtk2::major_version",
       etc.

SEE ALSO

       Gtk2, Glib::version

COPYRIGHT

       Copyright (C) 2003-2011 by the gtk2-perl team.

       This software is licensed under the LGPL.  See Gtk2 for a full notice.

perl v5.26.0                                       2017-07-27                                 Gtk2::version(3pm)