# ::hwat::utils::GetMarkedEntity

This function clears the mark, creates a mark on the desired entities, and returns the entities on the mark.

## Syntax

::hwat::utils::GetMarkedEntity entityType mark args

## Arguments

entityType
The type of the entity.
mark
The ID of the mark.
args
The arguments after the mark argument in the *createmark command.

## Returns

Success
A Tcl list containing the IDs of the entities, 0 if no entity is found.
Failure
{}

## Example

::hwat::utils::GetMarkedEntity "components"  1 "by sets" Vehicle

If any one of the arguments is a list in Tcl, like [list 1 2 3] or {1 2 3}, or a variable which is a list, use eval before the ::hwat::utils::GetMarkedEntity command. Also, in these cases, while using options such as by assems or on plane, pass them as \"by assems\" or \"on plane\" respectively. For example: set a {1 2 3} 
eval ::hwat::utils::GetMarkedEntity comps 1 \"by assems\" \$a
::hwat::utils::GetMarkedEntity comps 1 "by assems" 1 2 3