# SearchListObjectFor method

Searches for a string in a list object.

Information note

This method applies to list objects (objects with one dimension).

Information note

The search results can be displayed using the *GetLayout Method*.

Information note

The operation is successful if **qSuccess** is set to true.

## Parameters

| Name | Description | Mandatory | Type |
| --- | --- | --- | --- |
| qPath | Path to the definition of the list object.<br>For example, */qListObjectDef* . | Yes | String |
| qMatch | Search string.<br>Wild card characters are allowed. The search is not case sensitive.<br>Examples:<br><br><ul><li><code>P*U*</code>: retrieves only values that start with P and contain U</li><li><code>P U S</code>: retrieves values that start with P, U or S</li></ul> | Yes | String |

## Returns

| Name | Description | Type |
| --- | --- | --- |
| qSuccess | true | Boolean |

## See also

[Abort the results of a search in a list object](https://help.qlik.com/en-US/sense-developer/May2026/csh/engineapi/abort-results-search-list-object)

[Accept the results of a search in a list object](https://help.qlik.com/en-US/sense-developer/May2026/csh/engineapi/accept-results-search-list-object)

[Search for a string in a list object](https://help.qlik.com/en-US/sense-developer/May2026/csh/engineapi/search-string-in-list-object)