Annotation of parser3/src/include/pa_charset.h, revision 1.60

1.1       paf         1: /** @file
                      2:        Parser: Charset connection decl.
                      3: 
1.59      moko        4:        Copyright (c) 2001-2024 Art. Lebedev Studio (http://www.artlebedev.com)
1.57      moko        5:        Authors: Konstantin Morshnev <moko@design.ru>, Alexandr Petrosian <paf@design.ru>
1.1       paf         6: */
                      7: 
                      8: #ifndef PA_CHARSET_H
                      9: #define PA_CHARSET_H
1.17      paf        10: 
1.60    ! moko       11: #define IDENT_PA_CHARSET_H "$Id: pa_charset.h,v 1.59 2024/11/04 03:53:25 moko Exp $"
1.23      paf        12: 
1.1       paf        13: 
                     14: #include "pa_exception.h"
                     15: #include "pa_common.h"
1.23      paf        16: #include "pa_hash.h"
                     17: #include "pa_array.h"
1.1       paf        18: 
1.58      moko       19: #ifdef HAVE_PCRE2
                     20: #include <pcre2.h>
                     21: #else
                     22: #include <pcre.h>
                     23: #endif
1.51      moko       24: // we are using some pcre_internal.h stuff as well
                     25: #include "../lib/pcre/pa_pcre_internal.h"
1.1       paf        26: 
1.3       paf        27: #ifdef XML
1.60    ! moko       28: #include "libxml/xmlstring.h"
1.3       paf        29: #include "libxml/encoding.h"
                     30: #endif
                     31: 
1.1       paf        32: // defines
                     33: 
1.23      paf        34: #define MAX_CHARSETS 10
                     35: 
                     36: #define MAX_CHARSET_UNI_CODES 500
                     37: 
1.41      misha      38: #ifndef XMLCh 
                     39:        typedef unsigned int XMLCh;
                     40: #endif
                     41: #ifndef XMLByte
                     42:        typedef unsigned char XMLByte;
                     43: #endif
1.3       paf        44: 
1.23      paf        45: // helpers
                     46: 
1.42      misha      47: typedef HashString<String::Body> HashStringString;
1.23      paf        48: 
1.1       paf        49: /**    charset holds name & transcode tables 
1.23      paf        50:        registers libxml transcoders
1.1       paf        51: */
1.23      paf        52: class Charset: public PA_Object {
1.1       paf        53: public:
                     54: 
1.24      paf        55:        Charset(Request_charsets* charsets, const String::Body ANAME, const String* afile_spec);
1.1       paf        56:        
1.24      paf        57:        const String::Body NAME() const { return FNAME; }
1.30      paf        58:        const char* NAME_CSTR() const { return FNAME_CSTR; }
1.1       paf        59: 
                     60:        bool isUTF8() const { return fisUTF8; }
                     61: 
1.53      moko       62:        static String::C transcode(const String::C src, const Charset& source_charset, const Charset& dest_charset);
                     63:        static String::Body transcode(const String::Body src, const Charset& source_transcoder, const Charset& dest_transcoder);
                     64:        static String& transcode(const String& src, const Charset& source_transcoder, const Charset& dest_transcoder);
                     65:        static void transcode(ArrayString& src, const Charset& source_transcoder, const Charset& dest_transcoder);
                     66:        static void transcode(HashStringString& src, const Charset& source_transcoder, const Charset& dest_transcoder);
                     67: 
                     68:        static String::C escape(const String::C src, const Charset& source_charset);
                     69:        static String::Body escape(const String::Body src, const Charset& source_charset);
                     70:        static String& escape(const String& src, const Charset& source_charset);
                     71: 
                     72:        static String::C escape_JSON(const String::C src, const Charset& source_charset);
                     73:        static String::Body escape_JSON(const String::Body src, const Charset& source_charset);
                     74:        static String& escape_JSON(const String& src, const Charset& source_charset);
1.38      misha      75: 
1.35      misha      76:        void store_Char(XMLByte*& outPtr, XMLCh src, XMLByte not_found);
1.33      misha      77: 
1.9       paf        78: #ifdef XML
1.24      paf        79:        xmlCharEncodingHandler& transcoder(const String::Body NAME);
1.9       paf        80: #endif
                     81: 
1.1       paf        82: public:
                     83: 
                     84:        unsigned char pcre_tables[tables_length];
                     85: 
                     86: private:
                     87: 
1.23      paf        88:        void load_definition(Request_charsets& charsets, const String& afile_spec);
1.1       paf        89:        void sort_ToTable();
                     90: 
1.23      paf        91:        const String::C transcodeToUTF8(const String::C src) const;
                     92:        const String::C transcodeFromUTF8(const String::C src) const;
                     93:        
                     94:        const String::C transcodeToCharset(const String::C src,
                     95:                const Charset& dest_transcoder) const;
1.1       paf        96: 
1.4       paf        97: public:
                     98: 
                     99:        struct Tables {
1.25      paf       100:                struct Rec {
                    101:                        XMLCh intCh;
                    102:                        XMLByte extCh;
                    103:                };
                    104: 
1.4       paf       105:                XMLCh fromTable[0x100];
1.25      paf       106:                Rec toTable[MAX_CHARSET_UNI_CODES];
1.4       paf       107:                uint toTableSize;
                    108:        };
                    109: 
1.25      paf       110:        struct UTF8CaseTable {
                    111:                struct Rec {
                    112:                        XMLCh from, to;
                    113:                };
                    114: 
                    115:                uint size;
                    116:                Rec* records;
                    117:        };
                    118: 
1.1       paf       119: private:
                    120: 
1.24      paf       121:        const String::Body FNAME;
1.23      paf       122:        char* FNAME_CSTR;
1.1       paf       123:        bool fisUTF8;
1.4       paf       124:        Tables tables;
1.1       paf       125: 
1.45      misha     126:        static size_t calc_escaped_length_UTF8(XMLByte* src, size_t src_length);
1.46      moko      127:        static size_t calc_escaped_length(const XMLByte* src, size_t src_length, const Charset::Tables& tables);
1.45      misha     128:        static size_t calc_escaped_length(const String::C src, const Charset& source_charset);
                    129:        static size_t escape_UTF8(const XMLByte* src, size_t src_length, XMLByte* dest);
                    130:        static size_t escape(const XMLByte* src, size_t src_length, XMLByte* dest, const Charset::Tables& tables);
                    131: 
                    132:        static size_t calc_JSON_escaped_length_UTF8(XMLByte* src, size_t src_length);
1.46      moko      133:        static size_t calc_JSON_escaped_length(const XMLByte* src, size_t src_length, const Charset::Tables& tables);
1.45      misha     134:        static size_t calc_JSON_escaped_length(const String::C src, const Charset& source_charset);
                    135:        static size_t escape_JSON_UTF8(const XMLByte* src, size_t src_length, XMLByte* dest);
                    136:        static size_t escape_JSON(const XMLByte* src, size_t src_length, XMLByte* dest, const Charset::Tables& tables);
                    137: 
1.47      misha     138: #ifdef XML
                    139: 
                    140: private:
                    141:        void addEncoding(char* name_cstr);
                    142:        void initTranscoder(const String::Body name, const char* name_cstr);
                    143: 
1.1       paf       144: public:
1.23      paf       145:        /// converts xmlChar* null-terminated string to char* 
1.32      paf       146:        String::C transcode_cstr(const xmlChar* s);
1.8       paf       147:        /// converts xmlChar* null-terminated string to parser String
1.32      paf       148:        const String& transcode(const xmlChar* s);
1.23      paf       149: 
                    150:        /** converts sized char*  to xmlChar*
                    151:                @returns xmlChar*  WHICH CALLER SHOULD FREE
1.16      paf       152:        */
1.23      paf       153:        xmlChar* transcode_buf2xchar(const char* buf, size_t buf_size);
1.32      paf       154:        /// converts parser String to xmlChar*
                    155:        xmlChar* transcode(const String& s);
                    156:        /// converts parser String::Body to xmlChar*
                    157:        xmlChar* transcode(const String::Body s);
1.1       paf       158: 
                    159: private:
                    160: 
1.23      paf       161:        xmlCharEncodingHandler* ftranscoder;
1.1       paf       162: 
                    163: #endif
                    164: 
1.5       paf       165: };
1.25      paf       166: 
                    167: 
                    168: // externs
                    169: 
                    170: extern Charset::UTF8CaseTable UTF8CaseToUpper;
                    171: extern Charset::UTF8CaseTable UTF8CaseToLower;
1.28      paf       172: void change_case_UTF8(const XMLByte* srcData, size_t srcLen,
1.43      misha     173:                                        XMLByte* toFill, size_t toFillLen,
                    174:                                        const Charset::UTF8CaseTable& table);
1.37      misha     175: size_t getUTF8BytePos(const XMLByte* srcBegin, const XMLByte* srcEnd, size_t charPos/*position in characters*/);
                    176: size_t getUTF8CharPos(const XMLByte* srcBegin, const XMLByte* srcEnd, size_t bytePos/*position in bytes*/);
                    177: size_t lengthUTF8(const XMLByte* srcBegin, const XMLByte* srcEnd);
1.44      misha     178: unsigned int lengthUTF8Char(const XMLByte c);
1.25      paf       179: 
1.52      moko      180: const char *fixUTF8(const char *src);
1.43      misha     181: 
                    182: class UTF8_string_iterator {
                    183:        public:
                    184:                UTF8_string_iterator(const String& astring): fsrcPtr((XMLByte*)astring.cstr()), fsrcEnd(fsrcPtr + astring.length()) {}
                    185:                UTF8_string_iterator(XMLByte* asrcPtr, size_t length): fsrcPtr(asrcPtr), fsrcEnd(fsrcPtr + length) {}
                    186: 
                    187:                bool has_next();
                    188:                XMLCh next() { return fUTF8Char; }
                    189:                XMLByte getFirstByte(){ return ffirstByte; }
                    190:                size_t getCharSize(){ return fcharSize; }
                    191:        private:
                    192:                const XMLByte* fsrcPtr;
                    193:                const XMLByte* fsrcEnd;
                    194:                size_t fcharSize;
                    195:                XMLByte ffirstByte;
                    196:                XMLCh fUTF8Char;
                    197: };
                    198: 
1.1       paf       199: #endif

E-mail: