Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.trolltech.qt.core
Class QStringMatcher

    java.lang.Object
      com.trolltech.qt.QSignalEmitter
          com.trolltech.qt.QtJambiObject
              com.trolltech.qt.core.QStringMatcher

All Implemented Interfaces:
  QtJambiInterface, java.lang.Cloneable

    public class QStringMatcher

extends QtJambiObject
implements java.lang.Cloneable

The `QStringMatcher` class holds a sequence of characters that can be quickly matched in a Unicode string. This class is useful when you have a sequence of QChars that you want to repeatedly match against some strings (perhaps in a loop), or when you want to search for the same sequence of characters multiple times in the same string. Using a matcher object and `indexIn()` is faster than matching a plain QString with QString::indexOf() if repeated matching takes place. This class offers no benefit if you are doing one-off string matches.

Create the `QStringMatcher` with the QString you want to search for. Then call `indexIn()` on the QString that you want to search.

See also:
  QString, `QByteArrayMatcher`, and `QRegExp`.

Nested Class Summary

Nested classes/interfaces inherited from class com.trolltech.qt.QSignalEmitter
`QSignalEmitter.Signal0, QSignalEmitter.Signal1, QSignalEmitter.Signal2, QSignalEmitter.Signal3, QSignalEmitter.Signal4, QSignalEmitter.Signal5, QSignalEmitter.Signal6, QSignalEmitter.Signal7, QSignalEmitter.Signal8, QSignalEmitter.Signal9`

Constructor Summary
`QStringMatcher()` Constructs an empty string matcher that won't match anything.
`QStringMatcher(QStringMatcher other)` Copies the `other` string matcher to this string matcher.
`QStringMatcher(java.lang.String pattern)` Constructs a string matcher that will search for `pattern`, with case sensitivity `cs`.
`QStringMatcher(java.lang.String pattern, Qt.CaseSensitivity cs)` Constructs a string matcher that will search for `pattern`, with case sensitivity `cs`.

Method Summary
`Qt.CaseSensitivity` | `caseSensitivity()` Returns the case sensitivity setting for this string matcher.
`QStringMatcher` | `clone()` This method is reimplemented for internal reasons
`static QStringMatcher` | `fromNativePointer(QNativePointer nativePointer)` This method returns the QStringMatcher instance pointed to by `nativePointer`.
`int` | `indexIn(java.lang.String str)` Searches the string `str` from character position `from` (default 0, i.e.
`int` | `indexIn(java.lang.String str, int from)` Searches the string `str` from character position `from` (default 0, i.e.
`static QNativePointer` | `nativePointerArray(QStringMatcher[] array)` This function returns a QNativePointer that is pointing to the specified QStringMatcher array.
`java.lang.String` | `pattern()` Returns the string pattern that this string matcher will search for.
`void` | `setCaseSensitivity(Qt.CaseSensitivity cs)` Sets the case sensitivity setting of this string matcher to `cs`.
`void` | `setPattern(java.lang.String pattern)` Sets the string that this string matcher will search for to `pattern`.

Methods inherited from class com.trolltech.qt.QtJambiObject
`dispose, disposed, equals, finalize, reassignNativeResources, tr, tr, tr`

Methods inherited from class com.trolltech.qt.QSignalEmitter
`blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread`

Methods inherited from class java.lang.Object
`getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Methods inherited from interface com.trolltech.qt.QtJambiInterface
`disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership`

Constructor Detail

### QStringMatcher

    public QStringMatcher()

  Constructs an empty string matcher that won't match anything. Call `setPattern()` to give it a pattern to match.

### QStringMatcher

    public QStringMatcher(java.lang.String pattern)

  Constructs a string matcher that will search for `pattern`, with case sensitivity `cs`.

  Call `indexIn()` to perform a search.

### QStringMatcher

    public QStringMatcher(java.lang.String pattern,
                          Qt.CaseSensitivity cs)

  Constructs a string matcher that will search for `pattern`, with case sensitivity `cs`.

  Call `indexIn()` to perform a search.

### QStringMatcher

    public QStringMatcher(QStringMatcher other)

  Copies the `other` string matcher to this string matcher.

Method Detail

### caseSensitivity

    public final Qt.CaseSensitivity caseSensitivity()

  Returns the case sensitivity setting for this string matcher.

See also:
  `setCaseSensitivity()`.

### indexIn

    public final int indexIn(java.lang.String str)

  Searches the string `str` from character position `from` (default 0, i.e. from the first character), for the string `pattern()` that was set in the constructor or in the most recent call to `setPattern()`. Returns the position where the `pattern()` matched in `str`, or -1 if no match was found.

See also:
  `setPattern()`, and `setCaseSensitivity()`.

### indexIn

    public final int indexIn(java.lang.String str,
                             int from)

  Searches the string `str` from character position `from` (default 0, i.e. from the first character), for the string `pattern()` that was set in the constructor or in the most recent call to `setPattern()`. Returns the position where the `pattern()` matched in `str`, or -1 if no match was found.

See also:
  `setPattern()`, and `setCaseSensitivity()`.

### pattern

    public final java.lang.String pattern()

  Returns the string pattern that this string matcher will search for.

See also:
  `setPattern()`.

### setCaseSensitivity

    public final void setCaseSensitivity(Qt.CaseSensitivity cs)

  Sets the case sensitivity setting of this string matcher to `cs`.

See also:
  `caseSensitivity()`, `setPattern()`, and `indexIn()`.

### setPattern

    public final void setPattern(java.lang.String pattern)

  Sets the string that this string matcher will search for to `pattern`.

See also:
  `pattern()`, `setCaseSensitivity()`, and `indexIn()`.

### fromNativePointer

    public static QStringMatcher fromNativePointer(QNativePointer nativePointer)

  This method returns the QStringMatcher instance pointed to by `nativePointer`.

### nativePointerArray

    public static QNativePointer nativePointerArray(QStringMatcher[] array)

  This function returns a QNativePointer that is pointing to the specified QStringMatcher array.

### clone

    public QStringMatcher clone()

  This method is reimplemented for internal reasons

  Overrides:
    `clone` in class `java.lang.Object`

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD