CharsetDecoder Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Un motor que puede transformar una secuencia de bytes en un conjunto de caracteres específico en una secuencia de caracteres Unicode de dieciséis 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- Herencia
- Atributos
Comentarios
Un motor que puede transformar una secuencia de bytes en un conjunto de caracteres específico en una secuencia de caracteres Unicode de dieciséis bits.
"pasos">
La secuencia de bytes de entrada se proporciona en un búfer de bytes o en una serie de dichos búferes. La secuencia de caracteres de salida se escribe en un búfer de caracteres o en una serie de dichos búferes. Un descodificador siempre debe utilizarse realizando la siguiente secuencia de invocaciones de método, denominada en adelante una operación de descodificación:
<ol>
<li>
Restablezca el descodificador a través del #reset reset método , a menos que no se haya usado antes;
</li>
<li>
Invoque el #decode decode método cero o más veces, siempre que la entrada adicional esté disponible, pasando false para el endOfInput argumento y rellenando el búfer de entrada y vaciando el búfer de salida entre invocaciones;
</li>
<li>
Invoque el #decode decode método una vez final, pase true para el endOfInput argumento y, a continuación,
</li>
<li>
Invoque el #flush flush método para que el descodificador pueda vaciar cualquier estado interno en el búfer de salida.
</li>
</ol>
Cada invocación del #decode decode método descodificará tantos bytes como sea posible desde el búfer de entrada, escribiendo los caracteres resultantes en el búfer de salida. El #decode decode método devuelve cuando se requiere más entrada, cuando no hay suficiente espacio en el búfer de salida o cuando se ha producido un error de descodificación. En cada caso, se devuelve un CoderResult objeto para describir el motivo de la terminación. Un invocador puede examinar este objeto y rellenar el búfer de entrada, vaciar el búfer de salida o intentar recuperarse de un error de descodificación, según corresponda, e intentarlo de nuevo.
"ce">
Hay dos tipos generales de errores de descodificación. Si la secuencia de bytes de entrada no es legal para este conjunto de caracteres, la entrada se considera incorrecta. Si la secuencia de bytes de entrada es legal, pero no se puede asignar a un carácter Unicode válido, se ha encontrado un carácter no aplicable .
"cae">
La forma en que se controla un error de descodificación depende de la acción solicitada para ese tipo de error, que se describe mediante una instancia de la CodingErrorAction clase . Las posibles acciones de error son codificarErrorAction#IGNORE omitir la entrada errónea, CodingErrorAction#REPORT notifica el error al invocador a través del objeto devuelto CoderResult o CodingErrorAction#REPLACE reemplaza la entrada errónea por el valor actual de la cadena de reemplazo. Reemplazo
tiene el valor "\uFFFD"inicial ;
su valor se puede cambiar a través del #replaceWith(java.lang.String) replaceWith método .
La acción predeterminada para los errores de entrada incorrecta y de caracteres no válidos consiste en codificarErrorAction#REPORT notificarlos. La acción de error de entrada con formato incorrecto se puede cambiar a través del #onMalformedInput(CodingErrorAction) onMalformedInput método ; la acción unmappable-character puede cambiarse a través del #onUnmappableCharacter(CodingErrorAction) onUnmappableCharacter método .
Esta clase está diseñada para controlar muchos de los detalles del proceso de descodificación, incluida la implementación de acciones de error. Un descodificador para un conjunto de caracteres específico, que es una subclase concreta de esta clase, solo necesita implementar el método abstracto #decodeLoop decodeLoop , que encapsula el bucle de descodificación básico. Una subclase que mantiene el estado interno debe, además, invalidar los #implFlush implFlush métodos y #implReset implReset .
Las instancias de esta clase no son seguras para su uso por varios subprocesos simultáneos.
Agregado en la versión 1.4.
Java documentación para java.nio.charset.CharsetDecoder.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Constructores
| Nombre | Description |
|---|---|
| CharsetDecoder(Charset, Single, Single) |
Inicializa un nuevo descodificador. |
| CharsetDecoder(IntPtr, JniHandleOwnership) |
Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución. |
Propiedades
| Nombre | Description |
|---|---|
| Class |
Devuelve la clase en tiempo de ejecución de este |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| IsAutoDetecting |
Indica si este descodificador implementa un conjunto de caracteres de detección automática. |
| IsCharsetDetected |
Indica si este descodificador aún ha detectado un charset (operación opcional). |
| JniIdentityHashCode |
Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| JniManagedPeerState |
Un motor que puede transformar una secuencia de bytes en un conjunto de caracteres específico en una secuencia de caracteres Unicode de dieciséis bits. (Heredado de JavaObject) |
| JniPeerMembers |
Obtiene los metadatos de JNI usados para invocar miembros de este Java del mismo nivel. |
| PeerReference |
Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object) |
| ThresholdClass |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
| ThresholdType |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
Métodos
| Nombre | Description |
|---|---|
| AverageCharsPerByte() |
Devuelve el número medio de caracteres que se producirán para cada byte de entrada. |
| Charset() |
Devuelve el conjunto de caracteres que creó este descodificador. |
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Un motor que puede transformar una secuencia de bytes en un conjunto de caracteres específico en una secuencia de caracteres Unicode de dieciséis bits. (Heredado de JavaObject) |
| Decode(ByteBuffer, CharBuffer, Boolean) |
Descodifica tantos bytes como sea posible desde el búfer de entrada especificado, escribiendo los resultados en el búfer de salida especificado. |
| Decode(ByteBuffer) |
Método de conveniencia que descodifica el contenido restante de un único búfer de bytes de entrada en un búfer de caracteres recién asignado. |
| DecodeLoop(ByteBuffer, CharBuffer) |
Descodifica uno o varios bytes en uno o varios caracteres. |
| DetectedCharset() |
Recupera el conjunto de caracteres detectado por este descodificador (operación opcional). |
| Dispose() |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| Dispose(Boolean) |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| DisposeUnlessReferenced() |
Un motor que puede transformar una secuencia de bytes en un conjunto de caracteres específico en una secuencia de caracteres Unicode de dieciséis bits. (Heredado de JavaObject) |
| Equals(Object) |
Un motor que puede transformar una secuencia de bytes en un conjunto de caracteres específico en una secuencia de caracteres Unicode de dieciséis bits. (Heredado de JavaObject) |
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
| Flush(CharBuffer) |
Vacía este descodificador. |
| GetHashCode() |
Devuelve un valor de código hash para el objeto . (Heredado de Object) |
| ImplFlush(CharBuffer) |
Vacía este descodificador. |
| ImplOnMalformedInput(CodingErrorAction) |
Informa de un cambio en la acción de entrada incorrecta de este descodificador. |
| ImplOnUnmappableCharacter(CodingErrorAction) |
Informa de un cambio en la acción de carácter no aplicable de este descodificador. |
| ImplReplaceWith(String) |
Informa de un cambio en el valor de reemplazo de este descodificador. |
| ImplReset() |
Restablece este descodificador, borrando cualquier estado interno específico del conjunto de caracteres. |
| JavaFinalize() |
Obsoletos.
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
| MalformedInputAction() |
Devuelve la acción actual de este descodificador para los errores de entrada incorrectos. |
| MaxCharsPerByte() |
Devuelve el número máximo de caracteres que se generarán para cada byte de entrada. |
| Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
| NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
| OnMalformedInput(CodingErrorAction) |
Cambia la acción de este descodificador para los errores de entrada incorrectos. |
| OnUnmappableCharacter(CodingErrorAction) |
Cambia la acción de este descodificador para los errores de caracteres que no se pueden aplicar. |
| Replacement() |
Devuelve el valor de reemplazo de este descodificador. |
| ReplaceWith(String) |
Cambia el valor de reemplazo de este descodificador. |
| Reset() |
Restablece este descodificador, borrando cualquier estado interno. |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Un motor que puede transformar una secuencia de bytes en un conjunto de caracteres específico en una secuencia de caracteres Unicode de dieciséis bits. (Heredado de JavaObject) |
| ToArray<T>() |
Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object) |
| ToString() |
Devuelve una representación de cadena del objeto . (Heredado de Object) |
| UnmappableCharacterAction() |
Devuelve la acción actual de este descodificador para los errores de caracteres que no se pueden aplicar. |
| UnregisterFromRuntime() |
Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| Wait() |
Hace que el subproceso actual espere hasta que se despierta, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object) |
| Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| Wait(Int64) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IJavaPeerable.Disposed() |
Un motor que puede transformar una secuencia de bytes en un conjunto de caracteres específico en una secuencia de caracteres Unicode de dieciséis bits. (Heredado de JavaObject) |
| IJavaPeerable.Finalized() |
Un motor que puede transformar una secuencia de bytes en un conjunto de caracteres específico en una secuencia de caracteres Unicode de dieciséis bits. (Heredado de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Un motor que puede transformar una secuencia de bytes en un conjunto de caracteres específico en una secuencia de caracteres Unicode de dieciséis bits. (Heredado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Un motor que puede transformar una secuencia de bytes en un conjunto de caracteres específico en una secuencia de caracteres Unicode de dieciséis bits. (Heredado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Un motor que puede transformar una secuencia de bytes en un conjunto de caracteres específico en una secuencia de caracteres Unicode de dieciséis bits. (Heredado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Un motor que puede transformar una secuencia de bytes en un conjunto de caracteres específico en una secuencia de caracteres Unicode de dieciséis bits. (Heredado de JavaObject) |
Métodos de extensión
| Nombre | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtiene el nombre JNI del tipo de la instancia |
| JavaAs<TResult>(IJavaPeerable) |
Intente coerción |
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
Un motor que puede transformar una secuencia de bytes en un conjunto de caracteres específico en una secuencia de caracteres Unicode de dieciséis bits. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Intente coerción |