CharsetDecoder Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Moteur qui peut transformer une séquence d’octets dans un jeu de caractères spécifique en une séquence de caractères Unicode de seize bits.
[Android.Runtime.Register("java/nio/charset/CharsetDecoder", DoNotGenerateAcw=true)]
public abstract class CharsetDecoder : Java.Lang.Object[<Android.Runtime.Register("java/nio/charset/CharsetDecoder", DoNotGenerateAcw=true)>]
type CharsetDecoder = class
inherit Object- Héritage
- Attributs
Remarques
Moteur qui peut transformer une séquence d’octets dans un jeu de caractères spécifique en une séquence de caractères Unicode de seize bits.
« étapes »>
La séquence d’octets d’entrée est fournie dans une mémoire tampon d’octets ou une série de ces mémoires tampons. La séquence de caractères de sortie est écrite dans une mémoire tampon de caractères ou une série de ces mémoires tampons. Un décodeur doit toujours être utilisé en effectuant la séquence d’appels de méthode suivante, appelée ci-après opération de décodage :
<ol>
<li>
Réinitialisez le décodeur via la #reset reset méthode, sauf s’il n’a pas été utilisé précédemment ;
</li>
<li>
Appelez la #decode decode méthode zéro ou plus de fois, tant que l’entrée supplémentaire peut être disponible, en passant false l’argument endOfInput et en remplissant la mémoire tampon d’entrée et en vidant la mémoire tampon de sortie entre les appels ;
</li>
<li>
Appelez la #decode decode méthode une dernière fois, en passant true pour l’argument endOfInput , puis
</li>
<li>
Appelez la #flush flush méthode pour que le décodeur puisse vider n’importe quel état interne dans la mémoire tampon de sortie.
</li>
</ol>
Chaque appel de la #decode decode méthode décode autant d’octets que possible à partir de la mémoire tampon d’entrée, en écrivant les caractères résultants dans la mémoire tampon de sortie. La #decode decode méthode retourne quand une entrée supplémentaire est requise, lorsqu’il n’y a pas suffisamment de place dans la mémoire tampon de sortie, ou lorsqu’une erreur de décodage s’est produite. Dans chaque cas, un CoderResult objet est retourné pour décrire la raison de l’arrêt. Un appelant peut examiner cet objet et remplir la mémoire tampon d’entrée, vider la mémoire tampon de sortie ou tenter de récupérer à partir d’une erreur de décodage, le cas échéant, puis réessayer.
« ce »>
Il existe deux types généraux d’erreurs de décodage. Si la séquence d’octets d’entrée n’est pas légale pour ce jeu de caractères, l’entrée est considérée comme incorrecte. Si la séquence d’octets d’entrée est légale, mais ne peut pas être mappée à un caractère Unicode valide, un caractère inappable a été rencontré.
« cae »>
La façon dont une erreur de décodage est gérée dépend de l’action demandée pour ce type d’erreur, qui est décrite par une instance de la CodingErrorAction classe. Les actions d’erreur possibles sont de CodeErrorAction#IGNORER l’entrée erronée, CodingErrorAction#REPORT signalent l’erreur à l’appelant via l’objet retourné CoderResult ou CodingErrorAction#REPLACE remplacent l’entrée erronée par la valeur actuelle de la chaîne de remplacement. Remplacement
a la valeur "\uFFFD"initiale ;
sa valeur peut être modifiée via la #replaceWith(java.lang.String) replaceWith méthode.
L’action par défaut pour les erreurs d’entrée incorrecte et de caractère non modifiable est de les signaler à CodingErrorAction#REPORT. L’action d’erreur d’entrée incorrecte peut être modifiée par le biais de la #onMalformedInput(CodingErrorAction) onMalformedInput méthode ; l’action unmappable-character peut être modifiée via la #onUnmappableCharacter(CodingErrorAction) onUnmappableCharacter méthode.
Cette classe est conçue pour gérer la plupart des détails du processus de décodage, notamment l’implémentation d’actions d’erreur. Un décodeur pour un charset spécifique, qui est une sous-classe concrète de cette classe, n’a besoin que d’implémenter la méthode abstraite #decodeLoop decodeLoop , qui encapsule la boucle de décodage de base. Une sous-classe qui gère l’état interne doit également remplacer les méthodes et #implFlush implFlush les #implReset implReset méthodes.
Les instances de cette classe ne sont pas sécurisées pour une utilisation par plusieurs threads simultanés.
Ajouté dans la version 1.4.
Documentation Java pour java.nio.charset.CharsetDecoder.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.
Constructeurs
| Nom | Description |
|---|---|
| CharsetDecoder(Charset, Single, Single) |
Initialise un nouveau décodeur. |
| CharsetDecoder(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
Propriétés
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| IsAutoDetecting |
Indique si ce décodeur implémente ou non un charset de détection automatique. |
| IsCharsetDetected |
Indique si ce décodeur a encore détecté un charset ; ; (opération facultative). |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| JniManagedPeerState |
Moteur qui peut transformer une séquence d’octets dans un jeu de caractères spécifique en une séquence de caractères Unicode de seize bits. (Hérité de JavaObject) |
| JniPeerMembers |
Obtient les métadonnées JNI utilisées pour appeler les membres de cet homologue Java. |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
Méthodes
| Nom | Description |
|---|---|
| AverageCharsPerByte() |
Retourne le nombre moyen de caractères générés pour chaque octet d’entrée. |
| Charset() |
Retourne l’ensemble de caractères qui a créé ce décodeur. |
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Moteur qui peut transformer une séquence d’octets dans un jeu de caractères spécifique en une séquence de caractères Unicode de seize bits. (Hérité de JavaObject) |
| Decode(ByteBuffer, CharBuffer, Boolean) |
Décode autant d’octets que possible à partir de la mémoire tampon d’entrée donnée, en écrivant les résultats dans la mémoire tampon de sortie donnée. |
| Decode(ByteBuffer) |
Méthode pratique qui décode le contenu restant d’une mémoire tampon d’octet d’entrée unique dans une mémoire tampon de caractères nouvellement allouée. |
| DecodeLoop(ByteBuffer, CharBuffer) |
Décode un ou plusieurs octets en un ou plusieurs caractères. |
| DetectedCharset() |
Récupère l’ensemble de caractères détecté par ce décodeur ; ; (opération facultative). |
| Dispose() |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| Dispose(Boolean) |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| DisposeUnlessReferenced() |
Moteur qui peut transformer une séquence d’octets dans un jeu de caractères spécifique en une séquence de caractères Unicode de seize bits. (Hérité de JavaObject) |
| Equals(Object) |
Moteur qui peut transformer une séquence d’octets dans un jeu de caractères spécifique en une séquence de caractères Unicode de seize bits. (Hérité de JavaObject) |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| Flush(CharBuffer) |
Vide ce décodeur. |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| ImplFlush(CharBuffer) |
Vide ce décodeur. |
| ImplOnMalformedInput(CodingErrorAction) |
Signale une modification de l’action d’entrée incorrecte de ce décodeur. |
| ImplOnUnmappableCharacter(CodingErrorAction) |
Signale une modification de l’action unmappable-character de ce décodeur. |
| ImplReplaceWith(String) |
Signale une modification de la valeur de remplacement de ce décodeur. |
| ImplReset() |
Réinitialise ce décodeur, en désactivant tout état interne spécifique à l’ensemble de caractères. |
| JavaFinalize() |
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
| MalformedInputAction() |
Retourne l’action actuelle de ce décodeur pour les erreurs d’entrée incorrecte. |
| MaxCharsPerByte() |
Retourne le nombre maximal de caractères qui seront générés pour chaque octet d’entrée. |
| Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
| NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
| OnMalformedInput(CodingErrorAction) |
Modifie l’action de ce décodeur pour les erreurs d’entrée incorrectes. |
| OnUnmappableCharacter(CodingErrorAction) |
Modifie l’action de ce décodeur pour les erreurs de caractère non modifiables. |
| Replacement() |
Retourne la valeur de remplacement de ce décodeur. |
| ReplaceWith(String) |
Modifie la valeur de remplacement de ce décodeur. |
| Reset() |
Réinitialise ce décodeur, en désactivant tout état interne. |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Moteur qui peut transformer une séquence d’octets dans un jeu de caractères spécifique en une séquence de caractères Unicode de seize bits. (Hérité de JavaObject) |
| ToArray<T>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToString() |
Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object) |
| UnmappableCharacterAction() |
Retourne l’action actuelle de ce décodeur pour les erreurs de caractère non modifiable. |
| UnregisterFromRuntime() |
Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object) |
| Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
| Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IJavaPeerable.Disposed() |
Moteur qui peut transformer une séquence d’octets dans un jeu de caractères spécifique en une séquence de caractères Unicode de seize bits. (Hérité de JavaObject) |
| IJavaPeerable.Finalized() |
Moteur qui peut transformer une séquence d’octets dans un jeu de caractères spécifique en une séquence de caractères Unicode de seize bits. (Hérité de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Moteur qui peut transformer une séquence d’octets dans un jeu de caractères spécifique en une séquence de caractères Unicode de seize bits. (Hérité de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Moteur qui peut transformer une séquence d’octets dans un jeu de caractères spécifique en une séquence de caractères Unicode de seize bits. (Hérité de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Moteur qui peut transformer une séquence d’octets dans un jeu de caractères spécifique en une séquence de caractères Unicode de seize bits. (Hérité de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Moteur qui peut transformer une séquence d’octets dans un jeu de caractères spécifique en une séquence de caractères Unicode de seize bits. (Hérité de JavaObject) |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Moteur qui peut transformer une séquence d’octets dans un jeu de caractères spécifique en une séquence de caractères Unicode de seize bits. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |