1 // © 2016 and later: Unicode, Inc. and others.
2 // License & terms of use: http://www.unicode.org/copyright.html
3 /*
4 ***************************************************************************
5 * Copyright (C) 1999-2014 International Business Machines Corporation *
6 * and others. All rights reserved. *
7 ***************************************************************************
8 */
9
10 #include "unicode/utypes.h"
11
12 #if !UCONFIG_NO_BREAK_ITERATION
13
14 #include "unicode/ucptrie.h"
15 #include "unicode/utypes.h"
16 #include "rbbidata.h"
17 #include "rbbirb.h"
18 #include "udatamem.h"
19 #include "cmemory.h"
20 #include "cstring.h"
21 #include "umutex.h"
22
23 #include "uassert.h"
24
25
26 U_NAMESPACE_BEGIN
27
28 //-----------------------------------------------------------------------------
29 //
30 // Constructors.
31 //
32 //-----------------------------------------------------------------------------
RBBIDataWrapper(const RBBIDataHeader * data,UErrorCode & status)33 RBBIDataWrapper::RBBIDataWrapper(const RBBIDataHeader *data, UErrorCode &status) {
34 init0();
35 init(data, status);
36 }
37
RBBIDataWrapper(const RBBIDataHeader * data,enum EDontAdopt,UErrorCode & status)38 RBBIDataWrapper::RBBIDataWrapper(const RBBIDataHeader *data, enum EDontAdopt, UErrorCode &status) {
39 init0();
40 init(data, status);
41 fDontFreeData = TRUE;
42 }
43
RBBIDataWrapper(UDataMemory * udm,UErrorCode & status)44 RBBIDataWrapper::RBBIDataWrapper(UDataMemory* udm, UErrorCode &status) {
45 init0();
46 if (U_FAILURE(status)) {
47 return;
48 }
49 const DataHeader *dh = udm->pHeader;
50 int32_t headerSize = dh->dataHeader.headerSize;
51 if ( !(headerSize >= 20 &&
52 dh->info.isBigEndian == U_IS_BIG_ENDIAN &&
53 dh->info.charsetFamily == U_CHARSET_FAMILY &&
54 dh->info.dataFormat[0] == 0x42 && // dataFormat="Brk "
55 dh->info.dataFormat[1] == 0x72 &&
56 dh->info.dataFormat[2] == 0x6b &&
57 dh->info.dataFormat[3] == 0x20 &&
58 isDataVersionAcceptable(dh->info.formatVersion))
59 ) {
60 status = U_INVALID_FORMAT_ERROR;
61 return;
62 }
63 const char *dataAsBytes = reinterpret_cast<const char *>(dh);
64 const RBBIDataHeader *rbbidh = reinterpret_cast<const RBBIDataHeader *>(dataAsBytes + headerSize);
65 init(rbbidh, status);
66 fUDataMem = udm;
67 }
68
isDataVersionAcceptable(const UVersionInfo version)69 UBool RBBIDataWrapper::isDataVersionAcceptable(const UVersionInfo version) {
70 return RBBI_DATA_FORMAT_VERSION[0] == version[0];
71 }
72
73
74 //-----------------------------------------------------------------------------
75 //
76 // init(). Does most of the work of construction, shared between the
77 // constructors.
78 //
79 //-----------------------------------------------------------------------------
init0()80 void RBBIDataWrapper::init0() {
81 fHeader = NULL;
82 fForwardTable = NULL;
83 fReverseTable = NULL;
84 fRuleSource = NULL;
85 fRuleStatusTable = NULL;
86 fTrie = NULL;
87 fUDataMem = NULL;
88 fRefCount = 0;
89 fDontFreeData = TRUE;
90 }
91
init(const RBBIDataHeader * data,UErrorCode & status)92 void RBBIDataWrapper::init(const RBBIDataHeader *data, UErrorCode &status) {
93 if (U_FAILURE(status)) {
94 return;
95 }
96 fHeader = data;
97 if (fHeader->fMagic != 0xb1a0 || !isDataVersionAcceptable(fHeader->fFormatVersion)) {
98 status = U_INVALID_FORMAT_ERROR;
99 return;
100 }
101 // Note: in ICU version 3.2 and earlier, there was a formatVersion 1
102 // that is no longer supported. At that time fFormatVersion was
103 // an int32_t field, rather than an array of 4 bytes.
104
105 fDontFreeData = FALSE;
106 if (data->fFTableLen != 0) {
107 fForwardTable = (RBBIStateTable *)((char *)data + fHeader->fFTable);
108 }
109 if (data->fRTableLen != 0) {
110 fReverseTable = (RBBIStateTable *)((char *)data + fHeader->fRTable);
111 }
112
113 fTrie = ucptrie_openFromBinary(UCPTRIE_TYPE_FAST,
114 UCPTRIE_VALUE_BITS_ANY,
115 (uint8_t *)data + fHeader->fTrie,
116 fHeader->fTrieLen,
117 nullptr, // *actual length
118 &status);
119 if (U_FAILURE(status)) {
120 return;
121 }
122
123 UCPTrieValueWidth width = ucptrie_getValueWidth(fTrie);
124 if (!(width == UCPTRIE_VALUE_BITS_8 || width == UCPTRIE_VALUE_BITS_16)) {
125 status = U_INVALID_FORMAT_ERROR;
126 return;
127 }
128
129 fRuleSource = ((char *)data + fHeader->fRuleSource);
130 fRuleString = UnicodeString::fromUTF8(StringPiece(fRuleSource, fHeader->fRuleSourceLen));
131 U_ASSERT(data->fRuleSourceLen > 0);
132
133 fRuleStatusTable = (int32_t *)((char *)data + fHeader->fStatusTable);
134 fStatusMaxIdx = data->fStatusTableLen / sizeof(int32_t);
135
136 fRefCount = 1;
137
138 #ifdef RBBI_DEBUG
139 char *debugEnv = getenv("U_RBBIDEBUG");
140 if (debugEnv && uprv_strstr(debugEnv, "data")) {this->printData();}
141 #endif
142 }
143
144
145 //-----------------------------------------------------------------------------
146 //
147 // Destructor. Don't call this - use removeReference() instead.
148 //
149 //-----------------------------------------------------------------------------
~RBBIDataWrapper()150 RBBIDataWrapper::~RBBIDataWrapper() {
151 U_ASSERT(fRefCount == 0);
152 ucptrie_close(fTrie);
153 fTrie = nullptr;
154 if (fUDataMem) {
155 udata_close(fUDataMem);
156 } else if (!fDontFreeData) {
157 uprv_free((void *)fHeader);
158 }
159 }
160
161
162
163 //-----------------------------------------------------------------------------
164 //
165 // Operator == Consider two RBBIDataWrappers to be equal if they
166 // refer to the same underlying data. Although
167 // the data wrappers are normally shared between
168 // iterator instances, it's possible to independently
169 // open the same data twice, and get two instances, which
170 // should still be ==.
171 //
172 //-----------------------------------------------------------------------------
operator ==(const RBBIDataWrapper & other) const173 UBool RBBIDataWrapper::operator ==(const RBBIDataWrapper &other) const {
174 if (fHeader == other.fHeader) {
175 return TRUE;
176 }
177 if (fHeader->fLength != other.fHeader->fLength) {
178 return FALSE;
179 }
180 if (uprv_memcmp(fHeader, other.fHeader, fHeader->fLength) == 0) {
181 return TRUE;
182 }
183 return FALSE;
184 }
185
hashCode()186 int32_t RBBIDataWrapper::hashCode() {
187 return fHeader->fFTableLen;
188 }
189
190
191
192 //-----------------------------------------------------------------------------
193 //
194 // Reference Counting. A single RBBIDataWrapper object is shared among
195 // however many RulesBasedBreakIterator instances are
196 // referencing the same data.
197 //
198 //-----------------------------------------------------------------------------
removeReference()199 void RBBIDataWrapper::removeReference() {
200 if (umtx_atomic_dec(&fRefCount) == 0) {
201 delete this;
202 }
203 }
204
205
addReference()206 RBBIDataWrapper *RBBIDataWrapper::addReference() {
207 umtx_atomic_inc(&fRefCount);
208 return this;
209 }
210
211
212
213 //-----------------------------------------------------------------------------
214 //
215 // getRuleSourceString
216 //
217 //-----------------------------------------------------------------------------
getRuleSourceString() const218 const UnicodeString &RBBIDataWrapper::getRuleSourceString() const {
219 return fRuleString;
220 }
221
222
223 //-----------------------------------------------------------------------------
224 //
225 // print - debugging function to dump the runtime data tables.
226 //
227 //-----------------------------------------------------------------------------
228 #ifdef RBBI_DEBUG
printTable(const char * heading,const RBBIStateTable * table)229 void RBBIDataWrapper::printTable(const char *heading, const RBBIStateTable *table) {
230 uint32_t c;
231 uint32_t s;
232
233 RBBIDebugPrintf("%s\n", heading);
234
235 RBBIDebugPrintf(" fDictCategoriesStart: %d\n", table->fDictCategoriesStart);
236 RBBIDebugPrintf(" fLookAheadResultsSize: %d\n", table->fLookAheadResultsSize);
237 RBBIDebugPrintf(" Flags: %4x RBBI_LOOKAHEAD_HARD_BREAK=%s RBBI_BOF_REQUIRED=%s RBBI_8BITS_ROWS=%s\n",
238 table->fFlags,
239 table->fFlags & RBBI_LOOKAHEAD_HARD_BREAK ? "T" : "F",
240 table->fFlags & RBBI_BOF_REQUIRED ? "T" : "F",
241 table->fFlags & RBBI_8BITS_ROWS ? "T" : "F");
242 RBBIDebugPrintf("\nState | Acc LA TagIx");
243 for (c=0; c<fHeader->fCatCount; c++) {RBBIDebugPrintf("%3d ", c);}
244 RBBIDebugPrintf("\n------|---------------"); for (c=0;c<fHeader->fCatCount; c++) {
245 RBBIDebugPrintf("----");
246 }
247 RBBIDebugPrintf("\n");
248
249 if (table == NULL) {
250 RBBIDebugPrintf(" N U L L T A B L E\n\n");
251 return;
252 }
253 UBool use8Bits = table->fFlags & RBBI_8BITS_ROWS;
254 for (s=0; s<table->fNumStates; s++) {
255 RBBIStateTableRow *row = (RBBIStateTableRow *)
256 (table->fTableData + (table->fRowLen * s));
257 if (use8Bits) {
258 RBBIDebugPrintf("%4d | %3d %3d %3d ", s, row->r8.fAccepting, row->r8.fLookAhead, row->r8.fTagsIdx);
259 for (c=0; c<fHeader->fCatCount; c++) {
260 RBBIDebugPrintf("%3d ", row->r8.fNextState[c]);
261 }
262 } else {
263 RBBIDebugPrintf("%4d | %3d %3d %3d ", s, row->r16.fAccepting, row->r16.fLookAhead, row->r16.fTagsIdx);
264 for (c=0; c<fHeader->fCatCount; c++) {
265 RBBIDebugPrintf("%3d ", row->r16.fNextState[c]);
266 }
267 }
268 RBBIDebugPrintf("\n");
269 }
270 RBBIDebugPrintf("\n");
271 }
272 #endif
273
274
printData()275 void RBBIDataWrapper::printData() {
276 #ifdef RBBI_DEBUG
277 RBBIDebugPrintf("RBBI Data at %p\n", (void *)fHeader);
278 RBBIDebugPrintf(" Version = {%d %d %d %d}\n", fHeader->fFormatVersion[0], fHeader->fFormatVersion[1],
279 fHeader->fFormatVersion[2], fHeader->fFormatVersion[3]);
280 RBBIDebugPrintf(" total length of data = %d\n", fHeader->fLength);
281 RBBIDebugPrintf(" number of character categories = %d\n\n", fHeader->fCatCount);
282
283 printTable("Forward State Transition Table", fForwardTable);
284 printTable("Reverse State Transition Table", fReverseTable);
285
286 RBBIDebugPrintf("\nOrignal Rules source:\n");
287 for (int32_t c=0; fRuleSource[c] != 0; c++) {
288 RBBIDebugPrintf("%c", fRuleSource[c]);
289 }
290 RBBIDebugPrintf("\n\n");
291 #endif
292 }
293
294
295 U_NAMESPACE_END
296 U_NAMESPACE_USE
297
298 //-----------------------------------------------------------------------------
299 //
300 // ubrk_swap - byte swap and char encoding swap of RBBI data
301 //
302 //-----------------------------------------------------------------------------
303
304 U_CAPI int32_t U_EXPORT2
ubrk_swap(const UDataSwapper * ds,const void * inData,int32_t length,void * outData,UErrorCode * status)305 ubrk_swap(const UDataSwapper *ds, const void *inData, int32_t length, void *outData,
306 UErrorCode *status) {
307
308 if (status == NULL || U_FAILURE(*status)) {
309 return 0;
310 }
311 if(ds==NULL || inData==NULL || length<-1 || (length>0 && outData==NULL)) {
312 *status=U_ILLEGAL_ARGUMENT_ERROR;
313 return 0;
314 }
315
316 //
317 // Check that the data header is for for break data.
318 // (Header contents are defined in genbrk.cpp)
319 //
320 const UDataInfo *pInfo = (const UDataInfo *)((const char *)inData+4);
321 if(!( pInfo->dataFormat[0]==0x42 && /* dataFormat="Brk " */
322 pInfo->dataFormat[1]==0x72 &&
323 pInfo->dataFormat[2]==0x6b &&
324 pInfo->dataFormat[3]==0x20 &&
325 RBBIDataWrapper::isDataVersionAcceptable(pInfo->formatVersion) )) {
326 udata_printError(ds, "ubrk_swap(): data format %02x.%02x.%02x.%02x (format version %02x) is not recognized\n",
327 pInfo->dataFormat[0], pInfo->dataFormat[1],
328 pInfo->dataFormat[2], pInfo->dataFormat[3],
329 pInfo->formatVersion[0]);
330 *status=U_UNSUPPORTED_ERROR;
331 return 0;
332 }
333
334 //
335 // Swap the data header. (This is the generic ICU Data Header, not the RBBI Specific
336 // RBBIDataHeader). This swap also conveniently gets us
337 // the size of the ICU d.h., which lets us locate the start
338 // of the RBBI specific data.
339 //
340 int32_t headerSize=udata_swapDataHeader(ds, inData, length, outData, status);
341
342
343 //
344 // Get the RRBI Data Header, and check that it appears to be OK.
345 //
346 const uint8_t *inBytes =(const uint8_t *)inData+headerSize;
347 RBBIDataHeader *rbbiDH = (RBBIDataHeader *)inBytes;
348 if (ds->readUInt32(rbbiDH->fMagic) != 0xb1a0 ||
349 !RBBIDataWrapper::isDataVersionAcceptable(rbbiDH->fFormatVersion) ||
350 ds->readUInt32(rbbiDH->fLength) < sizeof(RBBIDataHeader)) {
351 udata_printError(ds, "ubrk_swap(): RBBI Data header is invalid.\n");
352 *status=U_UNSUPPORTED_ERROR;
353 return 0;
354 }
355
356 //
357 // Prefight operation? Just return the size
358 //
359 int32_t breakDataLength = ds->readUInt32(rbbiDH->fLength);
360 int32_t totalSize = headerSize + breakDataLength;
361 if (length < 0) {
362 return totalSize;
363 }
364
365 //
366 // Check that length passed in is consistent with length from RBBI data header.
367 //
368 if (length < totalSize) {
369 udata_printError(ds, "ubrk_swap(): too few bytes (%d after ICU Data header) for break data.\n",
370 breakDataLength);
371 *status=U_INDEX_OUTOFBOUNDS_ERROR;
372 return 0;
373 }
374
375
376 //
377 // Swap the Data. Do the data itself first, then the RBBI Data Header, because
378 // we need to reference the header to locate the data, and an
379 // inplace swap of the header leaves it unusable.
380 //
381 uint8_t *outBytes = (uint8_t *)outData + headerSize;
382 RBBIDataHeader *outputDH = (RBBIDataHeader *)outBytes;
383
384 int32_t tableStartOffset;
385 int32_t tableLength;
386
387 //
388 // If not swapping in place, zero out the output buffer before starting.
389 // Individual tables and other data items within are aligned to 8 byte boundaries
390 // when originally created. Any unused space between items needs to be zero.
391 //
392 if (inBytes != outBytes) {
393 uprv_memset(outBytes, 0, breakDataLength);
394 }
395
396 //
397 // Each state table begins with several 32 bit fields. Calculate the size
398 // in bytes of these.
399 //
400 int32_t topSize = offsetof(RBBIStateTable, fTableData);
401
402 // Forward state table.
403 tableStartOffset = ds->readUInt32(rbbiDH->fFTable);
404 tableLength = ds->readUInt32(rbbiDH->fFTableLen);
405
406 if (tableLength > 0) {
407 RBBIStateTable *rbbiST = (RBBIStateTable *)(inBytes+tableStartOffset);
408 UBool use8Bits = ds->readUInt32(rbbiST->fFlags) & RBBI_8BITS_ROWS;
409
410 ds->swapArray32(ds, inBytes+tableStartOffset, topSize,
411 outBytes+tableStartOffset, status);
412
413 // Swap the state table if the table is in 16 bits.
414 if (use8Bits) {
415 if (outBytes != inBytes) {
416 uprv_memmove(outBytes+tableStartOffset+topSize,
417 inBytes+tableStartOffset+topSize,
418 tableLength-topSize);
419 }
420 } else {
421 ds->swapArray16(ds, inBytes+tableStartOffset+topSize, tableLength-topSize,
422 outBytes+tableStartOffset+topSize, status);
423 }
424 }
425
426 // Reverse state table. Same layout as forward table, above.
427 tableStartOffset = ds->readUInt32(rbbiDH->fRTable);
428 tableLength = ds->readUInt32(rbbiDH->fRTableLen);
429
430 if (tableLength > 0) {
431 RBBIStateTable *rbbiST = (RBBIStateTable *)(inBytes+tableStartOffset);
432 UBool use8Bits = ds->readUInt32(rbbiST->fFlags) & RBBI_8BITS_ROWS;
433
434 ds->swapArray32(ds, inBytes+tableStartOffset, topSize,
435 outBytes+tableStartOffset, status);
436
437 // Swap the state table if the table is in 16 bits.
438 if (use8Bits) {
439 if (outBytes != inBytes) {
440 uprv_memmove(outBytes+tableStartOffset+topSize,
441 inBytes+tableStartOffset+topSize,
442 tableLength-topSize);
443 }
444 } else {
445 ds->swapArray16(ds, inBytes+tableStartOffset+topSize, tableLength-topSize,
446 outBytes+tableStartOffset+topSize, status);
447 }
448 }
449
450 // Trie table for character categories
451 ucptrie_swap(ds, inBytes+ds->readUInt32(rbbiDH->fTrie), ds->readUInt32(rbbiDH->fTrieLen),
452 outBytes+ds->readUInt32(rbbiDH->fTrie), status);
453
454 // Source Rules Text. It's UTF8 data
455 if (outBytes != inBytes) {
456 uprv_memmove(outBytes+ds->readUInt32(rbbiDH->fRuleSource),
457 inBytes+ds->readUInt32(rbbiDH->fRuleSource),
458 ds->readUInt32(rbbiDH->fRuleSourceLen));
459 }
460
461 // Table of rule status values. It's all int_32 values
462 ds->swapArray32(ds, inBytes+ds->readUInt32(rbbiDH->fStatusTable), ds->readUInt32(rbbiDH->fStatusTableLen),
463 outBytes+ds->readUInt32(rbbiDH->fStatusTable), status);
464
465 // And, last, the header.
466 // It is all int32_t values except for fFormataVersion, which is an array of four bytes.
467 // Swap the whole thing as int32_t, then re-swap the one field.
468 //
469 ds->swapArray32(ds, inBytes, sizeof(RBBIDataHeader), outBytes, status);
470 ds->swapArray32(ds, outputDH->fFormatVersion, 4, outputDH->fFormatVersion, status);
471
472 return totalSize;
473 }
474
475
476 #endif /* #if !UCONFIG_NO_BREAK_ITERATION */
477