## On this page

  

 

 # get\_topo\_faces\_of\_component\_body\_name\_pattern

 Last update: 10.09.2025 

<a id="ansys.meshing.prime.Part.get_topo_faces_of_component_body_name_pattern"></a>

#### Part.get\_topo\_faces\_of\_component\_body\_name\_pattern(component\_body\_name\_pattern, type, name\_pattern\_params)

Gets topoface ids of component or bodies with name matching the given name pattern.

- **Parameters:**
    
    **component\_body\_name\_pattern**: Name pattern to be matched with component or body name.
    
    **type**: Type of query used to match component or body name pattern.
    
    **name\_pattern\_params**: Name pattern parameters used to match component or body name pattern.
- **Returns:**
    
    `Iterable`\[[`int`](https://docs.python.org/3.11/library/functions.html#int)\] : Returns the ids of topofaces.
- **Return type:**
    
    [`Iterable`](https://docs.python.org/3.11/library/typing.html#typing.Iterable)\[[`int`](https://docs.python.org/3.11/library/functions.html#int)\]

### Notes

**This is a beta API**. **The behavior and implementation may change in future**.

### Examples

```pycon
&gt;&gt;&gt; topo_faces = part.get_topo_faces_of_component_body_name_pattern(
&gt;&gt;&gt;                   component_body_name_pattern = "body*",
&gt;&gt;&gt;                   type = BodyQueryType_All,
&gt;&gt;&gt;                   params = prime.NamePatternParams(model=model))

```