1/* 2******************************************************************************* 3* 4* Copyright (C) 2000, International Business Machines 5* Corporation and others. All Rights Reserved. 6* 7******************************************************************************* 8* 9* File writejava.c 10* 11* Modification History: 12* 13* Date Name Description 14* 01/11/02 Ram Creation. 15******************************************************************************* 16*/ 17 18#ifndef RLE_H 19#define RLE_H 1 20 21#include "unicode/utypes.h" 22#include "unicode/ustring.h" 23 24U_CDECL_BEGIN 25/** 26 * Construct a string representing a byte array. Use run-length encoding. 27 * Two bytes are packed into a single char, with a single extra zero byte at 28 * the end if needed. A byte represents itself, unless it is the 29 * ESCAPE_BYTE. Then the following notations are possible: 30 * ESCAPE_BYTE ESCAPE_BYTE ESCAPE_BYTE literal 31 * ESCAPE_BYTE n b n instances of byte b 32 * Since an encoded run occupies 3 bytes, we only encode runs of 4 or 33 * more bytes. Thus we have n > 0 and n != ESCAPE_BYTE and n <= 0xFF. 34 * If we encounter a run where n == ESCAPE_BYTE, we represent this as: 35 * b ESCAPE_BYTE n-1 b 36 * The ESCAPE_BYTE value is chosen so as not to collide with commonly 37 * seen values. 38 */ 39int32_t 40byteArrayToRLEString(const uint8_t* src,int32_t srcLen, uint16_t* buffer,int32_t bufLen, UErrorCode* status); 41 42 43/** 44 * Construct a string representing a char array. Use run-length encoding. 45 * A character represents itself, unless it is the ESCAPE character. Then 46 * the following notations are possible: 47 * ESCAPE ESCAPE ESCAPE literal 48 * ESCAPE n c n instances of character c 49 * Since an encoded run occupies 3 characters, we only encode runs of 4 or 50 * more characters. Thus we have n > 0 and n != ESCAPE and n <= 0xFFFF. 51 * If we encounter a run where n == ESCAPE, we represent this as: 52 * c ESCAPE n-1 c 53 * The ESCAPE value is chosen so as not to collide with commonly 54 * seen values. 55 */ 56int32_t 57usArrayToRLEString(const uint16_t* src,int32_t srcLen,uint16_t* buffer, int32_t bufLen,UErrorCode* status); 58 59/** 60 * Construct an array of bytes from a run-length encoded string. 61 */ 62int32_t 63rleStringToByteArray(uint16_t* src, int32_t srcLen, uint8_t* target, int32_t tgtLen, UErrorCode* status); 64/** 65 * Construct an array of shorts from a run-length encoded string. 66 */ 67int32_t 68rleStringToUCharArray(uint16_t* src, int32_t srcLen, uint16_t* target, int32_t tgtLen, UErrorCode* status); 69 70U_CDECL_END 71 72#endif 73