child

fun child(relativePath: String): Webcom

Returns a reference on the data node specified by a path relatively to the data node referred to by this instance.

The path specification accommodates the following rules:

  • It may include several path segments separated by slashes ("/"),

  • It is always interpreted relatively to the current data node, even if it starts with a slash,

  • Special path segments "." and ".." are interpreted as "same node" and "parent node". Warning: ".." on the root data node returns itself (and not null as the parent method does),

  • Special path segments starting with "#" or ".hash." are expanded into 4 level paths that hash the initial segment name, in order to handle very large lists (up to more than 10^15 elements, see Browse data),

  • Special path segments starting with ".list." give a hint to the Webcom back end that the corresponding nodes are intended to have many children (as a list) so that it optimises the individual retrieval of their children, preventing retrieving the nodes as a whole when the data of all their children become too big.