Java-API简析_java.nio.CharBuffer类（基于 Latest JDK）（浅析源码）

【版权声明】未经博主同意，谢绝转载！（请尊重原创，博主保留追究权）
https://blog.csdn.net/m0_69908381/article/details/131318474
出自【进步*于辰的博客】

1、概述

继承关系：

• java.lang.Object
  • java.nio.Buffer
    • java.nio.CharBuffer

所有已实现的接口：
Appendable、CharSequence、Comparable<CharBuffer>、Readable

---

public abstract class CharBuffer extends Buffer implements Comparable<CharBuffer>, Appendable, CharSequence, Readable

字符缓冲区。

此类定义了字符缓冲区上的四类操作：

• 读写单个字符的绝对 和相对 get() 和 put() 方法；
• 将此缓冲区中的连续字符序列 传输到数组中的相对批量 get() 方法；
• 将字符数组、字符串 或其他字符缓冲区中的连续字符序列 传输到此缓冲区的相对批量 put() 方法；以及字符缓冲区的 compacting()、duplicating() 和 slicing() 方法。

字符缓冲区可以通过 allocation() 方法创建，此方法通过 wrapping 将一个现有字符数组 或字符串 包装到缓冲区中来为缓冲区内容分配空间，或者通过创建现有字节缓冲区 的视图来创建。

像字节缓冲区一样，字符缓冲区要么是直接 的，要么是非直接 的。通过此类的 wrap() 方法创建的字符缓冲区将是非直接的。当且仅当字节缓冲区本身为直接时，作为字节缓冲区的视图创建的字符缓冲区才是直接的。通过调用 isDirect() 方法可以确定字符缓冲区是否为直接的。

此类实现 CharSequence 接口，以便字符缓冲区可以用于任何接受字符序列的地方，例如，在正则表达式包 java.util.regex 中。

指定此类中不返回其他值的那些方法返回它们被调用时所在的缓冲区。这允许对方法调用进行链接。例如，语句序列 ：

cb.put("text/");
cb.put(subtype);
cb.put("; charset=");
cb.put(enc);

可以由以下单个语句替换

cb.put("text/").put(subtype).put("; charset=").put(enc);

从以下版本开始：
1.4

2、方法摘要

2.1 static CharBuffer allocate(int capacity)

分配新的字符缓冲区。

2.2 CharBuffer append(char c)

将指定字符追加到此缓冲区（可选操作）。

2.3 CharBuffer append(CharSequence csq)

将指定的字符序列追加到此缓冲区（可选操作）。

2.4 CharBuffer append(CharSequence csq, int start, int end)

将指定字符序列的子序列追加到此缓冲区（可选操作）。

2.5 char[] array()

返回实现此缓冲区的字符数组（可选操作）。

2.6 int arrayOffset()

返回此缓冲区中的第一个元素在缓冲区的底层实现数组中的偏移量（可选操作）。

2.7 abstract CharBuffer asReadOnlyBuffer()

创建共享此缓冲区内容的新的只读字符缓冲区。

2.8 char charAt(int index)

读取相对于当前位置的给定索引处的字符。

2.9 abstract CharBuffer compact()

压缩此缓冲区（可选操作）。

2.10 int compareTo(CharBuffer that)

将此缓冲区与另一个缓冲区进行比较。

2.11 abstract CharBuffer duplicate()

创建共享此缓冲区内容的新的字符缓冲区。

2.12 boolean equals(Object ob)

判断此缓冲区是否与另一个对象相同。

2.13 abstract char get()

相对 get() 方法。

2.14 CharBuffer get(char[] dst)

相对批量 get() 方法。

2.15 CharBuffer get(char[] dst, int offset, int length)

相对批量 get() 方法。

2.16 abstract char get(int index)

绝对 get() 方法。

2.17 boolean hasArray()

判断该缓冲区是否可通过一个可访问的字符数组实现。

2.18 int hashCode()

返回此缓冲区的当前哈希码。

2.19 abstract boolean isDirect()

判断此字符缓冲区是否为直接的。

2.20 int length()

返回此字符缓冲区的长度。

2.21 abstract ByteOrder order()

检索此缓冲区的字节顺序。

2.22 abstract CharBuffer put(char c)

相对 put() 方法（可选操作）。

2.23 CharBuffer put(char[] src)

相对批量 put() 方法（可选操作）。

2.24 CharBuffer put(char[] src, int offset, int length)

相对批量 put() 方法（可选操作）。

2.25 CharBuffer put(CharBuffer src)

相对批量 put() 方法（可选操作）。

2.26 CharBuffer put(int index, char c)

绝对 put() 方法（可选操作）。

2.27 CharBuffer put(String src)

相对批量 put() 方法（可选操作）。

2.28 CharBuffer put(String src, int start, int end)

相对批量 put() 方法（可选操作）。

2.29 int read(CharBuffer target)

试图将字符读入指定的字符缓冲区。

2.30 abstract CharBuffer slice()

创建新的字符缓冲区，其内容为此缓冲区内容的共享子序列。

2.31 abstract CharSequence subSequence(int start, int end)

创建表示此缓冲区的指定序列、相对于当前位置 的新字符缓冲区。

2.32 String toString()

返回包含此缓冲区中字符的字符串。

2.33 static CharBuffer wrap(char[] array)

将字符数组包装到缓冲区中。

2.34 static CharBuffer wrap(char[] array, int offset, int length)

将字符数组包装到缓冲区中。

2.35 static CharBuffer wrap(CharSequence csq)

将字符串包装到缓冲区中。

2.36 static CharBuffer wrap(CharSequence csq, int start, int end)

将字符序列包装到缓冲区中。

最后

如果大家需要Java-API文档，我上传了《Java-API文档-包含5/8/11三个版本》。

---

本文暂缓更新。