ValueMap.Get operator

Introduced

v9.0 (2011)

Description

Returns the value that matches the specified name.

Warning: If the value is undefined, this method throws an error. You can work around this limitation by accessing the names and values array using the same index (see the example below).

C# Syntax

Object ValueMap.Get( String in_name );

Scripting Syntax

oReturn = ValueMap.Get( in_name );

Parameters

Parameter Type Description
in_name String The name of the value to retrieve.

Examples

1. Python Example

# See the example under the ValueMap.Remove method

2. Python Example

#
# This example demonstrates how to safely get a value, 
# even if it's undefined
#
def GetValueIndex( in_name, in_map ) :
	aNames = in_map.Names
	aValues = in_map.Values
	i=0			
	while i < len(in_map.Names) :
		if (in_map.Names[i] == in_name) :
			if (in_map.Values[i]) :
				return i
		i = i + 1
	return -1
# Python example
app = Application
for shdef in app.ShaderDefinitions :
	if (shdef.Attributes) :
		if (len(shdef.Attributes.Names)) :
			for n in shdef.Attributes.Names :
				idx = GetValueIndex(n, shdef.Attributes)
				app.LogMessage(shdef.Name+" has this attribute:\n\t- "+n+" == "+str(shdef.Attributes.Values[idx]))
	else :
		app.LogMessage("Could not get attributes for "+thing.Name)
# INFO : Softimage.soft_light.1.0 has this attribute:
# 	- {C535FA4D-E44A-45EB-AEE0-9F9AAEA91745} == None
# INFO : Softimage.material-lambert.1.0 has this attribute:
# 	- {C535FA4D-E44A-45EB-AEE0-9F9AAEA91745} == None
# INFO : Softimage.material-phong.1.0 has this attribute:
# 	- {C535FA4D-E44A-45EB-AEE0-9F9AAEA91745} == None

See Also

ValueMap.Set ValueMap.Names ValueMap.Values