icuSources/common/rbbirb.cpp

   1 //
   2 //  file:  rbbirb.cpp
   3 //
   4 //  Copyright (C) 2002-2004, International Business Machines Corporation and others.
   5 //  All Rights Reserved.
   6 //
   7 //  This file contains the RBBIRuleBuilder class implementation.  This is the main class for
   8 //    building (compiling) break rules into the tables required by the runtime
   9 //    RBBI engine.
  10 //
  11
  12 #include "unicode/utypes.h"
  13
  14 #if !UCONFIG_NO_BREAK_ITERATION
  15
  16 #include "unicode/brkiter.h"
  17 #include "unicode/rbbi.h"
  18 #include "unicode/ubrk.h"
  19 #include "unicode/unistr.h"
  20 #include "unicode/uniset.h"
  21 #include "unicode/uchar.h"
  22 #include "unicode/uchriter.h"
  23 #include "unicode/parsepos.h"
  24 #include "unicode/parseerr.h"
  25 #include "cmemory.h"
  26 #include "cstring.h"
  27
  28 #include "rbbirb.h"
  29 #include "rbbinode.h"
  30
  31 #include "rbbiscan.h"
  32 #include "rbbisetb.h"
  33 #include "rbbitblb.h"
  34 #include "rbbidata.h"
  35
  36
  37 U_NAMESPACE_BEGIN
  38
  39
  40 //----------------------------------------------------------------------------------------
  41 //
  42 //  Constructor.
  43 //
  44 //----------------------------------------------------------------------------------------
  45 RBBIRuleBuilder::RBBIRuleBuilder(const UnicodeString   &rules,
  46                                        UParseError     &parseErr,
  47                                        UErrorCode      &status)
  48  : fRules(rules)
  49 {
  50     fStatus = &status; // status is checked below
  51     fParseError = &parseErr;
  52     fDebugEnv   = NULL;
  53 #ifdef RBBI_DEBUG
  54     fDebugEnv   = getenv("U_RBBIDEBUG");
  55 #endif
  56
  57
  58     fForwardTree        = NULL;
  59     fReverseTree        = NULL;
  60     fSafeFwdTree        = NULL;
  61     fSafeRevTree        = NULL;
  62     fDefaultTree        = &fForwardTree;
  63     fForwardTables      = NULL;
  64     fReverseTables      = NULL;
  65     fSafeFwdTables      = NULL;
  66     fSafeRevTables      = NULL;
  67     fRuleStatusVals     = NULL;
  68     fChainRules         = FALSE;
  69     fLBCMNoChain        = FALSE;
  70     fLookAheadHardBreak = FALSE;
  71     fUSetNodes          = NULL;
  72     fRuleStatusVals     = NULL;
  73     fScanner            = NULL;
  74     fSetBuilder         = NULL;
  75
  76     if (U_FAILURE(status)) {
  77         return;
  78     }
  79
  80     fUSetNodes          = new UVector(status); // bcos status gets overwritten here
  81     fRuleStatusVals     = new UVector(status);
  82     fScanner            = new RBBIRuleScanner(this);
  83     fSetBuilder         = new RBBISetBuilder(this);
  84     if (U_FAILURE(status)) {
  85         return;
  86     }
  87     if(fSetBuilder == 0 || fScanner == 0 || fUSetNodes == 0 || fRuleStatusVals == 0) {
  88         status = U_MEMORY_ALLOCATION_ERROR;
  89     }
  90 }
  91
  92
  93
  94 //----------------------------------------------------------------------------------------
  95 //
  96 //  Destructor
  97 //
  98 //----------------------------------------------------------------------------------------
  99 RBBIRuleBuilder::~RBBIRuleBuilder() {
 100
 101     int        i;
 102     for (i=0; ; i++) {
 103         RBBINode *n = (RBBINode *)fUSetNodes->elementAt(i);
 104         if (n==NULL) {
 105             break;
 106         }
 107         delete n;
 108     }
 109
 110     delete fUSetNodes;
 111     delete fSetBuilder;
 112     delete fForwardTables;
 113     delete fReverseTables;
 114     delete fSafeFwdTables;
 115     delete fSafeRevTables;
 116
 117     delete fForwardTree;
 118     delete fReverseTree;
 119     delete fSafeFwdTree;
 120     delete fSafeRevTree;
 121     delete fScanner;
 122     delete fRuleStatusVals;
 123 }
 124
 125
 126
 127
 128
 129 //----------------------------------------------------------------------------------------
 130 //
 131 //   flattenData() -  Collect up the compiled RBBI rule data and put it into
 132 //                    the format for saving in ICU data files,
 133 //                    which is also the format needed by the RBBI runtime engine.
 134 //
 135 //----------------------------------------------------------------------------------------
 136 static int32_t align8(int32_t i) {return (i+7) & 0xfffffff8;}
 137
 138 RBBIDataHeader *RBBIRuleBuilder::flattenData() {
 139     int32_t    i;
 140
 141     if (U_FAILURE(*fStatus)) {
 142         return NULL;
 143     }
 144
 145     // Remove comments and whitespace from the rules to make it smaller.
 146     UnicodeString strippedRules(RBBIRuleScanner::stripRules(fRules));
 147
 148     // Calculate the size of each section in the data.
 149     //   Sizes here are padded up to a multiple of 8 for better memory alignment.
 150     //   Sections sizes actually stored in the header are for the actual data
 151     //     without the padding.
 152     //
 153     int32_t headerSize        = align8(sizeof(RBBIDataHeader));
 154     int32_t forwardTableSize  = align8(fForwardTables->getTableSize());
 155     int32_t reverseTableSize  = align8(fReverseTables->getTableSize());
 156     int32_t safeFwdTableSize  = align8(fSafeFwdTables->getTableSize());
 157     int32_t safeRevTableSize  = align8(fSafeRevTables->getTableSize());
 158     int32_t trieSize          = align8(fSetBuilder->getTrieSize());
 159     int32_t statusTableSize   = align8(fRuleStatusVals->size() * sizeof(int32_t));
 160     int32_t rulesSize         = align8((strippedRules.length()+1) * sizeof(UChar));
 161
 162     int32_t         totalSize = headerSize + forwardTableSize + reverseTableSize
 163                                 + safeFwdTableSize + safeRevTableSize
 164                                 + statusTableSize + trieSize + rulesSize;
 165
 166     RBBIDataHeader  *data     = (RBBIDataHeader *)uprv_malloc(totalSize);
 167     if (data == NULL) {
 168         *fStatus = U_MEMORY_ALLOCATION_ERROR;
 169         return NULL;
 170     }
 171     uprv_memset(data, 0, totalSize);
 172
 173
 174     data->fMagic         = 0xb1a0;
 175     data->fVersion       = 1;
 176     data->fLength        = totalSize;
 177     data->fCatCount      = fSetBuilder->getNumCharCategories();
 178
 179     data->fFTable        = headerSize;
 180     data->fFTableLen     = forwardTableSize;
 181     data->fRTable        = data->fFTable  + forwardTableSize;
 182     data->fRTableLen     = reverseTableSize;
 183     data->fSFTable       = data->fRTable  + reverseTableSize;
 184     data->fSFTableLen    = safeFwdTableSize;
 185     data->fSRTable       = data->fSFTable + safeFwdTableSize;
 186     data->fSRTableLen    = safeRevTableSize;
 187
 188     data->fTrie          = data->fSRTable + safeRevTableSize;
 189     data->fTrieLen       = fSetBuilder->getTrieSize();
 190     data->fStatusTable   = data->fTrie    + trieSize;
 191     data->fStatusTableLen= statusTableSize;
 192     data->fRuleSource    = data->fStatusTable + statusTableSize;
 193     data->fRuleSourceLen = strippedRules.length() * sizeof(UChar);
 194
 195     uprv_memset(data->fReserved, 0, sizeof(data->fReserved));
 196
 197     fForwardTables->exportTable((uint8_t *)data + data->fFTable);
 198     fReverseTables->exportTable((uint8_t *)data + data->fRTable);
 199     fSafeFwdTables->exportTable((uint8_t *)data + data->fSFTable);
 200     fSafeRevTables->exportTable((uint8_t *)data + data->fSRTable);
 201     fSetBuilder->serializeTrie ((uint8_t *)data + data->fTrie);
 202
 203     int32_t *ruleStatusTable = (int32_t *)((uint8_t *)data + data->fStatusTable);
 204     for (i=0; i<fRuleStatusVals->size(); i++) {
 205         ruleStatusTable[i] = fRuleStatusVals->elementAti(i);
 206     }
 207
 208     strippedRules.extract((UChar *)((uint8_t *)data+data->fRuleSource), rulesSize/2+1, *fStatus);
 209
 210     return data;
 211 }
 212
 213
 214
 215
 216
 217
 218 //----------------------------------------------------------------------------------------
 219 //
 220 //  createRuleBasedBreakIterator    construct from source rules that are passed in
 221 //                                  in a UnicodeString
 222 //
 223 //----------------------------------------------------------------------------------------
 224 BreakIterator *
 225 RBBIRuleBuilder::createRuleBasedBreakIterator( const UnicodeString    &rules,
 226                                     UParseError      &parseError,
 227                                     UErrorCode       &status)
 228 {
 229     // status checked below
 230
 231     //
 232     // Read the input rules, generate a parse tree, symbol table,
 233     // and list of all Unicode Sets referenced by the rules.
 234     //
 235     RBBIRuleBuilder  builder(rules, parseError, status);
 236     builder.fScanner->parse();
 237     if (U_FAILURE(status)) { // status checked here bcos build below doesn't
 238         return NULL;
 239     }
 240
 241     //
 242     // UnicodeSet processing.
 243     //    Munge the Unicode Sets to create a set of character categories.
 244     //    Generate the mapping tables (TRIE) from input 32-bit characters to
 245     //    the character categories.
 246     //
 247     builder.fSetBuilder->build();
 248
 249
 250     //
 251     //   Generate the DFA state transition table.
 252     //
 253     builder.fForwardTables = new RBBITableBuilder(&builder, &builder.fForwardTree);
 254     builder.fReverseTables = new RBBITableBuilder(&builder, &builder.fReverseTree);
 255     builder.fSafeFwdTables = new RBBITableBuilder(&builder, &builder.fSafeFwdTree);
 256     builder.fSafeRevTables = new RBBITableBuilder(&builder, &builder.fSafeRevTree);
 257     if (U_SUCCESS(status)
 258         && (builder.fForwardTables == NULL || builder.fReverseTables == NULL ||
 259             builder.fSafeFwdTables == NULL || builder.fSafeRevTables == NULL))
 260     {
 261         status = U_MEMORY_ALLOCATION_ERROR;
 262         return NULL;
 263     }
 264
 265     builder.fForwardTables->build();
 266     builder.fReverseTables->build();
 267     builder.fSafeFwdTables->build();
 268     builder.fSafeRevTables->build();
 269     if (U_FAILURE(status)) {
 270         return NULL;
 271     }
 272
 273 #ifdef RBBI_DEBUG
 274     if (builder.fDebugEnv && uprv_strstr(builder.fDebugEnv, "states")) {
 275         builder.fForwardTables->printRuleStatusTable();
 276     }
 277 #endif
 278
 279     //
 280     //   Package up the compiled data into a memory image
 281     //      in the run-time format.
 282     //
 283     RBBIDataHeader *data = builder.flattenData(); // returns NULL if error
 284
 285
 286     //
 287     //  Clean up the compiler related stuff
 288     //
 289
 290
 291     //
 292     //  Create a break iterator from the compiled rules.
 293     //     (Identical to creation from stored pre-compiled rules)
 294     //
 295     // status is checked after init in construction.
 296     RuleBasedBreakIterator *This = new RuleBasedBreakIterator(data, status);
 297     if (U_FAILURE(status)) {
 298         delete This;
 299         This = NULL;
 300     }
 301     else if(This == NULL) { // test for NULL
 302         status = U_MEMORY_ALLOCATION_ERROR;
 303     }
 304     return This;
 305 }
 306
 307 U_NAMESPACE_END
 308
 309 #endif /* #if !UCONFIG_NO_BREAK_ITERATION */