---
name: "XmListGetMatchPos"
section: "3"
platform: "linux"
package: "openmotif"
version: "2.3.8-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XmListGetMatchPos"
---

# XmListGetMatchPos(3)

A List function that returns all instances of an item in the list

## NAME

**XmListGetMatchPos** — A List function that returns all instances of an item in the list

## SYNOPSIS

```
#include <Xm/List.h>
Boolean XmListGetMatchPos(
Widget widget,
XmString item,
int **position_list,
int *position_count);
```

## DESCRIPTION

**XmListGetMatchPos** is a Boolean function that returns an array of positions where a specified item is found in a List.

- *widget*

  Specifies the ID of the List widget.

- *item*

  Specifies the item to search for.

- *position\_list*

  Returns an array of positions at which the item occurs in the List. The position of the first item in the list is 1; the position of the second item is 2; and so on. When the return value is True, **XmListGetMatchPos** allocates memory for this array. The caller is responsible for freeing this memory. The caller can recover the allocated memory by calling **XtFree**.

- *position\_count*

  Returns the number of elements in the *position\_list*.

For a complete definition of List and its associated resources, see [**XmList**(3)](/XmList/3.md).

## RETURN

Returns True if the specified item is present in the list, and False if it is not.

## RELATED

[**XmList**(3)](/XmList/3.md).