Find Method (ExtractionCursor, String, ActionType, Boolean)

WebSocketMessage Find Method (ExtractionCursor, String, ActionType, Boolean)

C# API

Finds the specified text within this WebSocketMessage, specifying whether the search will be case-sensitive, and what action to take in case of failure.

Namespace: Facilita.Web
Assembly: clrWebBrowser (in clrWebBrowser.dll) Version: 9.5.7.98 (1.0.0.0)

Syntax

C++

Copy to Clipboard Print

public bool Find(
	ExtractionCursor cursor,
	string text,
	ActionType failAction,
	bool caseSensitive
)

public bool Find(
	ExtractionCursor cursor,
	string text,
	ActionType failAction,
	bool caseSensitive
)

Parameters

cursor: Type: Facilita.Native ExtractionCursor
An ExtractionCursor object to store the success/failure of the action, and the index in the message at which the match was found.

text: Type: System String
The text to search for.

failAction: Type: Facilita.Fc.Runtime ActionType
The action to take if text cannot be found.

caseSensitive: Type: System Boolean
true if the search should be case-sensitive.

Return Value

true if the specified text was found in this WebSocketMessage; otherwise, false.

Remarks

Information about the success/failure of this method will be stored in the ExtractionCursor object passed.

Examples

The following example demonstrates finding text within a WebSocketMessage.

C++

Copy to Clipboard Print

ExtractionCursor cursor = new ExtractionCursor();
if (!webSocketMessage.Find(cursor, "some text", ActionType.ACT_NONE, false))
{
    Warn("some text not found: " + cursor.ErrorMessage);
    NextIteration();
}

WriteMessage(string.Format("Text found at position {0}", cursor.Index));

ExtractionCursor cursor = new ExtractionCursor();
if (!webSocketMessage.Find(cursor, "some text", ActionType.ACT_NONE, false))
{
    Warn("some text not found: " + cursor.ErrorMessage);
    NextIteration();
}

WriteMessage(string.Format("Text found at position {0}", cursor.Index));