getValuesByPath

The getValuesByPath method gets the values of a sub-field, specified by path.

Syntax

getValuesByPath( path )

Arguments

Argument Description
path (string) The path of the sub-field.

Returns

(Strings). Strings that contain the values. To map the return values to a table, surround the function call with braces. For example:

fieldvalues = { myfield:getValuesByPath("subfield/anothersubfield") }

Example

Consider the following document:

<DOCUMENT>
  ...
  <A_FIELD>
    <subfield>
      <anothersubfield>one</anothersubfield>
      <anothersubfield>two</anothersubfield>
      <anothersubfield>three</anothersubfield>
    </subfield>
  </A_FIELD>
  ...
</DOCUMENT>

The following example demonstrates how to retrieve the values "one", "two", and "three" from the sub-field anothersubfield, using a LuaField object representing A_FIELD:

local field = document:getField("A_FIELD")
local values = { field:getValuesByPath("subfield/anothersubfield") }

_HP_HTML5_bannerTitle.htm