Package Ctx

• Member Function Index
• Interface ErrorHandler (Interface one-line doc)
• Interface MemAllocator (Interface one-line doc)
• Interface TCtx (Interface one-line doc)

It is the root error handler class. It deals with local processing of errors, in particular in C implementation. It may throw XmlException in some implementations. But this is not specified in its signature in order to accomodate needs of all impementations. However, it can create exception objects. The error handler is passed to the TCtx constructor when TCtx is initialized. Implementations of this interface are provided by the user.

It is a simple root interface to make the TCtx interface reasonably generic so that different allocator approaches can be used in the future. It is passed to the TCtx constructor when Tctx is initialized. It is a low level allocator that does not know the type of an object being allocated. The allocators with this interface can also be used directly. In this case the user is responsible for the explicit deallocation of objects (with dealloc)

This is an implicit interface to XML context implementations. It is primarily used for memory allocation, error (not exception) handling, and different encodings handling. The context interface is an implicit interface that is supposed to be used as type parameter. The name TCtx will be used as a corresponding type parameter name. Its actuall substitutions are instantiations of implementations parameterized (templatized) by real context implementations. In the case of errors XmlException might be thrown.

All constructors create and initialize context implementations. In a multithreaded environment a separate context implementation has to be initialized for each thread.

If the MemAllocator interface is passed as a parameter to the TCtx constructor, than, in many cases, it makes sense to overwrite the operator new. In this case all memory allocations in both C and C++ can be done by the same allocator. This works like this:

Example

      void* operator new( ub4 sz, MemAllocator* memalloc)
      {...return memalloc->alloc( sz);...}
      ...
      (extern) MemAllocator* mem_alloc (= initialize actual allocator) ;
      ...
      TCtx* ctxp = new( mem_alloc) TCtx( name, errh, mem_alloc, (...));
      ...
      ctxp->~TCtx();
      mem_alloc->dealloc( ctxp);

createException

getMesLang

handleError

~ErrorHandler

alloc

dealloc

~MemAllocator

TCtx

TCtx

TCtx

getEncoding

getErrHandler

getMemAllocator

isSimple

isUnicode

~TCtx