Diff for /parser3/src/main/pa_string.C between versions 1.111 and 1.250

version 1.111, 2001/10/17 15:44:47 version 1.250, 2015/10/08 18:29:16
Line 1 Line 1
 /** @file  /** @file
         Parser: string class. @see untasize_t.C.          Parser: string class. @see untalength_t.C.
   
         Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)          Copyright (c) 2001-2012 Art. Lebedev Studio (http://www.artlebedev.com)
         Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)          Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
   
         $Id$  
 */  */
   
 #include "pa_config_includes.h"  
   
 #include "pcre.h"  
 #include "internal.h"  
   
 #include "pa_pool.h"  
 #include "pa_string.h"  #include "pa_string.h"
 #include "pa_hash.h"  
 #include "pa_exception.h"  #include "pa_exception.h"
 #include "pa_common.h"  
 #include "pa_array.h"  
 #include "pa_globals.h"  
 #include "pa_table.h"  #include "pa_table.h"
 #include "pa_dictionary.h"  #include "pa_dictionary.h"
   #include "pa_charset.h"
   #include "pa_vregex.h"
   
 String::String(Pool& apool, const char *src, size_t src_size, bool tainted) :  volatile const char * IDENT_PA_STRING_C="$Id$" IDENT_PA_STRING_H;
         Pooled(apool),  
         forigins_mode(false) {  const String String::Empty;
         last_chunk=&head;  
         head.count=CR_PREALLOCATED_COUNT;  // pa_atoui is based on Manuel Novoa III _strto_l for uClibc
         append_here=head.rows;  
         head.preallocated_link=0;  template<typename T> inline T pa_ato_any(const char *str, int base, const String* problem_source,const T max){
         link_row=&head.rows[head.count];          T result = 0;
         fused_rows=fsize=0;          const char *pos = str;
   
         if(src)          while (isspace(*pos)) /* skip leading whitespace */
                 if(tainted)                  ++pos;
                         APPEND_TAINTED(src, src_size, 0, 0);  
                 else          if (base == 16 && *pos == '0') { /* handle option prefix */
                         APPEND_CLEAN(src, src_size, 0, 0);                  ++pos;
 }                  if (*pos == 'x' || *pos == 'X') {
                           ++pos;
 String::String(const String& src) :                       }
         Pooled(src.pool()),          }
         forigins_mode(false) {  
         head.count=CR_PREALLOCATED_COUNT;          if (base == 0) { /* dynamic base */
                           base = 10; /* default is 10 */
         size_t src_used_rows=src.fused_rows;                  if (*pos == '0') {
         if(src_used_rows<=head.count) {                          ++pos;
                 // all new rows fit size_to preallocated area                          if (*pos == 'x' || *pos == 'X'){
                 last_chunk=&head;                                  ++pos;
                 size_t curr_chunk_rows=head.count;                                  base=16;
                 memcpy(head.rows, src.head.rows, sizeof(Chunk::Row)*src_used_rows);  
                 append_here=&head.rows[src_used_rows];  
                 link_row=&head.rows[curr_chunk_rows];  
         } else {  
                 // warning:   
                 //   heavily relies on the fact   
                 //   "preallocated area is the same for all strings"  
                 //  
                 // info:  
                 //   allocating only enough mem to fit src string rows  
                 //   next append would allocate a new chunk  
                 //  
                 // new rows don't fit size_to preallocated area: splitting size_to two chunks  
                 // preallocated chunk src to constructing head  
                 memcpy(head.rows, src.head.rows, sizeof(Chunk::Row)*head.count);  
                 // remaining rows size_to new_chunk  
                 size_t curr_chunk_rows=src_used_rows-head.count;  
                 last_chunk=static_cast<Chunk *>(  
                         malloc(sizeof(size_t)+sizeof(Chunk::Row)*curr_chunk_rows+sizeof(Chunk *)));  
                 last_chunk->count=curr_chunk_rows;  
                 head.preallocated_link=last_chunk;  
                 append_here=link_row=&last_chunk->rows[last_chunk->count];  
   
                 Chunk *old_chunk=src.head.preallocated_link;   
                 Chunk::Row *new_rows=last_chunk->rows;  
                 size_t rows_left_to_copy=last_chunk->count;  
                 while(true) {  
                         size_t old_count=old_chunk->count;  
                         Chunk *next_chunk=old_chunk->rows[old_count].link;  
                         if(next_chunk) {  
                                 // not last source chunk  
                                 // taking it all  
                                 memcpy(new_rows, old_chunk->rows, sizeof(Chunk::Row)*old_count);  
                                 new_rows+=old_count;  
                                 rows_left_to_copy-=old_count;  
   
                                 old_chunk=next_chunk;  
                         } else {  
                                 // the last source chunk  
                                 // taking only those rows of chunk that _left_to_copy  
                                 memcpy(new_rows, old_chunk->rows, sizeof(Chunk::Row)*rows_left_to_copy);  
                                 break;  
                         }                          }
                 }                  }
         }          }
         link_row->link=0;  
         fused_rows=src_used_rows;          if (base < 2 || base > 16) { /* illegal base */
         fsize=src.fsize;                  throw Exception(PARSER_RUNTIME, 0, "base to must be an integer from 2 to 16");
 }          }
   
 void String::expand() {          T cutoff = max / base;
         size_t new_chunk_count=last_chunk->count+CR_GROW_COUNT;          int cutoff_digit = (int)(max - cutoff * base);
         last_chunk=static_cast<Chunk *>(  
                 malloc(sizeof(size_t)+sizeof(Chunk::Row)*new_chunk_count+sizeof(Chunk *)));          while(true) {
         last_chunk->count=new_chunk_count;                  int digit;
         link_row->link=last_chunk;                  
         append_here=last_chunk->rows;                  if ((*pos >= '0') && (*pos <= '9')) {
         link_row=&last_chunk->rows[last_chunk->count];                          digit = (*pos - '0');
         link_row->link=0;                  } else if (*pos >= 'a') {
 }                          digit = (*pos - 'a' + 10);
                   } else if (*pos >= 'A') {
 String& String::append(const String& src, Untaint_lang lang, bool forced) {                          digit = (*pos - 'A' + 10);
         const Chunk *chunk=&src.head;                   } else break;
         do {  
                 const Chunk::Row *row=chunk->rows;                  if (digit >= base) {
                 for(size_t i=0; i<chunk->count; i++, row++) {                          break;
                         if(row==src.append_here)                  }
                                 goto break2;                  
                                           ++pos;
                         APPEND(row->item.ptr, row->item.size,                   
                                 (lang!=UL_PASS_APPENDED && (row->item.lang==UL_TAINTED || forced))?lang:row->item.lang,                  /* adjust number, with overflow check */
                                 row->item.origin.file, row->item.origin.line);                  if ((result > cutoff) || ((result == cutoff) && (digit > cutoff_digit))) {
                 }                          throw Exception("number.format", problem_source, problem_source ? "out of range (int)" : "'%s' is out of range (int)", str);
                 chunk=row->link;                  } else {
         } while(chunk);                          result  = result * base + digit;
 break2:                  }
         return *this;          }
   
           while(char c=*pos++)
                   if(!isspace(c))
                           throw Exception("number.format", problem_source, problem_source ? "invalid number (int)" : "'%s' is invalid number (int)", str);
   
           return result;
 }  }
   
 String& String::real_append(STRING_APPEND_PARAMS) {  unsigned int pa_atoui(const char *str, int base, const String* problem_source){
         if(!src)      return pa_ato_any<unsigned int>(str, base, problem_source, UINT_MAX);
                 return *this;  }
         if(!size)  
                 size=strlen(src);  unsigned long long pa_atoul(const char *str, int base, const String* problem_source){
         if(!size)      return pa_ato_any<unsigned long long int>(str, base, problem_source, ULLONG_MAX);
                 return *this;  }
   
         if(chunk_is_full())  int pa_atoi(const char* str, const String* problem_source) {
                 expand();          if(!str)
                   return 0;
         append_here->item.ptr=src;  
         fsize+=append_here->item.size=size;          while(isspace(*str))
         append_here->item.lang=lang;                  str++;
 #ifndef NO_STRING_ORIGIN  
         append_here->item.origin.file=file;          if(!*str)
         append_here->item.origin.line=line;                  return 0;
   
           bool negative=false;
           if(str[0]=='-') {
                   negative=true;
                   str++;
           } else if(str[0]=='+') {
                   str++;
           }
   
           unsigned int result=pa_atoui(str, 0, problem_source);
   
           if(negative && result <= ((unsigned int)(-(1+INT_MIN)))+1)
                   return -(int)result;
           
           if(result<=INT_MAX)
                   return (int)result;
           
           throw Exception("number.format", problem_source, problem_source ? "out of range (int)" : "'%s' is out of range (int)", str);
   }
   
   double pa_atod(const char* str, const String* problem_source) {
           if(!str)
                   return 0;
   
           while(isspace(*str))
                   str++;
   
           if(!*str)
                   return 0;
   
           bool negative=false;
           if(str[0]=='-') {
                   negative=true;
                   str++;
           } else if(str[0]=='+') {
                   str++;
           }
   
           double result;
           if(str[0]=='0') {
                   if(str[1]=='x' || str[1]=='X') {
                           // 0xABC
                           result=(double)pa_atoul(str, 0, problem_source);
                           return negative ? -result : result;
                   } else {
                            // skip leading 0000, to disable octal interpretation
                           do str++; while(*str=='0');
                   }
           }
   
           char *error_pos;
           result=strtod(str, &error_pos);
   
           while(char c=*error_pos++)
                   if(!isspace((unsigned char)c))
                           throw Exception("number.format", problem_source, problem_source ? "invalid number (double)" : "'%s' is invalid number (double)", str);
   
           return negative ? -result : result;
   }
   
   // cord lib extension
   
   #ifndef DOXYGEN
   typedef struct {
       ssize_t countdown;
       int target; /* Character we're looking for  */
   } chr_data;
 #endif  #endif
         append_here++; fused_rows++;  
   
         return *this;  static int CORD_range_contains_chr_greater_then_proc(char c, size_t size, void* client_data)
   {
       register chr_data * d = (chr_data *)client_data;
       
       if (d -> countdown<=0) return(2);
       d -> countdown -= size;
       if (c > d -> target) return(1);
       return(0);
 }  }
   
 char String::first_char() const {  int CORD_range_contains_chr_greater_then(CORD x, size_t i, size_t n, int c)
         if(!fused_rows)  {
                 THROW(0, 0,      chr_data d;
                         this,  
                         "getting first char of empty string");      d.countdown = n;
       d.target = c;
         return *head.rows[0].item.ptr;      return(CORD_block_iter(x, i, CORD_range_contains_chr_greater_then_proc, &d) == 1/*alternatives: 0 normally ended, 2=struck 'n'*/);
 }  
   
 uint String::hash_code() const {  
         uint result=0;  
   
         const Chunk *chunk=&head;   
         do {  
                 const Chunk::Row *row=chunk->rows;  
                 for(size_t i=0; i<chunk->count; i++) {  
                         if(row==append_here)  
                                 goto break2;  
   
                         result=Hash::generic_code(result, row->item.ptr, row->item.size);  
                         row++;  
                 }  
                 chunk=row->link;  
         } while(chunk);  
 break2:  
         return result;  
 }  }
   
 /// @todo move 'lang' skipping to pos  static int CORD_block_count_proc(char /*c*/, size_t /*size*/, void* client_data)
 int String::cmp(int& partial, const String& src,   {
                                 size_t this_offset, Untaint_lang lang) const {      int* result=(int*)client_data;
         partial=-1;      (*result)++;
         this_offset=min(this_offset, size()-1);      return(0); // 0=continue
   }
         const Chunk *a_chunk=&head;  
         const Chunk *b_chunk=&src.head;  size_t CORD_block_count(CORD x)
         const Chunk::Row *a_row=a_chunk->rows;  {
         const Chunk::Row *b_row=b_chunk->rows;          size_t result=0;
         size_t a_offset=this_offset;          CORD_block_iter(x, 0, CORD_block_count_proc, &result);
         size_t b_offset=0;      return result;
         Chunk::Row *a_end=append_here;  }
         Chunk::Row *b_end=src.append_here;  
         size_t a_countdown=a_chunk->count;  // helpers
         size_t b_countdown=b_chunk->count;  
         size_t result;  /// String::match uses this as replace & global search table columns
         size_t pos=0;   
   const int MAX_MATCH_GROUPS=100;
         bool a_break=size()==0;  
         bool b_break=src.size()==0;  class String_match_table_template_columns: public ArrayString {
         if(!(a_break || b_break)) while(true) {  public:
                 if(pos+a_row->item.size > this_offset) {          String_match_table_template_columns() {
                         if(lang!=UL_UNSPECIFIED && a_row->item.lang!=lang)                   *this+=new String("prematch");
                                 return -1; // wrong lang -- bail out                  *this+=new String("match");
                   *this+=new String("postmatch");
                         int size_diff=                  for(int i=0; i<MAX_MATCH_GROUPS; i++) {
                                 (a_row->item.size-a_offset)-                          *this+=new String(String::Body::Format(1+i), String::L_CLEAN);
                                 (b_row->item.size-b_offset);                  }
                                   }
                         if(size_diff==0) { // a has same size as b  };
                                 result=memcmp(a_row->item.ptr+a_offset, b_row->item.ptr+b_offset,   
                                         a_row->item.size-a_offset);  Table string_match_table_template(new String_match_table_template_columns);
                                 if(result)  
                                         return result;  // String::Body methods
                                 pos+=a_row->item.size;  
                                 a_row++; a_countdown--; a_offset=0;  String::Body String::Body::Format(int value) {
                                 b_row++; b_countdown--; b_offset=0;          char local[MAX_NUMBER];
                         } else if (size_diff>0) { // a longer          size_t length=snprintf(local, MAX_NUMBER, "%d", value);
                                 result=memcmp(a_row->item.ptr+a_offset, b_row->item.ptr+b_offset,           return String::Body(pa_strdup(local, length));
                                         b_row->item.size-b_offset);  }
                                 if(result)  
                                         return result;  String::Body String::Body::trim(String::Trim_kind kind, const char* chars, 
                                 a_offset+=b_row->item.size-b_offset;                                                                  size_t* out_start, size_t* out_length, Charset* source_charset) const {
                                 b_row++; b_countdown--; b_offset=0;          size_t our_length=length();
                         } else { // b longer          if(!our_length)
                                 result=memcmp(a_row->item.ptr+a_offset, b_row->item.ptr+b_offset,                   return *this;
                                         a_row->item.size-a_offset);  
                                 if(result)          // check if any UTF-8 in chars
                                         return result;          bool fast=true;
                                 b_offset+=a_row->item.size-a_offset;          if(chars && source_charset && source_charset->isUTF8()){
                                 pos+=a_row->item.size;                  const char* pos=chars;
                                 a_row++; a_countdown--; a_offset=0;                  while(unsigned char c=*pos++)
                         }                          if(c>127){
                         if(b_break=b_row==b_end) {                                  fast=false;
                                 a_break=a_row==a_end;                                  break;
                                 break;                    
                         }                          }
                         if(!b_countdown) {          }
                                 b_chunk=b_row->link;  
                                 b_row=b_chunk->rows;          size_t start=0;
                                 b_countdown=b_chunk->count;          size_t end=our_length;
           if(!chars)
                   chars=" \t\n"; // white space
   
           if(fast){
                   // from left...
                   if(kind!=TRIM_END) {
                           CORD_pos pos; set_pos(pos, 0);
                           while(true) {
                                   char c=CORD_pos_fetch(pos);
                                   if(strchr(chars, c)) {
                                           if(++start==our_length)
                                                   return 0; // all chars are empty, just return empty string
                                   } else
                                           break;                  
   
                                   CORD_next(pos);
                         }                          }
                 } else {  
                         a_offset-=a_row->item.size;  
                         pos+=a_row->item.size;  
                         a_row++; a_countdown--;   
                 }                  }
   
                 if(a_break=a_row==a_end) {                  // from right..
                         b_break=b_row==b_end;                  if(kind!=TRIM_START) {
                         break;                          CORD_pos pos; set_pos(pos, end-1);
                 }                          while(true) {
                 if(!a_countdown) {                                  char c=CORD_pos_fetch(pos);
                         a_chunk=a_row->link;                                  if(strchr(chars, c)) {
                         a_row=a_chunk->rows;                                          if(--end==0) // optimization: NO need to check for 'end>=start', that's(<) impossible
                         a_countdown=a_chunk->count;                                                  return 0; // all chars are empty, just return empty string
                                   } else
                                           break;                  
   
                                   CORD_prev(pos);
                           }
                 }                  }
         }  
         if(a_break==b_break) { // ended simultaneously  
                 partial=0; return 0;  
         } else if(a_break) { // first bytes equal, but a ended before b  
                 partial=1; return -1;  
         } else {          } else {
                 partial=2; return +1;                  const XMLByte* src_begin=(const XMLByte*)cstr();
         }                  const XMLByte* src_end=src_begin+our_length;
 }  
   
 /// @todo move 'lang' skipping to pos                  // from left...
 int String::cmp(int& partial, const char* b_ptr, size_t src_size,                   if(kind!=TRIM_END) {
                                 size_t this_offset, Untaint_lang lang) const {                          while(src_begin<src_end){
         partial=-1;                                  uint char_length=1;
         size_t b_size=src_size?src_size:b_ptr?strlen(b_ptr):0;                                  const XMLByte* ptr=src_begin;
         this_offset=min(this_offset, size()-1);                                  // searching first UTF-8 byte: http://tools.ietf.org/html/rfc3629#section-3
                                   while(++src_begin<=src_end && (*src_begin>127 && *src_begin<0xC0))
         const Chunk *a_chunk=&head;                                          char_length++;
         const Chunk::Row *a_row=a_chunk->rows;  
         size_t a_offset=this_offset;                                  bool found=false;
         size_t b_offset=0;                                  for(const char* chars_byte=chars; chars_byte=strchr(chars_byte, *ptr); chars_byte++)
         Chunk::Row *a_end=append_here;                                          if(strncmp(chars_byte, (const char*)ptr, char_length)==0){
         size_t a_countdown=a_chunk->count;                                                  found=true;
         size_t pos=0;                                                  break;
                                           }
         bool a_break=size()==0;  
         bool b_break=b_size==0;                                  if(found){
         if(!(a_break || b_break)) while(true) {                                          start+=char_length;
                 if(pos+a_row->item.size > this_offset) {                                          if(start==our_length)
                         if(lang!=UL_UNSPECIFIED && a_row->item.lang!=lang)                                                   return 0; // all chars are empty, just return empty string
                                 return -1; // wrong lang -- bail out                                  } else
                                           break;
                         int size_diff=  
                                 (a_row->item.size-a_offset)-  
                                 (b_size-b_offset);  
                           
                         if(size_diff==0) { // a has same size as b  
                                 if(size_t result=memcmp(a_row->item.ptr+a_offset, b_ptr+b_offset,   
                                         a_row->item.size-a_offset)!=0)  
                                         return result;  
                                 pos+=a_row->item.size;  
                                 a_row++; a_countdown--; a_offset=0;  
                                 b_break=true;  
                         } else if (size_diff>0) { // a longer  
                                 if(size_t result=memcmp(a_row->item.ptr+a_offset, b_ptr+b_offset,   
                                         b_size-b_offset)!=0)  
                                         return result;  
                                 a_offset+=b_size-b_offset;  
                                 b_break=true;  
                         } else { // b longer  
                                 if(size_t result=memcmp(a_row->item.ptr+a_offset, b_ptr+b_offset,   
                                         a_row->item.size-a_offset)!=0)  
                                         return result;  
                                 b_offset+=a_row->item.size-a_offset;  
                                 pos+=a_row->item.size;  
                                 a_row++; a_countdown--; a_offset=0;  
                         }                          }
                 } else {  
                         a_offset-=a_row->item.size;   
                         pos+=a_row->item.size;  
                         a_row++; a_countdown--;   
                 }                  }
   
                 a_break=a_row==a_end;                  // from right..
                 if(a_break || b_break)                  if(kind!=TRIM_START) {
                         break;                          while(src_begin<src_end){
                 if(!a_countdown) {                                  uint char_length=1;
                         a_chunk=a_row->link;                                  // searching first UTF-8 byte: http://tools.ietf.org/html/rfc3629#section-3
                         a_row=a_chunk->rows;                                  while(src_begin<=--src_end && (*src_end>127 && *src_end<0xC0))
                         a_countdown=a_chunk->count;                                          char_length++;
   
                                   bool found=false;
                                   for(const char* chars_byte=chars; chars_byte=strchr(chars_byte, *src_end); chars_byte++)
                                           if(strncmp(chars_byte, (const char*)src_end, char_length)==0){
                                                   found=true;
                                                   break;
                                           }
   
                                   if(found){
                                           end-=char_length;
                                           if(end==0)
                                                   return 0; // all chars are empty, just return empty string
                                   } else
                                           break;
                           }
                 }                  }
         }          }
         if(a_break==b_break) { // ended simultaneously  
                 partial=0; return 0;          if(start==0 && end==our_length) // nobody moved a thing
         } else if(a_break) { // first bytes equal, but a ended before b                  return *this;
                 partial=1; return -1;  
           if(out_start)
                   *out_start=start;
           size_t new_length=end-start;
           if(out_length)
                   *out_length=new_length;
   
           return mid(start, new_length);
   }
   
   static int CORD_batched_iter_fn_generic_hash_code(char c, void * client_data) {
           uint& result=*static_cast<uint*>(client_data);
           generic_hash_code(result, c);
           return 0;
   }
   
   static int CORD_batched_iter_fn_generic_hash_code(const char*  s, void * client_data) {
           uint& result=*static_cast<uint*>(client_data);
           generic_hash_code(result, s);
           return 0;
   }
   
   uint String::Body::get_hash_code() const {
   #ifdef HASH_CODE_CACHING
           if(hash_code)
                   return hash_code;
   #else
           uint hash_code=0;
   #endif
           if (body && CORD_IS_STRING(body)){
                   generic_hash_code(hash_code, (const char *)body);
         } else {          } else {
                 partial=2; return +1;                  CORD_iter5(body, 0,
                           CORD_batched_iter_fn_generic_hash_code, 
                           CORD_batched_iter_fn_generic_hash_code, &hash_code);
         }          }
           return hash_code;
 }  }
   
 #ifndef NO_STRING_ORIGIN  struct CORD_pos_info {
 const Origin& String::origin() const {           const char* chars;
         if(!fused_rows) {          size_t left;
                 static const Origin empty_origin={"empty string"};          size_t pos;
                 return empty_origin;  };
   
   // can be called only for IS_FUNCTION(CORD) which is used in String::Body::strrpbrk
   static int CORD_iter_fn_rpos(char c, CORD_pos_info* info) {
           if(info->pos < info->left){
                   info->pos=STRING_NOT_FOUND;
                   return 1;
         }          }
                   if(strchr(info->chars, c))
         // determining origin by last appended piece                  return 1;
         // because first one frequently constant.           --(info->pos);
         // ex: ^load[/file] "document_root" + "/file"          return 0;
         // when last peice is constant,   }
         // ex: parser_root_auto_path{dynamic} / auto.p{const}  
         // using first piece  size_t String::Body::strrpbrk(const char* chars, size_t left, size_t right) const {
         Origin& last_origin=append_here[-1].item.origin;          if(is_empty() || !chars || !strlen(chars))
         return last_origin.file ? last_origin : head.rows[0].item.origin;                  return STRING_NOT_FOUND;
           CORD_pos_info info={chars, left, right};
           if(CORD_riter4(body, right, (CORD_iter_fn)CORD_iter_fn_rpos, &info))
                   return info.pos;
           else
                   return STRING_NOT_FOUND;
   }
   
   
   // can be called only for IS_FUNCTION(CORD) which is used in String::Body::rskipchars
   static int CORD_iter_fn_rskip(char c, CORD_pos_info* info) {
           if(info->pos < info->left) {
                   info->pos=STRING_NOT_FOUND;
                   return 1;
           }
           if(!strchr(info->chars, c))
                   return 1;
           --(info->pos);
           return 0;
   }
   
   size_t String::Body::rskipchars(const char* chars, size_t left, size_t right) const {
           if(is_empty() || !chars || !strlen(chars))
                   return STRING_NOT_FOUND;
           CORD_pos_info info={chars, left, right};
           if(CORD_riter4(body, right, (CORD_iter_fn)CORD_iter_fn_rskip, &info))
                   return info.pos;
           else
                   return STRING_NOT_FOUND;
 }  }
 #endif  
   
 String& String::mid(size_t start, size_t finish) const {  // String methods
         String& result=*NEW String(pool());  
   
         start=max(0, start);  String& String::append_know_length(const char* str, size_t known_length, Language lang) {
         finish=min(size(), finish);          if(!known_length)
         if(start==finish)                  return *this;
   
           // first: langs
           langs.append(body, lang, known_length);
           // next: letters themselves
           body.append_know_length(str, known_length);
   
           ASSERT_STRING_INVARIANT(*this);
           return *this;
   }
   
   String& String::append_help_length(const char* str, size_t helper_length, Language lang) {
           if(!str)
                   return *this;
           size_t known_length=helper_length?helper_length:strlen(str);
           if(!known_length)
                   return *this;
   
           return append_know_length(str, known_length, lang);
   }
   
   String::String(int value, const char *format) : langs(L_CLEAN){
           char buf[MAX_NUMBER];
           body.append_strdup_know_length(buf, snprintf(buf, MAX_NUMBER, format, value));
   }
   
   String& String::append_strdup(const char* str, size_t helper_length, Language lang) {
           size_t known_length=helper_length?helper_length:strlen(str);
           if(!known_length)
                   return *this;
   
           // first: langs
           langs.append(body, lang, known_length);
           // next: letters themselves
           body.append_strdup_know_length(str, known_length);
   
           ASSERT_STRING_INVARIANT(*this);
           return *this;
   }
   
   struct CORD_length_info {
           size_t len;
           size_t skip;
   };
   
   int CORD_batched_len(const char* s, CORD_length_info* info){
           info->len += lengthUTF8( (const XMLByte *)s, (const XMLByte *)s+strlen(s));     return 0;
   }
   
   // can be called only for IS_FUNCTION(CORD) which are used in large String::Body::mid
   int CORD_batched_len(const char c, CORD_length_info* info){
           if (info->skip==0){
                   info->len++;
                   info->skip = lengthUTF8Char(c)-1;
           } else {
                   info->skip--;
           }
           return 0;
   }
   
   size_t String::length(Charset& charset) const {
           if(charset.isUTF8()){
                   CORD_length_info info = {0, 0};
                   body.for_each<CORD_length_info *>(CORD_batched_len, CORD_batched_len, &info);
                   return info.len;
           } else
                   return body.length();
   }
   
   /// @todo check in doc: whether it documents NOW bad situation "abc".mid(-1, 3) =were?="ab"
   String& String::mid(size_t substr_begin, size_t substr_end) const {
           String& result=*new String;
   
           size_t self_length=length();
           substr_begin=min(substr_begin, self_length);
           substr_end=min(max(substr_end, substr_begin), self_length);
           size_t substr_length=substr_end-substr_begin;
           if(!substr_length)
                 return result;                  return result;
   
         size_t pos=0;          // first: their langs
         const Chunk *chunk=&head;           result.langs.append(result.body, langs, substr_begin, substr_length);
         do {          // next: letters themselves
                 const Chunk::Row *row=chunk->rows;          result.body=body.mid(substr_begin, substr_length);
                 for(size_t i=0; i<chunk->count; pos+=row->item.size, i++, row++) {  
                         if(row==append_here)          ASSERT_STRING_INVARIANT(result);
                                 goto break2;  
   
                         size_t item_finish=pos+row->item.size;  
                         if(item_finish > start) { // started now or already?  
                                 bool started=result.size()==0; // started now?  
                                 bool finished=finish <= item_finish; // finished now?  
                                 size_t offset=started?start-pos:0;  
                                 size_t size=finished?finish-pos:row->item.size;  
                                 result.APPEND(  
                                         row->item.ptr+offset, size-offset,   
                                         row->item.lang,  
                                         row->item.origin.file, row->item.origin.line);  
                                 if(finished)  
                                         goto break2;  
                         }  
                 }  
                 chunk=row->link;  
         } while(chunk);  
 break2:  
 //      SAPI::log(pool(), "piece of '%s' from %d to %d is '%s'",  
                 //cstr(), start, finish, result.cstr());  
         return result;          return result;
 }  }
   
 int String::pos(const String& substr,   // from, to and helper_length in characters, not in bytes (it's important for utf-8)
                                 size_t result, Untaint_lang lang) const {  String& String::mid(Charset& charset, size_t from, size_t to, size_t helper_length) const {
         for(; result<size(); result++) {          String& result=*new String;
                 int partial; cmp(partial, substr, result, lang);  
                 if(          size_t self_length=(helper_length)?helper_length:length(charset);
                         partial==0 || // full match  
                         partial==2) // 'substr' starts 'this'+'result'          if(!self_length)
                   return result;
   
           from=min(min(to, from), self_length);
           to=min(max(to, from), self_length);
   
           size_t substr_length=to-from;
   
           if(!substr_length)
                   return result;
   
           if(charset.isUTF8()){
                   const XMLByte* src_begin=(const XMLByte*)cstr();
                   const XMLByte* src_end=src_begin+body.length();
   
                   // convert 'from' and 'substr_length' from 'characters' to 'bytes'
                   from=getUTF8BytePos(src_begin, src_end, from);
                   substr_length=getUTF8BytePos(src_begin+from, src_end, substr_length);
                   if(!substr_length)
                         return result;                          return result;
         }          }
           
         return -1;          // first: their langs
           result.langs.append(result.body, langs, from, substr_length);
           // next: letters themselves
           result.body=body.mid(from, substr_length);
   
           ASSERT_STRING_INVARIANT(result);
           return result;
 }  }
   
 int String::pos(const char *substr, size_t substr_size,   size_t String::pos(const String::Body substr, size_t this_offset, Language lang) const {
                                 size_t result, Untaint_lang lang) const {          size_t substr_length=substr.length();
         for(; result<size(); result++) {          while(true) {
                 int partial; cmp(partial, substr, substr_size, result, lang);                  size_t substr_begin=body.pos(substr, this_offset);
                 if(                  
                         partial==0 || // full match                  if(substr_begin==CORD_NOT_FOUND)
                         partial==2) // 'substr' starts 'this'+'result'                          return STRING_NOT_FOUND;
                         return result;  
                   if(langs.check_lang(lang, substr_begin, substr_length))
                           return substr_begin;
   
                   this_offset=substr_begin+substr_length;
         }          }
           
         return -1;  
 }  }
   
 void String::split(Array& result,   size_t String::pos(const String& substr, 
                                    size_t* pos_after_ref,                                   size_t this_offset, Language lang) const {
                                    const char *delim, size_t delim_size,           return pos(substr.body, this_offset, lang);
                                    Untaint_lang lang, int limit) const {  }
         if(delim_size) {  
                 size_t pos_after=pos_after_ref?*pos_after_ref:0;  size_t String::pos(Charset& charset, const String& substr, 
                 int pos_before;                                  size_t this_offset, Language lang) const {
   
           if(charset.isUTF8()){
                   const XMLByte* srcPtr=(const XMLByte*)cstr();
                   const XMLByte* srcEnd=srcPtr+body.length();
   
                   // convert 'this_offset' from 'characters' to 'bytes'
                   this_offset=getUTF8BytePos(srcPtr, srcEnd, this_offset);
   
                   size_t result=pos(substr.body, this_offset, lang);
                   return (result==CORD_NOT_FOUND)
                           ? STRING_NOT_FOUND
                           : getUTF8CharPos(srcPtr, srcEnd, result); // convert 'result' from 'bytes' to 'characters'
           } else {
                   size_t result=pos(substr.body, this_offset, lang);
                   return (result==CORD_NOT_FOUND)
                           ? STRING_NOT_FOUND
                           : result;
           }
   }
   
   void String::split(ArrayString& result, 
                      size_t& pos_after, 
                      const char* delim, 
                      Language lang, int limit) const {
           if(is_empty())
                   return;
           size_t self_length=length();
           if(size_t delim_length=strlen(delim)) {
                   size_t pos_before;
                 // while we have 'delim'...                  // while we have 'delim'...
                 for(; (pos_before=pos(delim, delim_size, pos_after, lang))>=0 && limit; limit--) {                  for(; (pos_before=pos(delim, pos_after, lang))!=STRING_NOT_FOUND && limit; limit--) {
                         result+=&mid(pos_after, pos_before);                          result+=&mid(pos_after, pos_before);
                         pos_after=pos_before+delim_size;                          pos_after=pos_before+delim_length;
                 }                  }
                 // last piece                  // last piece
                 if(pos_after<size() && limit) {                  if(pos_after<self_length && limit) {
                         result+=&mid(pos_after, size());                          result+=&mid(pos_after, self_length);
                         pos_after=size();                          pos_after=self_length;
                 }                  }
                 if(pos_after_ref)  
                         *pos_after_ref=pos_after;  
         } else { // empty delim          } else { // empty delim
                 result+=this;                  result+=this;
                 if(pos_after_ref)                  pos_after+=self_length;
                         *pos_after_ref+=size();  
         }          }
 }  }
   
 void String::split(Array& result,   void String::split(ArrayString& result, 
                                    size_t* pos_after_ref,                      size_t& pos_after, 
                                    const String& delim, Untaint_lang lang,                      const String& delim, Language lang, 
                                    int limit) const {                     int limit) const {
         if(delim.size()) {          if(is_empty())
                 size_t pos_after=pos_after_ref?*pos_after_ref:0;                  return;
                 int pos_before;          if(!delim.is_empty()) {
                   size_t pos_before;
                 // while we have 'delim'...                  // while we have 'delim'...
                 for(; (pos_before=pos(delim, pos_after, lang))>=0 && limit; limit--) {                  for(; (pos_before=pos(delim, pos_after, lang))!=STRING_NOT_FOUND && limit; limit--) {
                         result+=&mid(pos_after, pos_before);                          result+=&mid(pos_after, pos_before);
                         pos_after=pos_before+delim.size();                          pos_after=pos_before+delim.length();
                 }                  }
                 // last piece                  // last piece
                 if(pos_after<size() && limit) {                  if(pos_after<length() && limit) {
                         result+=&mid(pos_after, size());                          result+=&mid(pos_after, length());
                         pos_after=size();                          pos_after=length();
                 }                  }
                 if(pos_after_ref)  
                         *pos_after_ref=pos_after;  
         } else { // empty delim          } else { // empty delim
                 result+=this;                  result+=this;
                 if(pos_after_ref)                  pos_after+=length();
                         *pos_after_ref+=size();  
         }          }
 }  }
   
 static void regex_options(char *options, int *result){  Table* String::match(VRegex* vregex,
     struct Regex_option {                          Row_action row_action, void *info,
                 char key;                          int& matches_count) const { 
                 int clear, set;  
                 int *result;          // vregex->info(); // I have no idea what does it for?
     } regex_option[]={  
                 {'i', 0, PCRE_CASELESS, result}, // a=A          bool need_pre_post_match=vregex->is_pre_post_match_needed();
                 {'s', 0, PCRE_DOTALL, result}, // \n\n$ [default]          bool global=vregex->is_global_search();
                 {'x', 0, PCRE_EXTENDED, result}, // whitespace in regex ignored  
                 {'m', PCRE_DOTALL, PCRE_MULTILINE, result}, // ^aaa\n$^bbb\n$          const char* subject=cstr();
                 {'g', 0, true, result+1}, // many rows          size_t subject_length=length();
                 {0},          const int ovector_size=(1/*match*/+MAX_MATCH_GROUPS)*3;
     };          int ovector[ovector_size];
         result[0]=PCRE_EXTRA | PCRE_DOTALL;  
         result[1]=0;          Table::Action_options table_options;
           Table& table=*new Table(string_match_table_template, table_options);
     if(options)   
                 for(Regex_option *o=regex_option; o->key; o++)           int prestart=0;
                         if(          int poststart=0;
                                 strchr(options, o->key) ||           int postfinish=length();
                                 strchr(options, toupper(o->key))) {          while(true) {
                                 *(o->result)&=~o->clear;                  int exec_result=vregex->exec(subject, subject_length, ovector, ovector_size, prestart);
                                 *(o->result)|=o->set;  
                         }  
 }  
   
 /// @todo maybe need speedup: some option to remove pre/match/post string generation                  if(exec_result<0) // only PCRE_ERROR_NOMATCH might be here, other negative results cause an exception
 bool String::match(const unsigned char *pcre_tables,                          break;
                                    const String *aorigin,  
                                    const String& regexp,                   int prefinish=ovector[0];
                                    const String *options,                  poststart=ovector[1];
                                    Table **table,  
                                    Row_action row_action, void *info,                  if (prestart==poststart && subject[poststart]=='\n'){
                                    bool *was_global) const {                           prestart++;
                           continue;
         if(!regexp.size())  
                 THROW(0, 0,  
                         aorigin,  
                         "regexp is empty");  
         const char *pattern=regexp.cstr(UL_AS_IS);  
         const char *errptr;  
         int erroffset;  
     int option_bits[2];  regex_options(options?options->cstr():0, option_bits);  
         if(was_global)  
                 *was_global=option_bits[1]!=0;  
         pcre *code=pcre_compile(pattern, option_bits[0],   
                 &errptr, &erroffset,  
                 pcre_tables);  
   
         if(!code)  
                 THROW(0, 0,  
                         &regexp.mid(erroffset, regexp.size()),  
                         "regular expression syntax error - %s", errptr);  
           
         int info_substrings=pcre_info(code, 0, 0);  
         if(info_substrings<0) {  
                 pcre_free(code);  
                 THROW(0, 0,  
                         aorigin,  
                         "pcre_info error (%d)",   
                                 info_substrings);  
         }  
   
         int startoffset=0;  
         const char *subject=cstr(UL_AS_IS);  
         int length=strlen(subject);  
         int ovecsize;  
         int *ovector=(int *)malloc(sizeof(int)*  
                 (ovecsize=(1/*match*/+info_substrings)*3));  
   
         { // create table  
                 Array& columns=*NEW Array(pool());  
                 columns+=string_pre_match_name;  
                 columns+=string_match_name;  
                 columns+=string_post_match_name;  
                 for(int i=1; i<=info_substrings; i++) {  
                         char *column=(char *)malloc(MAX_NUMBER);  
                         snprintf(column, MAX_NUMBER, "%d", i);  
                         columns+=NEW String(pool(), column); // .i column name  
                 }                  }
                 *table=NEW Table(pool(), aorigin, &columns);  
         }  
   
         int exec_option_bits=0;                  ArrayString* row=new ArrayString(3);
         while(true) {                  if(need_pre_post_match) {
                 int exec_substrings=pcre_exec(code, 0,                          *row+=&mid(0, prefinish); // .prematch column value
                         subject, length, startoffset,                          *row+=&mid(prefinish, poststart); // .match
                         exec_option_bits, ovector, ovecsize);                          *row+=&mid(poststart, postfinish); // .postmatch
                                   } else {
                 if(exec_substrings==PCRE_ERROR_NOMATCH) {                          *row+=&Empty; // .prematch column value
                         pcre_free(code);                          *row+=&Empty; // .match
                         row_action(**table, 0/*last time, no row*/, 0, 0, info);                          *row+=&Empty; // .postmatch
                         return option_bits[1]!=0; // global=true+table, not global=false                  }
                 }  
   
                 if(exec_substrings<0) {  
                         pcre_free(code);  
                         THROW(0, 0,  
                                 aorigin,  
                                 "regular expression execute error (%d)",   
                                         exec_substrings);  
                 }  
   
                 Array& row=*NEW Array(pool());  
                 row+=&mid(0, ovector[0]); // .prematch column value  
                 row+=&mid(ovector[0], ovector[1]); // .match  
                 row+=&mid(ovector[1], size()); // .postmatch  
                                   
                 for(int i=1; i<exec_substrings; i++) {                  for(int i=1; i<exec_result; i++) {
                         // -1:-1 case handled peacefully by mid() itself                          // -1:-1 case handled peacefully by mid() itself
                         row+=&mid(ovector[i*2+0], ovector[i*2+1]); // .i column value                          *row+=(ovector[i*2+0]>=0 && ovector[i*2+1]>0)?&mid(ovector[i*2+0], ovector[i*2+1]):new String; // .i column value
                 }                  }
                                   
                 row_action(**table, &row, startoffset, ovector[0], info);                  matches_count++;
                   row_action(table, row, prestart, prefinish, poststart, postfinish, info);
   
                 if(!option_bits[1] || startoffset==ovector[1]) { // not global | going to hang                  if(!global || prestart==poststart) // last step
                         pcre_free(code);                          break;
                         row_action(**table, 0/*last time, no row*/, 0, 0, info);  
                         return true;                  prestart=poststart;
                 }  
                 startoffset=ovector[1];  
   
 /*  
                 if(option_bits[0] & PCRE_MULTILINE)  
                         exec_option_bits|=PCRE_NOTBOL; // start of subject+startoffset not BOL  
 */  
         }          }
   
           row_action(table, 0/*last time, no raw*/, 0, 0, poststart, postfinish, info);
           return vregex->is_just_count() ? 0 : &table;
 }  }
   
 String& String::change_case(Pool& pool, const unsigned char *tables,   String& String::change_case(Charset& source_charset, Change_case_kind kind) const {
                                                         Change_case_kind kind) const {          String& result=*new String();
         String& result=*new(pool) String(pool);          if(is_empty())
                   return result;
         const unsigned char *a;  
         const unsigned char *b;  
         switch(kind) {  
         case CC_UPPER:  
                 a=tables+lcc_offset;  
                 b=tables+fcc_offset;  
                 break;  
         case CC_LOWER:  
                 a=tables+lcc_offset;  
                 b=0;  
                 break;  
         default:  
                 PTHROW(0, 0,   
                         this,   
                         "unknown change case kind #%d",   
                                 static_cast<int>(kind)); // never  
                 a=b=0; // calm, compiler  
                 break; // never  
         }         
   
         const Chunk *chunk=&head;   
         do {  
                 const Chunk::Row *row=chunk->rows;  
                 for(size_t i=0; i<chunk->count; i++, row++) {  
                         if(row==append_here)  
                                 goto break2;  
   
                         char *new_cstr=(char *)pool.malloc(row->item.size);  
                         char *dest=new_cstr;  
                         const char *src=row->item.ptr;   
                         for(int size=row->item.size; size--; src++) {  
                                 unsigned char c=a[(unsigned char)*src];  
                                 if(b)  
                                         c=b[c];  
   
                                 *dest++=(char)c;          char* new_cstr=cstrm();
                         }  
                                   if(source_charset.isUTF8()) {
                         result.APPEND(new_cstr, row->item.size,                   size_t new_cstr_len=length();
                                 row->item.lang,                  switch(kind) {
                                 row->item.origin.file, row->item.origin.line);                  case CC_UPPER:
                 }                          change_case_UTF8((const XMLByte*)new_cstr, new_cstr_len, (XMLByte*)new_cstr, new_cstr_len, UTF8CaseToUpper);
                 chunk=row->link;                          break;
         } while(chunk);                  case CC_LOWER:
 break2:                          change_case_UTF8((const XMLByte*)new_cstr, new_cstr_len, (XMLByte*)new_cstr, new_cstr_len, UTF8CaseToLower);
                           break;
                   default:
                           assert(!"unknown change case kind");
                           break; // never
                   }       
                   
           } else {
                   const unsigned char *tables=source_charset.pcre_tables;
   
                   const unsigned char *a;
                   const unsigned char *b;
                   switch(kind) {
                   case CC_UPPER:
                           a=tables+lcc_offset;
                           b=tables+fcc_offset;
                           break;
                   case CC_LOWER:
                           a=tables+lcc_offset;
                           b=0;
                           break;
                   default:
                           assert(!"unknown change case kind");
                           a=b=0; // calm, compiler
                           break; // never
                   }       
   
                   char *dest=new_cstr;
                   unsigned char index;
                   for(const char* current=new_cstr; (index=(unsigned char)*current); current++) {
                           unsigned char c=a[index];
                           if(b)
                                   c=b[c];
   
                           *dest++=(char)c;
                   }
           }
           result.langs=langs;
           result.body=new_cstr;
   
         return result;          return result;
 }  }
   
 void String::join_chain(Pool& pool,   const String& String::escape(Charset& source_charset) const {
                                            size_t& ai, const Chunk*& achunk, const Chunk::Row*& arow,          if(is_empty())
                                            Untaint_lang& joined_lang, const char *& joined_ptr, size_t& joined_size) const {                  return *this;
         joined_lang=arow->item.lang;  
                   return Charset::escape(*this, source_charset);
         // calc size  }
         joined_size=0;  
         {  #define STRING_APPEND(result, from_cstr, langs, langs_offset, length) \
                 size_t start_i=ai;                          result.langs.append(result.body, langs, langs_offset, length); \
                 const Chunk::Row *start_row=arow;                          result.body.append_strdup_know_length(from_cstr, length);
                 const Chunk *chunk=achunk;  
                 do {  const String& String::replace(const Dictionary& dict) const {
                         const Chunk::Row *row=start_row;          if(!dict.count() || is_empty())
                         for(size_t i=start_i; i<chunk->count; i++, row++) {                  return *this;
                                 if(row==append_here)  
                                         goto break21;          String& result=*new String();
                                           const char* old_cstr=cstr();
                                 if(row->item.lang==joined_lang)          const char* prematch_begin=old_cstr;
                                         joined_size+=row->item.size;  
                                 else          if(dict.count()==1) {
                                         break;                  // optimized simple case
   
                   Dictionary::Subst subst=dict.get(0);
                   while(const char* p=strstr(prematch_begin, subst.from)) {
                           // prematch
                           if(size_t prematch_length=p-prematch_begin) {
                                   STRING_APPEND(result, prematch_begin, langs, prematch_begin-old_cstr, prematch_length)
                         }                          }
                         if(chunk=row->link) {  
                                 start_i=0;  
                                 start_row=chunk->rows;  
                         } else  
                                 break;  
                 } while(true);  
 break21:;  
         }  
   
         // if one row, return simply itself                          // match
         if(joined_size==arow->item.size) {                          prematch_begin=p+subst.from_length;
                 joined_ptr=arow->item.ptr;  
                 ai++; arow++;                          if(const String* b=subst.to) // are there any b?
                 if(ai==achunk->count)                                  result<<*b;
                         achunk=arow->link;                                }
   
         } else {          } else {
                 // join adjacent rows  
                 char *ptr=(char *)pool.malloc(joined_size);                  const char* current=old_cstr;
                 joined_ptr=ptr;                  while(*current) {
                 size_t start_i=ai;                          if(Dictionary::Subst subst=dict.first_that_begins(current)) {
                 const Chunk::Row *start_row=arow;                                  // prematch
                 const Chunk *chunk=achunk;                                  if(size_t prematch_length=current-prematch_begin) {
                 size_t i;                                          STRING_APPEND(result, prematch_begin, langs, prematch_begin-old_cstr, prematch_length)
                 const Chunk::Row *row;                                  }
                 do {  
                         row=start_row;                                  // match
                         for(i=start_i; i<chunk->count; i++, row++) {                                  // skip 'a' in 'current'; move prematch_begin
                                 if(row==append_here)                                  current+=subst.from_length; prematch_begin=current;
                                         goto break22;  
                                                                   if(const String* b=subst.to) // are there any b?
                                 if(row->item.lang==joined_lang) {                                          result<<*b;
                                         memcpy(ptr, row->item.ptr, row->item.size);                          } else // simply advance
                                         ptr+=row->item.size;                                  current++; 
                                 } else                  }
                                         break;  
                         }          }
                         if(chunk=row->link) {  
                                 start_i=0;          if(prematch_begin==old_cstr) // not modified
                                 start_row=chunk->rows;                  return *this;
                         } else  
                                 break;          // postmatch
                 } while(true);          if(size_t postmatch_length=old_cstr+length()-prematch_begin) {
 break22:;                  STRING_APPEND(result, prematch_begin, langs, prematch_begin-old_cstr, postmatch_length)
                   
                 // return joined rows  
                 ai=i;  
                 arow=row;  
                 achunk=chunk;  
         }          }
   
           ASSERT_STRING_INVARIANT(result);
           return result;
 }  }
   
 String& String::reconstruct(Pool& pool) const {  static int serialize_body_char(char c, char** cur) {
         //_asm int 3;          *((*cur)++)=c;
         String& result=*new(pool) String(pool);          return 0; // 0=continue
         const Chunk *chunk=&head;   }
         do {  
                 const Chunk::Row *row=chunk->rows;  static int serialize_body_piece(const char* s, char** cur) {
                 for(size_t i=0; i<chunk->count; ) {          size_t length=strlen(s);
                         if(row==append_here)          memcpy(*cur, s, length);  *cur+=length;
                                 goto break2;          return 0; // 0=continue
   }
                         Untaint_lang joined_lang;  
                         const char *joined_ptr;  static int serialize_lang_piece(char alang, size_t asize, char** cur) {
                         size_t joined_size;          // lang
                         join_chain(pool, i, chunk, row,          **cur=alang; (*cur)++;
                                 joined_lang, joined_ptr, joined_size);          // length [WARNING: not cast, addresses must be %4=0 on sparc]
           memcpy(*cur, &asize, sizeof(asize));  *cur+=sizeof(asize);
                         result.APPEND(joined_ptr, joined_size,   
                                 joined_lang,          return 0; // 0=continue
                                 row->item.origin.file, row->item.origin.line);  }
                         if(!chunk)  
                                 goto break2;  String::Cm String::serialize(size_t prolog_length) const {
                 }          size_t fragments_count=langs.count();
         } while(true);          size_t body_length=body.length();
 break2:          size_t buf_length=
                   prolog_length //1
                   +sizeof(size_t) //2
                   +body_length //3
                   +1 // 4 for zero terminator used in deserialize
                   +sizeof(size_t) //5
                   +fragments_count*(sizeof(char)+sizeof(size_t)); //6
   
           String::Cm result(new(PointerFreeGC) char[buf_length], buf_length);
   
           // 1: prolog
           char *cur=result.str+prolog_length;
           // 2: chars.count [WARNING: not cast, addresses must be %4=0 on sparc]
           memcpy(cur, &body_length, sizeof(body_length));  cur+=sizeof(body_length);
           // 3: letters
           body.for_each(serialize_body_char, serialize_body_piece, &cur);
           // 4: zero terminator
           *cur++=0;
           // 5: langs.count [WARNING: not cast, addresses must be %4=0 on sparc]
           memcpy(cur, &fragments_count, sizeof(fragments_count));  cur+=sizeof(fragments_count);
           // 6: lang info
           langs.for_each(body, serialize_lang_piece, &cur);
   
         return result;          return result;
 };  }
   
 String& String::replace_in_reconstructed(Pool& pool, Dictionary& dict) const {  bool String::deserialize(size_t prolog_size, void *buf, size_t buf_size) {
         //_asm int 3;          size_t in_buf=buf_size;
         String& result=*new(pool) String(pool);          if(in_buf<=prolog_size)
         const Chunk *chunk=&head;                   return false;
         do {          in_buf-=prolog_size;
                 const Chunk::Row *row=chunk->rows;  
                 for(size_t i=0; i<chunk->count; i++, row++) {          // 1: prolog
                         if(row==append_here)          const char* cur=(const char* )buf+prolog_size;
                                 goto break2;  
           // 2: chars.count
                         const char *src=row->item.ptr;           size_t body_length;
                         size_t src_size=row->item.size;          if(in_buf<sizeof(body_length)) // body.length don't fit?
                         char *new_cstr=(char *)pool.malloc((size_t)ceil(src_size*dict.max_ratio()));                  return false;
                         char *dest=new_cstr;          // [WARNING: not cast, addresses must be %4=0 on sparc]
                         while(src_size) {          memcpy(&body_length, cur, sizeof(body_length));  cur+=sizeof(body_length);
                                 // there is a row where first column starts 'src'          in_buf-=sizeof(body_length);
                                 if(Table::Item *item=dict.first_that_starts(src, src_size)) {  
                                         // get a=>b values          if(in_buf<body_length+1) // letters+terminator don't fit?
                                         const String& a=*static_cast<Array *>(item)->get_string(0);                  return false;
                                         const String& b=*static_cast<Array *>(item)->get_string(1);          // 4: zero terminator
                                         // skip 'a' in 'src' && reduce work size          if(cur[body_length] != 0) // in place?
                                         src+=a.size();  src_size-=a.size();                  return false;
                                         // write 'b' to 'dest' && skip 'b' in 'dest'          // 3: letters
                                         b.store_to(dest);  dest+=b.size();          body=String::Body(*cur?cur:0);
                                 } else {  #ifdef STRING_LENGTH_CACHING
                                         // write a char to b && reduce work size          body.set_length(body_length);
                                         *dest++=*src++;  src_size--;  #endif
                                 }          cur+=body_length+1;
                         }          in_buf-=body_length+1;
   
                         result.APPEND(new_cstr, dest-new_cstr,           // 5: langs.count
                                 row->item.lang,          size_t fragments_count;
                                 row->item.origin.file, row->item.origin.line);          if(in_buf<sizeof(fragments_count)) // langs.count don't fit?
                   return false;
           // [WARNING: not cast, addresses must be %4=0 on sparc]
           memcpy(&fragments_count, cur, sizeof(fragments_count));  cur+=sizeof(fragments_count);
           in_buf-=sizeof(fragments_count);
           
           if(fragments_count) {
                   // 6: lang info
                   size_t total_length=0;
                   for(size_t f=0; f<fragments_count; f++) {
                           char lang;
                           size_t fragment_length;
                           size_t piece_length=sizeof(lang)+sizeof(fragment_length);
                           if(in_buf<piece_length) // lang+length
                                   return false;
   
                           // lang
                           lang=*cur++;
                           // length [WARNING: not cast, addresses must be %4=0 on sparc]
                           memcpy(&fragment_length, cur, sizeof(fragment_length));  cur+=sizeof(fragment_length);
   
                           size_t combined_length=total_length+fragment_length;
                           if(combined_length>body_length)
                                   return false; // file curruption
                           // uchar needed to prevent propagating 0x80 bit to upper bytes
                           langs.append(total_length, (String::Language)(uchar)lang, fragment_length);
                           total_length=combined_length;
                           in_buf-=piece_length;
                 }                  }
                 chunk=row->link;  
         } while(chunk);  
   
 break2:                  if(total_length!=body_length) // length(all language fragments) vs length(letters)
         return result;                          return false;
           }
           if(in_buf!=0) // some strange extra bytes
                   return false;
   
           ASSERT_STRING_INVARIANT(*this);
           return true;
 }  }
   
 String& String::replace(Pool& pool, Dictionary& dict) const {  const char* String::Body::v() const {
         return reconstruct(pool).replace_in_reconstructed(pool, dict);          return CORD_to_const_char_star(body, length());
 }  }
   
 double String::as_double() const {   void String::Body::dump() const {
         double result;          CORD_dump(body);
         const char *cstr=this->cstr();  }
         char *error_pos;  
         // 0xABC  const char* String::Languages::v() const {
         if(cstr[0]=='0')          if(opt.is_not_just_lang)
                 if(cstr[1]=='x' || cstr[1]=='X')                  return CORD_to_const_char_star(langs, 0);
                         result=(double)(unsigned long)strtol(cstr, &error_pos, 0);  
                 else  
                         result=(double)strtod(cstr+1/*skip leading 0*/, &error_pos);  
         else          else
                 result=(double)strtod(cstr, &error_pos);                  return (const char*)&langs;
   }
   
         if(*error_pos/*not EOS*/)  void String::Languages::dump() const {
                 THROW(0, 0,          if(opt.is_not_just_lang)
                         this,                  CORD_dump(langs);
                         "invalid number (double)");          else
                   puts((const char*)&langs);
   }
   
         return result;  const char* String::v() const {
           const uint LIMIT_VIEW=20;
           char* buf=(char*)pa_malloc(MAX_STRING);
           const char*body_view=body.v();
           const char*langs_view=langs.v();
           snprintf(buf, MAX_STRING, 
                   "%d:%.*s%s}   "
                   "{%d:%s",
                   langs.count(), LIMIT_VIEW, langs_view, strlen(langs_view)>LIMIT_VIEW?"...":"",
                   strlen(body_view), body_view
           );
   
           return buf;
 }  }
 int String::as_int() const {   
         int result;  
         const char *cstr=this->cstr();  
         char *error_pos;  
         // 0xABC  
         if(cstr[0]=='0')  
                 if(cstr[1]=='x' || cstr[1]=='X')  
                         result=(int)(unsigned long)strtol(cstr, &error_pos, 0);  
                 else  
                         result=(int)strtol(cstr+1/*skip leading 0*/, &error_pos, 0);  
         else  
                 result=(int)strtol(cstr, &error_pos, 0);  
   
         if(*error_pos/*not EOS*/)  void String::dump() const {
                 THROW(0, 0,          body.dump();
                         this,          langs.dump();
                         "invalid number (int)");  }
   
   const String& String::trim(String::Trim_kind kind, const char* chars, Charset* source_charset) const {
           if(is_empty())
                   return *this;
   
           size_t substr_begin, substr_length;
           Body new_body=body.trim(kind, chars, &substr_begin, &substr_length, source_charset);
           if(new_body==body) // we received unchanged pointer, do likewise
                   return *this;
           // new_body differs from body, adjust langs along
   
           String& result=*new String;
           if(!new_body) // body.trim produced empty result
                   return result;
           // body.trim produced nonempty result
   
           // first: their langs
           result.langs.append(result.body, langs, substr_begin, substr_length);
           // next: letters themselves
           result.body=new_body;
   
           ASSERT_STRING_INVARIANT(result);
         return result;          return result;
 }  }

Removed from v.1.111  
changed lines
  Added in v.1.250


E-mail: