Namespace EcmaScriptFile
Class CFileExtension

class CFileExtension {
public:
    CFileExtension(const XGlobalObject &pGlobalObject);
    ~CFileExtension();
public:
    void Register(
        const CString &strPropertyName,
        const XEncodingMap &pEncodingMap);
    };

The file extension package for the ECMAScript interpreter.

This class implements file extensions for ECMAScript interpreter as specified in Unicorn XML Processor Standard Edition Version 2.00.00 Reference Manual.

Every object of this class must be associated with an ECMAScript interpreter (an object of class EcmaScript::CInterpreter ). When a file extension package is constructed, the global object of the associated ECMAScript interpreter must be specified as an argument of the constructor. Once the CFileExtension object is constructed, its member function Register must be called in order to create the initial set of file extension objects in the object space of the associated ECMAScript interpreter.

Since:

1.00.00

Version:

1.00.00

Author:

Alexey Gokhberg

See Also:

Unicode::CEncodingMap, EcmaScript::CGlobalObject

CFileExtension

CFileExtension(const XGlobalObject &pGlobalObject);

Constructs the file extension package.

Parameters:

pGlobalObject - the ECMAScript global object. The ECMAScript interpreter which owns the specified global object will be associated with this extension package.

~CFileExtension

~CFileExtension();

Destroys the file extension package.

Register

void Register(
    const CString &strPropertyName,
    const XEncodingMap &pEncodingMap);

Registers this file extension package with the associated ECMAScript interpreter.

This function creates the initial set of file extension objects in the object space of the ECMAScript interpreter associated with this extension package.

The name of the ECMAScript global object property bound to the File constructor must be supplied as an argument of Register . Normally this name is "File" ; however, an application programmer may choose another name, if necessary.

Furthermore, a character encoding map must be supplied. This map is used to resolve names of character encodings applied to the contents of files.

Parameters:

strPropertyName - a string containing the name of the global object property to be bound to the File constructor

pEncodingMap - the character encoding map for resolving of character encoding names