LibreOffice
LibreOffice 24.2 SDK API Reference
Variables
com::sun::star::util::SearchFlags Constant Group Referencepublished

Flags for search methods. More...

Variables

const long ALL_IGNORE_CASE = 0x00000001
 
const long NORM_WORD_ONLY = 0x00000010
 Flag for normal (Boyer-Moore) search / Search for word only. More...
 
const long REG_EXTENDED = 0x00000100
 Flag for "regular expression" search / Interpret as extended regular expression. More...
 
const long REG_NOSUB = 0x00000200
 Flag for "regular expression" search / No register information or backreferences, i.e., avoid sub expressions. More...
 
const long REG_NEWLINE = 0x00000400
 Flag for "regular expression" search / Special new line treatment. More...
 
const long REG_NOT_BEGINOFLINE = 0x00000800
 The first character in the string is not the beginning of the line therefore ^ will not match with first character of the string. More...
 
const long REG_NOT_ENDOFLINE = 0x00001000
 The last character in the string is not the end of the line therefore $ will not match with last character of the string. More...
 
const long LEV_RELAXED = 0x00010000
 Flag for "Weighted Levenshtein Distance" search / Relaxed checking of limit, split weigh pools. More...
 
const long WILD_MATCH_SELECTION = 0x00100000
 Flag for wildcards search if entire selection must match the pattern. More...
 

Detailed Description

Flags for search methods.

Variable Documentation

◆ ALL_IGNORE_CASE

const long ALL_IGNORE_CASE = 0x00000001
Deprecated:
The constant ALL_IGNORE_CASE is never supported - use com::sun::star::i18n::TransliterationModules::IGNORE_CASE with SearchOptions::transliterateFlags() instead.
See also
com::sun::star::i18n::TransliterationModules

◆ LEV_RELAXED

const long LEV_RELAXED = 0x00010000

Flag for "Weighted Levenshtein Distance" search / Relaxed checking of limit, split weigh pools.

If not specified (strict), the search is successful if the WLD is within a calculated limit where each insertion, deletion and replacement adds a weight to a common pool of weights. This is the mathematically correct WLD.

From a user's point of view the strict WLD is an exclusive-OR of the arguments given, for example if allowed insertions=2 and allowed replacements=2, the search fails if 2 characters had been inserted and an additional operation would be needed to match. Depending on the weights it may also fail if 1 character was inserted and 1 character replaced and an additional operation would be needed to match. The strict algorithm may match less than expected from a first glance of the specified arguments, but does not return false positives.

If specified (relaxed), the search is also successful if the combined pool for insertions and deletions is below a doubled calculated limit and replacements are treated differently. Additionally, swapped characters are counted as one replacement.

From a user's point of view the relaxed WLD is an inclusive-OR of the arguments given, for example if allowed insertions=2 and allowed replacements=2, the search succeeds if 2 characters had been inserted and an additional replacement is needed to match. The relaxed algorithm may return false positives, but meets user expectation better.

◆ NORM_WORD_ONLY

const long NORM_WORD_ONLY = 0x00000010

Flag for normal (Boyer-Moore) search / Search for word only.

◆ REG_EXTENDED

const long REG_EXTENDED = 0x00000100

Flag for "regular expression" search / Interpret as extended regular expression.

Deprecated:
The flag is currently not supported by OOo.

◆ REG_NEWLINE

const long REG_NEWLINE = 0x00000400

Flag for "regular expression" search / Special new line treatment.

Deprecated:
The flag is currently not supported by OOo.

A NEWLINE character in string will not be matched by a period outside bracket expression or by any form of a non matching list.

A circumflex (^) in pattern when used to specify expression anchoring will match the zero length string immediately after a newline in string, regardless of the setting of REG_NOT_BEGINOFLINE.

A dollar-sign ($) in pattern when used to specify expression anchoring, will match zero-length string immediately before a new line in string, regardless of the setting of REG_NOT_ENDOFLINE.

◆ REG_NOSUB

const long REG_NOSUB = 0x00000200

Flag for "regular expression" search / No register information or backreferences, i.e., avoid sub expressions.

Return only true/false if matched or not.

Deprecated:
The flag is currently not supported by OOo.

◆ REG_NOT_BEGINOFLINE

const long REG_NOT_BEGINOFLINE = 0x00000800

The first character in the string is not the beginning of the line therefore ^ will not match with first character of the string.

◆ REG_NOT_ENDOFLINE

const long REG_NOT_ENDOFLINE = 0x00001000

The last character in the string is not the end of the line therefore $ will not match with last character of the string.

◆ WILD_MATCH_SELECTION

const long WILD_MATCH_SELECTION = 0x00100000

Flag for wildcards search if entire selection must match the pattern.

If com::sun::star::util::SearchOptions2::AlgorithmType2 is com::sun::star::util::SearchAlgorithms2::WILDCARD specifies whether a wildcard pattern must match the entire selected range of the string from start position to end position or a substring match is allowed.

If set, the entire selection must match. If not set, a substring match is allowed.

Since
LibreOffice 5.2