Plug-in Reference — Inline Functions — Editor_ExtractFrequent

# Editor_ExtractFrequent

Extracts frequently used strings into a new document. You can use this inline function or explicitly send the EE_EXTRACT_FREQUENT message.

Editor_ExtractFrequent( HWND hwnd, UINT nType, UINT nNumOfLines, UINT iCsvFormat, UINT64 nFlags, LPCWSTR pszIgnore );

## Parameters

hwnd

Specifies the window handle of the view or frame of EmEditor.

nType

Specifies one of the following values.

Value | Meaning
--- | ---
FREQ_TYPE_LINES | Creates a list of frequent lines.
FREQ_TYPE_WORDS | Creates a list of frequent words. A word is a string surrounded by non-alphanumeric characters, which can be customized by the Treat the following characters as alphanumeric text box in the Edit page of the Customize dialog box.
FREQ_TYPE_CELLS | Creates a list of frequent cells.
FREQ_TYPE_IPV4 | Creates a list of frequent IPv4 addresses.
FREQ_TYPE_IPV6 | Creates a list of frequent IPv6 addresses.
FREQ_TYPE_URI | Creates a list of frequent URIs.
FREQ_TYPE_EMAIL | Creates a list of frequent email addresses.

nNumOfLines

Specifies the maximum number of strings to be extracted. The actual output may exceed this number in order to include all multiple strings detected for the same frequency.

iCsvFormat

Specifies the CSV format to display as.

nFlags

Specifies a combination of the following values.

Value | Meaning
--- | ---
FLAG_FIND_CASE | Matches cases.
FLAG_FIND_OPEN_DOC | Searches all open documents in the same frame window.
FLAG_FIND_SEL_ONLY | Searches only in the selection.

pszIgnore

Specifies strings to be ignored while counting frequent strings. Multiple strings must be separated by a line-feed (\n).

## Return Values

The return value is negative if an error occurs.

## Version

Supported on EmEditor Professional Version 21.9 or later.