NLP_ENGINE::setDatum and nlp -DATUM pass G("$datum") to analyzers (4.2.36)

[ddehilster]

The engine side of VisualText/py-package-nlpengine#1 ("Add output type to NLP Engine call: use the datum feature already in the engine").

NLP::analyze has long taken a datum string that analyzers read as G("$datum"), but NLP_ENGINE never passed one. The stream API (which Python uses) hard-coded NULL, and the file and buffer paths left it at the default.

• NLP_ENGINE::setDatum(const _TCHAR*) / getDatum(): every later analysis on that engine gets the string as G("$datum"). An empty string means none, as before.
• All three analyze paths pass it through.
• nlp -DATUM value sets it from the command line, for example nlp -ANA myana -DATUM json input.txt. The usage text lists it.
• m_datum is the last member of NLP_ENGINE, so nothing before it moves.

Without the flag, analyzers behave as before: G("$datum") reads 0, like any unset value.

Next: once this is released, the NLPPlus binding passes a datum= argument through setDatum. That PR follows the release.

Tests:

• New fixture tests/datum with CI steps on Windows and Linux. It runs -DATUM json and -DATUM xml and checks the analyzer printed datum=[json] and datum=[xml].
• Local: 49/50 CI steps pass. The compiled-bridge step needs $GITHUB_WORKSPACE and always fails locally.
• Full English Test: unchanged.
• 20 analyzers × 21 inputs: 0 differences.

🤖 Generated with Claude Code