obj_name(path)

Returns the name of the object at the given path. (Available as of version 10.24)

Syntax

obj_name(path)

Input

Argument Type Description
path text A path to an object (e.g., table, folder, query)

The path parameter can be a scalar value (e.g., pub.demo.retail.item) or the name of a column containing paths to objects.

If path is the empty string (e.g., ''), the function returns information corresponding to the root-level folder, which contains all of the top-level folders (e.g., pub, default, uploads).

Return Value

Returns a text value corresponding to the name of the object at the specified path.

Returns an empty string if the path does not exist.

Example

The following example demonstrates the behavior of obj_name(path) using the values in the example_path column specified via the <table> element.

<table cols="example_path">pub.demo.retail;
  pub.demo.retail.item;
  pub.demo.retail.selectionlib;
  pub.demo.retail.foo;
  default.doc.interactive.trsgsg_qa;
  default.doc.interactive.doc_lib;
  foo;
</table>
<col name="example_path" format="width:35"/>
<willbe name="obj_name_result" value="obj_name(example_path)"/>