Method

HexDocumentfind_forward

Declaration

gboolean
hex_document_find_forward (
  HexDocument* doc,
  gint64 start,
  const char* what,
  size_t len,
  gint64* offset
)

Description

Find a string forwards in a HexDocument.

This method will block. For a non-blocking version, use hex_document_find_forward_async(), which is also recommended for GUI operations, as it, unlike this method, allows for easy passing-in of found/not-found strings to be passed back to the interface.

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.

Return value

Returns: gboolean
 

TRUE if what was found by the requested operation; FALSE otherwise.