GtkSource.SearchContext.forward

### Method

# GtkSource SearchContextforward

#### Declaration [src]

    gboolean
    gtk_source_search_context_forward (
      GtkSourceSearchContext* search,
      const GtkTextIter* iter,
      GtkTextIter* match_start,
      GtkTextIter* match_end,
      gboolean* has_wrapped_around
    )

#### Description [src]

Synchronous forward search.

It is recommended to use the asynchronous functions instead, to not block the user interface. However, if you are sure that the `buffer` is small, this function is more convenient to use.

If the `GtkSourceSearchSettings:wrap-around` property is `FALSE`, this function doesn’t try to wrap around.

The `has_wrapped_around` out parameter is set independently of whether a match is found. So if this function returns `FALSE`, `has_wrapped_around` will have the same value as the `GtkSourceSearchSettings:wrap-around` property.

#### Parameters

`iter` | `GtkTextIter`
| Start of search.
| The data is owned by the caller of the function.
`match_start` | `GtkTextIter`
| Return location for start of match, or `NULL`.
| The argument will be set by the function.
| The argument can be `NULL`.
| The data is owned by the caller of the function.
`match_end` | `GtkTextIter`
| Return location for end of match, or `NULL`.
| The argument will be set by the function.
| The argument can be `NULL`.
| The data is owned by the caller of the function.
`has_wrapped_around` | `gboolean*`
| Return location to know whether the search has wrapped around, or `NULL`.
| The argument will be set by the function.
| The argument can be `NULL`.

#### Return value

Returns: | `gboolean`
| Whether a match was found.