CharsetEncoder 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 de caractères Unicode de seize bits en une séquence d’octets dans un ensemble de caractères spécifique.
[Android.Runtime.Register("java/nio/charset/CharsetEncoder", DoNotGenerateAcw=true)]
public abstract class CharsetEncoder : Java.Lang.Object[<Android.Runtime.Register("java/nio/charset/CharsetEncoder", DoNotGenerateAcw=true)>]
type CharsetEncoder = class
inherit Object- Héritage
- Attributs
Remarques
Moteur qui peut transformer une séquence de caractères Unicode de seize bits en une séquence d’octets dans un ensemble de caractères spécifique.
« étapes »>
La séquence de caractères d’entrée est fournie dans une mémoire tampon de caractères ou une série de ces mémoires tampons. La séquence d’octets de sortie est écrite dans une mémoire tampon d’octets ou une série de ces mémoires tampons. Un encodeur doit toujours être utilisé en effectuant la séquence d’appels de méthode suivante, appelée ci-après opération d’encodage :
<ol>
<li>
Réinitialisez l’encodeur via la #reset reset méthode, sauf s’il n’a pas été utilisé précédemment ;
</li>
<li>
Appelez la #encode encode 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 #encode encode méthode une dernière fois, en passant true pour l’argument endOfInput , puis
</li>
<li>
Appelez la #flush flush méthode pour que l’encodeur puisse vider n’importe quel état interne dans la mémoire tampon de sortie.
</li>
</ol>
Chaque appel de la #encode encode méthode encodera autant de caractères que possible à partir de la mémoire tampon d’entrée, en écrivant les octets résultants dans la mémoire tampon de sortie. La #encode encode 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 d’encodage 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 d’encodage, le cas échéant, puis réessayer.
« ce »>
Il existe deux types généraux d’erreurs d’encodage. Si la séquence de caractères d’entrée n’est pas une séquence Unicode de seize bits légale, l’entrée est considérée comme incorrecte. Si la séquence de caractères d’entrée est légale, mais ne peut pas être mappée à une séquence d’octets valide dans l’ensemble de caractères donné, un caractère inappable a été rencontré.
« cae »>
La façon dont une erreur d’encodage 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 du tableau d’octets de remplacement. Remplacement
est initialement défini sur le remplacement par défaut de l’encodeur, qui a souvent (mais pas toujours) la valeur initiale ;{ ;(byte)'?' ;};
sa valeur peut être modifiée via la #replaceWith(byte[]) 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 d’encodage, notamment l’implémentation d’actions d’erreur. Un encodeur pour un ensemble de caractères spécifique, qui est une sous-classe concrète de cette classe, n’a besoin que d’implémenter la méthode abstraite #encodeLoop encodeLoop , qui encapsule la boucle d’encodage 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.CharsetEncoder.
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 |
|---|---|
| CharsetEncoder(Charset, Single, Single, Byte[]) |
Initialise un nouvel encodeur. |
| CharsetEncoder(Charset, Single, Single) |
Initialise un nouvel encodeur. |
| CharsetEncoder(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) |
| 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 de caractères Unicode de seize bits en une séquence d’octets dans un ensemble de caractères spécifique. (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 |
|---|---|
| AverageBytesPerChar() |
Retourne le nombre moyen d’octets générés pour chaque caractère d’entrée. |
| CanEncode(Char) |
Indique si cet encodeur peut encoder ou non le caractère donné. |
| CanEncode(ICharSequence) |
Indique si cet encodeur peut encoder ou non la séquence de caractères donnée. |
| CanEncode(String) |
Indique si cet encodeur peut encoder ou non la séquence de caractères donnée. |
| Charset() |
Retourne l’ensemble de caractères qui a créé cet encodeur. |
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Moteur qui peut transformer une séquence de caractères Unicode de seize bits en une séquence d’octets dans un ensemble de caractères spécifique. (Hérité de JavaObject) |
| 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 de caractères Unicode de seize bits en une séquence d’octets dans un ensemble de caractères spécifique. (Hérité de JavaObject) |
| Encode(CharBuffer, ByteBuffer, Boolean) |
Encode autant de caractères 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. |
| Encode(CharBuffer) |
Méthode pratique qui encode le contenu restant d’une mémoire tampon de caractères d’entrée unique dans une mémoire tampon d’octet nouvellement allouée. |
| EncodeLoop(CharBuffer, ByteBuffer) |
Encode un ou plusieurs caractères en un ou plusieurs octets. |
| Equals(Object) |
Moteur qui peut transformer une séquence de caractères Unicode de seize bits en une séquence d’octets dans un ensemble de caractères spécifique. (Hérité de JavaObject) |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| Flush(ByteBuffer) |
Vide cet encodeur. |
| GetHashCode() |
Retourne une valeur de code de hachage pour l'objet. (Hérité de Object) |
| ImplFlush(ByteBuffer) |
Vide cet encodeur. |
| ImplOnMalformedInput(CodingErrorAction) |
Signale une modification de l’action d’entrée incorrecte de cet encodeur. |
| ImplOnUnmappableCharacter(CodingErrorAction) |
Signale une modification de l’action caractère non modifiable de cet encodeur. |
| ImplReplaceWith(Byte[]) |
Signale une modification de la valeur de remplacement de cet encodeur. |
| ImplReset() |
Réinitialise cet encodeur, en désactivant tout état interne spécifique à un jeu de caractères. |
| IsLegalReplacement(Byte[]) |
Indique si le tableau d’octets donné est une valeur de remplacement légale pour cet encodeur. |
| 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 cet encodeur pour les erreurs d’entrée incorrecte. |
| MaxBytesPerChar() |
Retourne le nombre maximal d’octets générés pour chaque caractère 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 cet encodeur pour les erreurs d’entrée incorrectes. |
| OnUnmappableCharacter(CodingErrorAction) |
Modifie l’action de cet encodeur pour les erreurs de caractères non modifiables. |
| Replacement() |
Retourne la valeur de remplacement de cet encodeur. |
| ReplaceWith(Byte[]) |
Modifie la valeur de remplacement de cet encodeur. |
| Reset() |
Réinitialise cet encodeur, 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 de caractères Unicode de seize bits en une séquence d’octets dans un ensemble de caractères spécifique. (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 de chaîne de l'objet. (Hérité de Object) |
| UnmappableCharacterAction() |
Retourne l’action actuelle de cet encodeur pour les erreurs de caractère inappable. |
| 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 de caractères Unicode de seize bits en une séquence d’octets dans un ensemble de caractères spécifique. (Hérité de JavaObject) |
| IJavaPeerable.Finalized() |
Moteur qui peut transformer une séquence de caractères Unicode de seize bits en une séquence d’octets dans un ensemble de caractères spécifique. (Hérité de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Moteur qui peut transformer une séquence de caractères Unicode de seize bits en une séquence d’octets dans un ensemble de caractères spécifique. (Hérité de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Moteur qui peut transformer une séquence de caractères Unicode de seize bits en une séquence d’octets dans un ensemble de caractères spécifique. (Hérité de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Moteur qui peut transformer une séquence de caractères Unicode de seize bits en une séquence d’octets dans un ensemble de caractères spécifique. (Hérité de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Moteur qui peut transformer une séquence de caractères Unicode de seize bits en une séquence d’octets dans un ensemble de caractères spécifique. (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 de caractères Unicode de seize bits en une séquence d’octets dans un ensemble de caractères spécifique. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |