Your Ad Here

Go to: Synopsis. Flags. Return value. Python examples.

Synopsis

stringArrayIntersector( intersectorName , [allowDuplicates=int], [defineTemplate=string], [edit=boolean], [exists=boolean], [intersect=string], [query=boolean], [query=boolean], [reset=boolean], [useTemplate=string])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

stringArrayIntersector is undoable, queryable, and editable.

The stringArrayIntersector command creates and edits an object which is able to efficiently intersect large string arrays. The intersector object maintains a sense of "the intersection so far", and updates the intersection when new string arrays are provided using the -i/intersect flag. Note that the string intersector object may be deleted using the deleteUI command.

Flags

allowDuplicates, defineTemplate, edit, exists, intersect, query, query, reset, useTemplate
Long name (short name) [argument types] Properties
query(q) boolean query
Puts the command in query mode so that it will return the value of the specified flag.

In query mode, this flag needs a value.
edit(e) boolean edit
Puts the command in edit mode so that it will change the values of the specified flags
exists(ex) boolean create
Returns true|false depending upon whether the specified object exists. Other flags are ignored.
defineTemplate(dt) string create
Puts a command in a mode where any other flags and args are parsed and added to the command template specified in the argument. They will be used as default arguments in any subsequent invocations of the command when templateName is set as the current template.
useTemplate(ut) string create
Will force the command to use a command template other than the current one.
allowDuplicates(ad) int create
Should the intersector allow duplicates in the input arrays (true), or combine all duplicate entries into a single, unique entry (false). This flag must be used when initially creating the intersector. Default is 'false'.
intersect(i) string createedit
Intersect the specified string array with the current intersection being maintained by the intersector.
reset(r) boolean edit
Reset the intersector to begin a new intersection.
query(q) boolean query
Return a string array of the current intersection.

In query mode, this flag needs a value.
Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can have multiple arguments, passed either as a tuple or a list.

Return value


string, or stringArray (depending on flags)

Python examples

import maya.cmds as cmds

# Create an intersector
#
myIntersector = cmds.stringArrayIntersector('stringArrayIntersector')

# Intersect some string arrays using the intersector
#
initialArray = ['Excellent', 'Smithers', 'doh']
cmds.stringArrayIntersector( myIntersector, edit=True, intersect=initialArray )
cmds.stringArrayIntersector( myIntersector, edit=True, intersect=['Smithers', 'Homer'] )

# Query the intersector to see what the intersection is so far
#
cmds.stringArrayIntersector( myIntersector, query=True )
# Result: Smithers #

# Reset the intersector so that you can use it again with new string
# arrays
#
cmds.stringArrayIntersector( myIntersector, edit=True, reset=True )

# Delete the intersector as we are now done with it
#
cmds.deleteUI( myIntersector )

Return to Autodesk Index


Your Ad Here