Creates a set of vectors from one or more source vector groups that match a specified name pattern.
Input Arguments
0 |
Collection Object Name Ref List |
Vector Groups to Select From |
The source vector groups to search. |
1 |
Vector Name |
WildCard Selection Names |
A wildcard name for the vectors to match. |
2 |
Collection Object Name |
Vector Group for New Vectors |
The name of the vector group for the matching vectors. |
3 |
Boolean |
Include Prior Complete Name |
Specify whether the complete name of each vec- tor should be used as the new vector name. |
Return Arguments
None.
Returned Status
SUCCESS |
The matching vectors were created successfully. |
FAILURE |
No source vector groups were provided. |
Remarks
Argument 1 can reference a point name. Use Make a Point Name from Strings to manually enter the search criteria for the collection, vector group and point name wildcard.
Enter wildcard values for the collection, vector group, and vector name using the same conventions as elsewhere in SA. Asterisks (*) are wildcards for one or more characters, while question marks (?) are placeholders for single char- acters. Specific characters can also be found using brackets[]. To find all vectors from all collections in vector groups that start with āsā and whose vector names have two digits starting with ā1ā, the vector name defining the selection criteria would be *::s*::1?.