StructMap

Used to map a struct to a new struct of the same type containing the result

Method Signature

StructMap(struct=[structloose], callback=[function:BiFunction], parallel=[boolean], maxThreads=[integer])

Arguments

Argument	Type	Required	Description	Default
struct	struct	true	The target struct to test
callback	function:BiFunction	true	The function used to produce the right-hand value assignment in the new struct. The function will be passed 3 arguments: the key, the value, the struct. You can alternatively pass a Java BiFunction which will only receive the first 2 args.
parallel	boolean	false	Specifies whether the items can be executed in parallel	false
maxThreads	integer	false	The maximum number of threads to use when parallel = true

Examples

Script Syntax

Run Example

original = { 
	"one" : {
		1 : "tahi"
	},
	"two" : {
		2 : "rua"
	},
	"three" : {
		3 : "toru"
	},
	"four" : {
		4 : "wha"
	}
};

function mapOriginal( Any k, Any v ) {
	return v[ ListFirst( v.keyList() ) ];
}
fixed = structMap( original, mapOriginal );
writeDump( [
	original,
	fixed
] );

Using Member Function

Run Example

original = { 
	"one" : {
		1 : "tahi"
	},
	"two" : {
		2 : "rua"
	},
	"three" : {
		3 : "toru"
	},
	"four" : {
		4 : "wha"
	}
};
fixed = original.map( ( Any k, Any v ) => {
	return v[ ListFirst( v.keyList() ) ];
} );
writeDump( [
	original,
	fixed
] );

Additional Examples

Run Example

sct = structNew( "linked" );
sct.A = 1;
sct.B = 2;
sct.C = 3;
writedump( var=sct, label="original struct" );
// base test
res = StructMap( sct, ( Any key, Any value ) => {
	return key & ":" & value;
}, true );
writedump( var=res, label="mapped struct" );

Related

• StructEquals
• StructReduce
• StructIsCaseSensitive
• StructNew
• StructGet
• StructDelete
• StructFilter
• StructIsOrdered
• StructSort
• StructEach
• StructToQueryString
• StructUpdate
• StructClear
• StructGetMetadata
• StructKeyArray
• StructToSorted
• StructCopy
• StructFindKey
• StructInsert
• StructFindValue
• StructValueArray
• StructSome
• StructKeyExists
• StructKeyTranslate
• StructEvery
• StructFind
• StructKeyList
• StructAppend