# MATCHRECURSE

The `MATCHRECURSE` field specifier matches documents containing a specified reference in a `ReferenceMemoryMappedType` field recursively to a maximum number of times. This field specifier must be restricted to a single `ReferenceMemoryMappedType` field.

## Format

    FieldText=MATCHRECURSE{Ref,RecurseNumber}:YourField

`Ref` | The initial reference. The matching is case-independent.
`RecurseNumber` | The maximum number of times to recursively return references using the value of the `ReferenceMemoryMappedType` field.
`yourField` | The name of the `ReferenceMemoryMappedType` field.

## Example

For example:

In this example, `PARENT` is a `ReferenceMemoryMappedType` field. The query

    action=query&fieldtext=MATCHRECURSE{MyRef,1}:PARENT

matches the document with reference `MyRef` (parent) and documents whose `PARENT` field contains `MyRef` (children). The query

    action=query&fieldtext=MATCHRECURSE{MyRef,2}:PARENT

matches the document with reference `MyRef` (parent), documents whose `PARENT` field contains `MyRef` (children), and documents whose `PARENT` field contains the references in the returned child documents (grandchildren).

_FT_HTML5_bannerTitle.htm