Функция

_FFXPath

Вернуть и установить значения связанные с запросом XPath

#Include <FF.au3>
_FFXPath($sQuery[, $sAttribute = "textContent"[, $iReturnType = 2[, $iFilter = 0]]])

Параметры

$sQuery

Запрос XPath

$sAttribute

Опционально:
Стандартное значение "textContent" означает установку и получение значения атрибута

$iReturnType

Опционально: ReturnType
0	= ANY_TYPE
1	= NUMBER_TYPE
2	= STRING_TYPE. Стандартное значение
3	= BOOLEAN_TYPE
6	= UNORDERED_NODE_SNAPSHOT_TYPE
7	= ORDERED_NODE_SNAPSHOT_TYPE
8	= ANY_UNORDERED_NODE_TYPE
9	= FIRST_ORDERED_NODE_TYPE
10	= COUNT (количество совпадений)
11	= CONTAINS (stringValue contains substring in $sAttribute)
12	= STARTS-WITH (stringValue start-with string in $sAttribute)
13	= SUBSTRING-AFTER (stringValue substring-after in $sAttribute)
14	= SUBSTRING-BEFORE (stringValue substring-bevore in $sAttribute)

$iFilter

Опционально: аддитивный фильтр
0	= Отключить. Стандартное значение
1	= Не ASCII символы
2	= Двойной пробельный символ
4	= Двойной символ перевода строки
8	= HTML tags
16	= Преобразователь простого HTML тега / сущности

Возвращаемое значение

Успешное выполнение:

Возвращается:

$sReturnMode	Type	Sets object xpath (FFau3.xpath)	Returns (string) object if $sAttribute = ""
0	-	X	X
1	Number	X	X
2	String	X	X
3	Boolean	X	X
6	Array	-	-
7	Array	-	-
8	Value	X	X
9	Value	X	X
10	Number	X	-
11	Boolean	X	-
12	Boolean	X	-
13	String	X	-
14	String	X	-

Ошибка:

Значение 0 и установка @ERROR

@ERROR:

0 ($_FF_ERROR_Success)
3 ($_FF_ERROR_InvalidDataType)
4 ($_FF_ERROR_InvalidValue)
8 ($_FF_ERROR_NoMatch)
9 ($_FF_ERROR_RetValue)
11 ($_FF_ERROR_InvalidExpression)

Замечания

Применяется FFau3.xpath.
Вызов с помощью:
_FFObj("xpath.attribute[=value]")
_FFObj("xpath", "attribute", "value]")
_FFCmd("FFau3.xpath.attribute[=value]")

Ссылки

http://www.w3.org/TR/xpath
https://developer.mozilla.org/en/XPath
https://developer.mozilla.org/En/XPathResult
https://developer.mozilla.org/en/Introduction_to_using_XPath_in_JavaScript

Связана с функциями

_FFGetValueById, _FFSetValueById, _FFSetValueByName, _FFGetValueById

Пример

#Include <Array.au3>
#Include <FF.au3>
If _FFConnect() Then
_FFTabAdd( "http://ff-au3-example.thorsten-willert.de/")

; counting the number of results from the Xpath query
MsgBox(64, "Number of password fields:", _FFXPath( "//input[@type='password']", "", 10))

; the textContent from the query result
MsgBox(64, "Fieldset-Legend:", _FFXPath( "//form[1]/fieldset/legend"))

; the textContent from option 2
MsgBox(64, "Text from 0ption 5:", _FFXPath( "//option[2]"))

; Method and action of the first form
$vTmp = "Method: " & _FFXPath( "//form[1]/@method") & @crlf
$vTmp &= "Action: " & _FFXPath( "//form[1]/@action")
MsgBox(64, "Form 2", $vTmp)

; array with the textContent of all options
$aArray = _FFXPath("//option","value",7)
_ArrayDisplay($aArray)

; working with the object returned from the query
_FFXPath("//form[1]//input[@type='checkbox' and position()=2]","",9)
MsgBox(64,"", _FFObj("xpath.type") & @crlf & _FFObj("xpath.value"))
_FFObj("xpath.checked=true")

EndIf