Hex.Document.find_forward_async

### Method

# Hex Documentfind_forward_async

#### Declaration

    void
    hex_document_find_forward_async (
      HexDocument* doc,
      gint64 start,
      const char* what,
      size_t len,
      gint64* offset,
      const char* found_msg,
      const char* not_found_msg,
      GCancellable* cancellable,
      GAsyncReadyCallback callback,
      gpointer user_data
    )

#### Description

Non-blocking version of `hex_document_find_forward()`. This is the function that should generally be used by a GUI client to find a string forwards in a `HexDocument`.

#### Parameters

`start` | `gint64`
| Starting offset byte of the payload to commence the search.
`what` | An array of `char`
| A pointer to the data to search within the `HexDocument`.
| The length of the array is specified in the `len` argument.
| The data is owned by the caller of the function.
| Each element is a NUL terminated UTF-8 string.
`len` | `size_t`
| Length in bytes of the data to be searched for.
`offset` | `gint64*`
| Offset of the found string, if the method returns `TRUE`.
| The argument will be set by the function.
`found_msg` | `const char*`
| Message intended to be displayed by the client if the string is found.
| The data is owned by the caller of the function.
| The value is a NUL terminated UTF-8 string.
`not_found_msg` | `const char*`
| Message intended to be displayed by the client if the string is not found.
| The data is owned by the caller of the function.
| The value is a NUL terminated UTF-8 string.
`cancellable` | `GCancellable`
| No description available.
| The argument can be `NULL`.
| The data is owned by the caller of the function.
`callback` | `GAsyncReadyCallback`
| Function to be called when the operation is complete.
| The argument can be `NULL`.
`user_data` | `gpointer`
| No description available.
| The argument can be `NULL`.
| The data is owned by the caller of the function.