nsICharsetResolver

by 2 contributors:

Please add a summary to this article.
Inherits from: nsISupports Last changed in Gecko 1.7

Method overview

void notifyResolvedCharset(in ACString charset, in nsISupports closure);
ACString requestCharset(in nsIWebNavigation aWebNavigation, in nsIChannel aChannel, out boolean aWantCharset, out nsISupports aClosure);

Methods

notifyResolvedCharset()

Some implementations may request that they be notified when the charset is actually detected.

void notifyResolvedCharset(
  in ACString charset,
  in nsISupports closure
);
Parameters
charset
The detected charset.
closure
The closure returned by requestCharset().

requestCharset()

Called to resolve the charset that should be used for parsing the document being loaded from aChannel.

If the charset cannot be resolved, but the implementation of nsICharsetResolver wants to be notified of the final resolved charset when one is available, it can set aWantCharset to true. If this is done, the caller of requestCharset is responsible for calling notifyResolvedCharset() and passing it the final resolved charset and the closure that requestCharset set.

ACString requestCharset(
  in nsIWebNavigation aWebNavigation,
  in nsIChannel aChannel,
  out boolean aWantCharset,
  out nsISupports aClosure
);
Parameters
aWebNavigation
The nsIWebNavigation the document is being loaded in. May be null.
aChannel
The channel the document is coming in from.
aWantCharset
Gets set to true if notifyResolvedCharset() should be called with the given aClosure object.
aClosure
A resulting object which should be passed to notifyResolvedCharset() if aWantCharset is set to true.
Return value

The resolved charset, or an empty string if no charset could be determined.

Document Tags and Contributors

Contributors to this page: Sheppy, trevorh
Last updated by: Sheppy,