Perl XML:: LibXML: findnode vs. findvalue vs. find - какая разница?

Я использую XML::LibXML, и мне просто нужно получить количество узлов, указанное выражением XPath.

Используя одну из первых двух строк кода ниже, вы получите то, что я ищу. Я могу использовать функцию count XPath с findvalue или find, но не findnodes (да, я знаю, потому что он возвращает список).

my $node_cnt = $dom->findvalue("count($xpath_str)");  # WORKS!
my $node_cnt = $dom->find("count($xpath_str)");       # WORKS!
my @node_cnt = $dom->findnodes("count($xpath_str)");  # count doesn't work!

Это приводит меня к общему вопросу: Какая разница между тремя типами find? В документации говорится:

$string = $node->findvalue($xpath)
$result = $node->find($xpath)
@nodes  = $node->findnodes($xpath_expression)

  • Есть ли разница между аргументом $xpath_expression и просто $xpath в документации?

  • Для двух возвращающих скаляр, какая разница?

Я пытаюсь понять значение использования одного типа поиска над другим - спасибо!

Ответы

Ответ 1

Разница - это тип значения, возвращаемого методами.

  • findnodes используется для возврата списка узлов. Если метод вызывается в контексте списка, он возвращает список объектов соответствующего типа, например XML::LibXML::Element, XML::LibXML::Text и т.д. Если он вызывается в скалярном контексте, он возвращает один объект XML::LibXML::NodeList, который содержит та же информация.

    Он не может использоваться для возврата произвольного выражения, например $dom->findnodes('42') ничего не вернет. Вы можете получать только узлы списка документов из этого метода.

  • findvalue используется для возврата одного текстового или числового значения, т.е. не XML node. Если вы передадите выражение XPath, которое оценивает список node, тогда он преобразует этот список в текст, объединяя все текстовые узлы в любом из узлов в списке.

  • find может вернуть что угодно. Он вернет список node как объект XML::LibXML::NodeList, числовое значение как объект XML::LibXML::Number, строковый литерал как объект XML::LibXML::Literal и т.д. В отличие от findnodes, он всегда возвращает одно скалярное значение, даже если вызывается в контексте списка.

    Я никогда не выбирал использовать find. Похоже, он предназначен для всех, когда вы не знаете, какого результата ожидать.

Например, вы, вероятно, захотите написать my $nrecs = $dom->findvalue('count(/root/record)'), чтобы получить количество записей в корневом элементе. $nrecs будет простым числовым значением perl.

С другой стороны, чтобы получить список этих записей, вы должны использовать my @records = $dom->findnodes('/root/record'). Теперь @records содержит несколько объектов XML::LibXML::Element.

В ваших примерах

my $node_cnt = $dom->findvalue("count($xpath_str)");  # WORKS!

это устанавливает $node_cnt в простое число Perl, а это

my $node_cnt = $dom->find("count($xpath_str)");  # WORKS!

устанавливает $node_cnt в объект XML::LibXML::Number, который, как правило, строит (когда вы печатаете его) так же, как и предыдущий оператор. Докажите это сами, напечатав print ref $node_cnt в обоих случаях.

Тогда

my @node_cnt = $dom->findnodes("count($xpath_str)");  # count doesn't work!

терпит неудачу, потому что XPath count оценивается числом, а не XML node (он не является частью дерева XML). Нет способа преобразования чисел в узлы, поэтому результат представляет собой пустой список. Если бы это было наоборот, и мы вызывали findvalue в выражении, которое оценивалось в списке node, тогда есть неопределенно разумный способ преобразования в текстовое значение, а findvalue делает все возможное и возвращает конкатенация всех текстовых узлов, содержащихся в узлах в списке.