int findattribval(<geometry>geometry, string attribclass, string attribute_name, int|stringvalue, int which=0)
int [] findattribval(<geometry>geometry, string attribclass, string attribute_name, int|stringvalue)
<geometry>
When running in the context of a node (such as a wrangle SOP), this argument can be an integer representing the input number (starting at 0) to read the geometry from.
Alternatively, the argument can be a string specifying a geometry file (for example, a .bgeo) to read from. When running inside Houdini, this can be an op:/path/to/sop reference.
attribclass
One of "detail" (or "global"), "point", "prim", or "vertex".
attribute_name
The name of the attribute to read.
value
The value to look for in the attribute.
which
If multiple elements have the given value in the attribute, this controls which match to return.
If you're searching for multiple elements with the same attribute value, you can use findattribvalcount to get the total number of matches and then iterate through them by increasing the which argument to this function in a loop. See the examples below.
The array signature can also be used to return a list of all of the matching elements.
Returns
The number of the first point/primitive/vertex where the named attribute matches the given value. Returns -1 if no element has the given attribute value.
The array signature returns the numbers of all of the points/primitives/vertices where the named attribute matches the given value.
Tip
The most common use cases (finding an point/primitive by its name or id attribute) have easier-to-use dedicated wrapper functions: nametopoint, nametoprim, idtopoint, and idtoprim.
-
You can only search for integer or string values.
Examples ¶
Find the primitive with @id == 10
int prim_num = findattribval(0, "prim", "id", 10); // Note: you can use idtoprim(0, 10) instead
Find all points with @age == 10
for (int point_num : findattribval(0, "point", "age", 10)) { // ...do something with the point... }
Find all points with @age == 10, using findattribvalcount.
int count = findattribvalcount(0, "point", "age", 10); int point_num; for (int i = 0; i < count; i++) { point_num = findattribval(0, "point", "age", 10, i); // ...do something with the point... }
| See also | |
| attrib |
|
| search |