name: LanguageModelBNF

synopsis:

g++ [flags ...] file ... -l /isip/tools/lib/$ISIP_BINARY/lib_pr.a

#include <LanguageModelBNF.h>

LanguageModelBNF();
RuleModel& getRuleModel();
boolean setRuleModel(const RuleModel& rm);

quick start:

LanguageModelBNF lmbnf;
Sof lm_file_in;
Sof lm_file_out;
lm_file_in.open(L"lm_bnf_in.sof", File::READ_ONLY, File::TEXT);
lmbnf.read(lm_file_in);
lm_file_out.open(L"lm_bnf_out.sof", File::WRITE_ONLY, File::TEXT);
lmbnf.write(lm_file_out);

description:

LanguageModelBNF represents a LanguageModel in Backus-Naur Format (BNF). Currently this class is used as a container class for the BNF representation of grammars. BNF is used as an intermediate format when converting between certain formats. The BNF representation of a grammar is usually derived from the Augmented Backus-Naur Format (ABNF) which is represented by the class LanguageModelABNF.

dependencies:

LanguageModelBase

public constants:

define the class name:
```
static const String CLASS_NAME;
```

define i/o related constants:

static const String DEF_PARAM;

static const String PARAM_BNF;

static const long DEF_TAG;

error codes:

error code indicating LanguageModelBNF class general error:
```
static const long ERR = 100102;
```

protected data:

declare the memory manager:
```
static MemoryManager mgr_d;
```
declare the RuleModel which contains the BNF prductionRules:
```
RuleModel rm_d;
```

required public methods:

static methods:

static const String& name();

static boolean diagnose(Integral::DEBUG debug_level);

debug methods:

boolean debug(const unichar* msg_a) const;

constructor:
```
LanguageModelBNF();
```

assign methods:

boolean assign(const LanguageModelBNF& arg_a);

operator methods:

boolean operator=(const LanguageModelBNF& arg_a);

boolean operator==(const LanguageModelBNF& arg_a);

equality methods:

boolean eq(const LanguageModelBNF& arg_a) const;

i/o methods:

long sofSize() const;

boolean read(Sof& sof_a, const String& tag_a, SearchLevel& level_a);

boolean write(Sof& sof_a, long tag_a, const String& name_a) const;

boolean readData(Sof& sof, const String& pname = DEF_PARAM, long size = SofParser::FULL_OBJECT, boolean param = true, boolean nested = false);

boolean writeData(Sof& sof, const String& pname = DEF_PARAM) const;

memory management methods:
```
boolean clear(Integral::CMODE ctype_a);
```

class-specific public methods:

declare class-specific public methods:

const String& className() const;

boolean setRuleModel(RuleModel& rm);

RuleModel getRuleModel();

other methods:

other methods:
```
boolean minimizeGraph();
```

private methods:

declare class-specific public methods:

boolean mergeRules(ProductionRuleSet& rules, long index1, long index2);

boolean isValidBNF(ProductionRule rule);

boolean isMergeType(ProductionRule rule);

boolean detectFalseLoop(String non_terminal1, String non_terminal2, ProductionRuleSet rules);

ProductionRuleSet getMergeTypeRules(String non_terminal, ProductionRuleSet rules);

Vector<SearchSymbol> findTerminals(ProductionRuleSet rules_a, String rule_name_a);