Cog3DCoordinateSpaceTree.VerifyName Method

Cog3DCoordinateSpaceTree VerifyName Method

Cognex VisionPro

Return true if the given spaceName is a unique name in this tree. Return false if spaceName cannot be found. The formatted name, or "", can be obtained through the foundName output argument.

Namespace: Cognex.VisionPro3D
Assembly: Cognex.VisionPro3D.Core (in Cognex.VisionPro3D.Core.dll) Version: 65.1.0.0

Syntax

C++

Copy to Clipboard Print

public bool VerifyName(
	string spaceName,
	CogSpaceTreePathnameConstants pathnameFormat,
	out string foundName
)

public bool VerifyName(
	string spaceName,
	CogSpaceTreePathnameConstants pathnameFormat,
	out string foundName
)

Public Function VerifyName ( 
	spaceName As String,
	pathnameFormat As CogSpaceTreePathnameConstants,
	<OutAttribute> ByRef foundName As String
) As Boolean

Public Function VerifyName ( 
	spaceName As String,
	pathnameFormat As CogSpaceTreePathnameConstants,
	<OutAttribute> ByRef foundName As String
) As Boolean

public:
bool VerifyName(
	String^ spaceName, 
	CogSpaceTreePathnameConstants pathnameFormat, 
	[OutAttribute] String^% foundName
)

public:
bool VerifyName(
	String^ spaceName, 
	CogSpaceTreePathnameConstants pathnameFormat, 
	[OutAttribute] String^% foundName
)

Parameters

spaceName: Type: System String
A valid nonqualified or fully-qualified space name to find in this coordinate space tree.

pathnameFormat: Type: Cognex.VisionPro CogSpaceTreePathnameConstants
A CogSpaceTreePathnameConstants value that indicates how the returned name should be formatted.

foundName: Type: System String
If this method returns true, foundName contains the formatted space name. Otherwise, it contains "".

Return Value

Type: Boolean

True if the given spaceName is unique in this tree. False if the name is not found in the tree.

Exceptions

Exception	Condition
ArgumentOutOfRangeException	The pathnameFormat value is not a member of CogSpaceTreePathnameConstants.
CogSpaceTreeInvalidNameSyntaxException	spaceName is not a legal space name.
CogSpaceTreeNameNotUniqueException	spaceName is a nonqualified space name and more than one instance of it exists in this tree.

Remarks

You can use this method to verify that a given space name is legal and exists in the coordinate space tree. It returns true if the given spaceName is a unique name in this tree; false if spaceName cannot be found.

This method is is similar to LookUpName(String, CogSpaceTreePathnameConstants), however it does not generate an error if spaceName does not exist in the tree.