Class Pattern

Class constructor.

The only mandatory argument should be the pattern string.

This method MUST be reimplemented by subclasses of Pattern.

Overrides: object.__init__

Returns the maximum expected length of the strings matched by this pattern. Exact behavior is implementation dependent.

Ideally it should be an exact value, but in some cases it's not possible to calculate so an upper limit should be returned instead.

If that's not possible either an exception must be raised.

This value will be used to calculate the required buffer size when doing buffered searches.

This method MUST be reimplemented by subclasses of Pattern.

Reads the requested number of bytes from the process memory at the given address.

Subclasses of Pattern tipically don't need to reimplement this method.

Searches for the pattern in the given buffer, optionally starting at the given position within the buffer.

This method MUST be reimplemented by subclasses of Pattern.

Parameters:

• buffer (str) - Buffer to search on.
• pos (int) - (Optional) Position within the buffer to start searching from.

Returns: tuple( int, int )

Tuple containing the following:

• Position within the buffer where a match is found, or -1 if no match was found.
• Length of the matched data if a match is found, or undefined if no match was found.

This method gets called when a match is found.

This allows subclasses of Pattern to filter out unwanted results, or modify the results before giving them to the caller of Search.search_process.

If the return value is None the result is skipped.

Subclasses of Pattern don't need to reimplement this method unless filtering is needed.

Parameters:

• address (int) - The memory address where the pattern was found.
• size (int) - The size of the data that matches the pattern.
• data (str) - The data that matches the pattern.

Returns: tuple( int, int, str )

Tuple containing the following: * The memory address where the pattern was found. * The size of the data that matches the pattern. * The data that matches the pattern.