### ----------------------------------------------------
### -- Gnome::Gtk3
### -- Licenses: Artistic-2.0
### -- Authors: Marcel Timmerman
### -- File: lib/Gnome/Gtk3/TextIter.rakumod
### ----------------------------------------------------
### -- Chunk 3 of 3
chanism. This function is very fast; you can expect it to perform
better than e.g. getting the character offset for each iterator and
comparing the offsets yourself. Also, it’s a bit faster than
C<gtk_text_iter_compare()>.

Returns: C<1> if the iterators point to the same place in the buffer

  method gtk_text_iter_equal ( N-GTextIter $rhs --> Int  )

=item N-GTextIter $rhs; another B<Gnome::Gtk3::TextIter>

=end pod

sub gtk_text_iter_equal ( N-GTextIter $lhs, N-GTextIter $rhs )
  returns int32
  is native(&gtk-lib)
  { * }

#-------------------------------------------------------------------------------
#TM:0:gtk_text_iter_compare:
=begin pod
=head2 [gtk_] text_iter_compare

A C<qsort()>-style function that returns negative if I<lhs> is less than
I<rhs>, positive if I<lhs> is greater than I<rhs>, and 0 if they’re equal.
Ordering is in character offset order, i.e. the first character in the buffer
is less than the second character in the buffer.

Returns: -1 if I<lhs> is less than I<rhs>, 1 if I<lhs> is greater, 0 if they are equal

  method gtk_text_iter_compare ( N-GTextIter $rhs --> Int  )

=item N-GTextIter $rhs; another B<Gnome::Gtk3::TextIter>

=end pod

sub gtk_text_iter_compare ( N-GTextIter $lhs, N-GTextIter $rhs )
  returns int32
  is native(&gtk-lib)
  { * }

#-------------------------------------------------------------------------------
#TM:0:gtk_text_iter_in_range:
=begin pod
=head2 [[gtk_] text_iter_] in_range

Checks whether I<iter> falls in the range [I<start>, I<end>).
I<start> and I<end> must be in ascending order.

Returns: C<1> if I<iter> is in the range

  method gtk_text_iter_in_range ( N-GTextIter $start, N-GTextIter $end --> Int  )

=item N-GTextIter $start; start of range
=item N-GTextIter $end; end of range

=end pod

sub gtk_text_iter_in_range ( N-GTextIter $iter, N-GTextIter $start, N-GTextIter $end )
  returns int32
  is native(&gtk-lib)
  { * }

#-------------------------------------------------------------------------------
#TM:0:gtk_text_iter_order:
=begin pod
=head2 [gtk_] text_iter_order

Swaps the value of I<first> and I<second> if I<second> comes before
I<first> in the buffer. That is, ensures that I<first> and I<second> are
in sequence. Most text buffer functions that take a range call this
automatically on your behalf, so there’s no real reason to call it yourself
in those cases. There are some exceptions, such as C<gtk_text_iter_in_range()>,
that expect a pre-sorted range.


  method gtk_text_iter_order ( N-GTextIter $second )

=item N-GTextIter $second; another B<Gnome::Gtk3::TextIter>

=end pod

sub gtk_text_iter_order ( N-GTextIter $first, N-GTextIter $second )
  is native(&gtk-lib)
  { * }


