Lines Matching defs:charset
26 package java.nio.charset;
30 import java.nio.charset.spi.CharsetProvider;
55 * for retrieving the various names associated with a charset. Instances of
59 * charset is supported, for locating charset instances by name, and for
60 * constructing a map that contains every charset for which support is
63 * java.nio.charset.spi.CharsetProvider} class.
102 * A charset name must begin with either a letter or a digit. The empty string
103 * is not a legal charset name. Charset names are not case-sensitive; that is,
104 * case is always ignored when comparing charset names. Charset names
109 * <p> Every charset has a <i>canonical name</i> and may also have one or more
112 * The aliases of a charset are returned by the {@link #aliases() aliases}
118 * compatibility with previous versions of the Java platform. A charset's
126 * <p> If a charset listed in the <a
131 * identifies one of the names as <i>MIME-preferred</i>. If a charset has more
134 * supported charset is not listed in the IANA registry then its canonical name
137 * <p> The IANA charset registry does change over time, and so the canonical
138 * name and the aliases of a particular charset may also change over time. To
140 * charset, and that if the canonical name of a charset is changed then its
173 * <p> The <tt>UTF-8</tt> charset is specified by <a
201 * <li><p> When decoding, the <tt>UTF-16</tt> charset interprets the
213 * <p> Every instance of the Java virtual machine has a default charset, which
214 * may or may not be one of the standard charsets. The default charset is
216 * locale and charset being used by the underlying operating system. </p>
225 * In that document a <i>charset</i> is defined as the combination of
228 * <i>charset</i> as a synonym for <i>coded character set</i>.)
251 * character-encoding scheme then the corresponding charset is usually
252 * named for the coded character set; otherwise a charset is usually named
255 * name of a coded character set and of the charset that encodes it, while
256 * <tt>EUC-JP</tt> is the name of the charset that encodes the
261 * UTF-16. A charset in the Java platform therefore defines a mapping
272 * @see java.nio.charset.spi.CharsetProvider
296 * Checks that the given string is a legal charset name. </p>
299 * A purported charset name
302 * If the given name is not a legal charset name
467 throw new IllegalArgumentException("Null charset name");
495 /* Only need to check the name if we didn't find a charset for it */
501 * Tells whether the named charset is supported. </p>
504 * The name of the requested charset; may be either
507 * @return <tt>true</tt> if, and only if, support for the named charset
511 * If the given charset name is illegal
521 * Returns a charset object for the named charset. </p>
524 * The name of the requested charset; may be either
527 * @return A charset object for the named charset
530 * If the given charset name is illegal
536 * If no support for the named charset is available
558 * Constructs a sorted map from canonical charset names to charset objects.
560 * <p> The map returned by this method will have one entry for each charset
570 * charset selection. This method is not used by the {@link #forName
575 * charset providers are dynamically made available to the current Java
580 * @return An immutable, case-insensitive map from canonical charset names
581 * to charset objects
603 * Returns the default charset of this Java virtual machine.
605 * <p> The default charset is determined during virtual-machine startup and
606 * typically depends upon the locale and charset of the underlying
609 * @return A charset object for the default charset
636 * Initializes a new charset with the given canonical name and alias
640 * The canonical name of this charset
643 * An array of this charset's aliases, or null if it has no aliases
658 * Returns this charset's canonical name. </p>
660 * @return The canonical name of this charset
667 * Returns a set containing this charset's aliases. </p>
669 * @return An immutable set of this charset's aliases
683 * Returns this charset's human-readable name for the default locale.
686 * charset's canonical name. Concrete subclasses of this class may
689 * @return The display name of this charset in the default locale
696 * Tells whether or not this charset is registered in the <a
700 * @return <tt>true</tt> if, and only if, this charset is known by its
708 * Returns this charset's human-readable name for the given locale.
711 * charset's canonical name. Concrete subclasses of this class may
717 * @return The display name of this charset in the given locale
724 * Tells whether or not this charset contains the given charset.
726 * <p> A charset <i>C</i> is said to <i>contain</i> a charset <i>D</i> if,
737 * <p> Every charset contains itself.
740 * If it returns <tt>true</tt> then the given charset is known to be
741 * contained by this charset; if it returns <tt>false</tt>, however, then
742 * it is not necessarily the case that the given charset is not contained
743 * in this charset.
745 * @return <tt>true</tt> if the given charset is contained in this charset
750 * Constructs a new decoder for this charset. </p>
752 * @return A new decoder for this charset
757 * Constructs a new encoder for this charset. </p>
759 * @return A new encoder for this charset
762 * If this charset does not support encoding
767 * Tells whether or not this charset supports encoding.
777 * @return <tt>true</tt> if, and only if, this charset supports encoding
784 * Convenience method that decodes bytes in this charset into Unicode
787 * <p> An invocation of this method upon a charset <tt>cs</tt> returns the
800 * sequences with this charset's default replacement byte array. In order
821 * charset.
823 * <p> An invocation of this method upon a charset <tt>cs</tt> returns the
836 * sequences with this charset's default replacement string. In order to
856 * Convenience method that encodes a string into bytes in this charset.
858 * <p> An invocation of this method upon a charset <tt>cs</tt> returns the
873 * Compares this charset to another.
879 * The charset to which this charset is to be compared
881 * @return A negative integer, zero, or a positive integer as this charset
882 * is less than, equal to, or greater than the specified charset
889 * Computes a hashcode for this charset. </p>
901 * names. A charset is never equal to any other type of object. </p>
903 * @return <tt>true</tt> if, and only if, this charset is equal to the
915 * Returns a string describing this charset. </p>
917 * @return A string describing this charset