Method

HexDocumentfind_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.