# 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