19.2 Creating a new recognizer

Constructor function: Marpa_Recognizer marpa_r_new ( Marpa_Grammar g )

On success, creates a new recognizer and increments the reference count of g, the base grammar, by one. In the new recognizer, the following will be true:

• The reference count will be 1.
• The furthest earleme will be 0.
• The values of the latest and current earleme will be unspecified.
• The declaration status of all events will be inherited from g, so that the event in the recognizer is declared iff the event in g is declared.
• The activation status of all events will be inherited from g, so that the event in the recognizer is activated iff the event in g is activated.

Return value: On success, the newly created recognizer, which is never NULL. If g is not precomputed, or on other hard failure, NULL.