Plug-in Reference — Structures — FIND_REPLACE_INFO

# FIND_REPLACE_INFO

Used by EE_FIND_REPLACE message.

    typedef struct _FIND_REPLACE_INFO {
    	UINT cbSize;
    	UINT64 nFlags;
    	LPCWSTR pszFind;
    	LPCWSTR pszReplace;
    	UINT64 nCount;
    	UINT64 nMatchedLines;
    } FIND_REPLACE_INFO;

## Members

cbSize

[in] Size of this data structure, in bytes. Set this member to sizeof( FIND_REPLACE_INFO ) before sending the EE_FIND_REPLACE message.

nFlags

[in] Specifies a combination of the following values.

Value | Meaning
--- | ---
FLAG_FIND_AROUND | Moves to start/end of the text.
FLAG_FIND_BOL | The regular expression ‘^’ can match the beginning of the selection.
FLAG_FIND_BOOKMARK | Sets bookmarks on lines where the string is matched.
FLAG_FIND_CASE | Matches cases.
FLAG_FIND_COUNT | Counts the occurrences of the matched string.
FLAG_FIND_COUNT_FREQUENCY | Creates a table of frequent strings from the Extract results. Must combine with FLAG_FIND_EXTRACT and FLAG_FIND_OUTPUT_DISPLAY. Window Tabs must be enabled.
FLAG_FIND_EMBEDDED_NL | Matches embedded newlines in CSV documents and does not match other newlines.
FLAG_FIND_EOL | The regular expression ‘$’ can match the end of the selection.
FLAG_FIND_ESCAPE | Uses escape sequences.
FLAG_FIND_EXTRACT | Extracts matched lines to a new document.
FLAG_FIND_FUZZY | Uses fuzzy matching.
FLAG_FIND_LOOKAROUND | Looks around during selection only regular-expression searches.
FLAG_FIND_NEXT | Searches the string downward from the cursor position. If this flag is not set, searches the string upward.
FLAG_FIND_NO_OVERLAP | Does not match overlapping strings when finding a next or previous match.
FLAG_FIND_NO_PROMPT | Suppresses displaying a dialog box even if no string is found.
FLAG_FIND_NUMBER_RANGE | Matches a number range. This flag cannot be combined with FLAG_FIND_ESCAPE or FLAG_FIND_REG_EXP.
FLAG_FIND_ONLY_WORD | Searches only words.
FLAG_FIND_OPEN_DOC | Searches all open documents in the same frame window.
FLAG_FIND_OUTPUT | Displays the Extract results as a list in the Output Bar. Must combine with FLAG_FIND_EXTRACT.
FLAG_FIND_REG_EXP | Uses a regular expression.
FLAG_FIND_REGEX_BOOST | Uses Boost.Regex as the regular expression engine.
FLAG_FIND_REGEX_ONIGMO | Uses Onigmo as the regular expression engine, using the Ruby syntax.
FLAG_FIND_REGEX_ONIGMO_PERL | Uses Onigmo as the regular expression engine, using the Perl syntax.
FLAG_FIND_SAVE_HISTORY | Saves the searched string for repeated search.
FLAG_FIND_SELECT_ALL | Selects all matched strings.
FLAG_FIND_SEPARATE_CRLF | Treats CR and LF separately.
FLAG_FIND_SEL_ONLY | Searches only in the selection.
FLAG_REPLACE_ALL | Replaces all occurrences.
FLAG_REPLACE_SEL_ONLY | Replaces only in the selection when specified with FLAG_REPLACE_ALL.

pszFind

[in] Specifies a string to search for.

pszReplace

[in] Specifies a string to replace with. This value must be NULL if not replacing.

nCount

[out] Returns the number of occurrences when nFlags includes FLAG_FIND_COUNT, FLAG_FIND_BOOKMARK, FLAG_FIND_SELECT_ALL, FLAG_FIND_EXTRACT, FLAG_FIND_FILTER, or FLAG_REPLACE_ALL.

nMatchedLines

[out] Returns the number of matched lines when nFlags includes FLAG_FIND_COUNT, FLAG_FIND_BOOKMARK, FLAG_FIND_SELECT_ALL, FLAG_FIND_EXTRACT, FLAG_FIND_FILTER, or FLAG_REPLACE_ALL.

## Version

Supported on Version 15.7 or later.