StructGet()

Gets a structure(s) from a specified path.

StructGet( PathDesired=string );

Returns: any

Argument Description
PathDesired
string, required

Pathname of variable that contains structure or array from which Lucee retrieves structure.

Alias: path

Examples

animals = {
	cat: {
		activities: {
		    sleep: true,
		    eat: true,
		    drink: true
		}
	}
};

// Show all animals
Dump(
label: "All animals",
var: animals
);


// Get cat activities in animals
getCatActivities = StructGet("animals.cat.activities");


// Show results of getCatActivities
Dump(
label: "Results of StructGet(""animals.cat.activities"")",
var: getCatActivities
);


// If the path does not exist, result returns an empty structure.
findDog = StructGet("animals.dog");


// Show results of findDog
Dump(
label: "Results of StructGet(""animals.dog"")",
var: findDog
);

See also