ByteBufUtil (Netty API Reference (4.1.11.Final))

java.lang.Object
- io.netty.buffer.ByteBufUtil

```
public final class ByteBufUtil
extends Object
```
A collection of utility methods that is related with handling ByteBuf, such as the generation of hex dump and swapping an integer's byte order.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`appendPrettyHexDump(StringBuilder dump, ByteBuf buf)` Appends the prettified multi-line hexadecimal dump of the specified `ByteBuf` to the specified `StringBuilder` that is easy to read by humans.
`static void`	`appendPrettyHexDump(StringBuilder dump, ByteBuf buf, int offset, int length)` Appends the prettified multi-line hexadecimal dump of the specified `ByteBuf` to the specified `StringBuilder` that is easy to read by humans, starting at the given `offset` using the given `length`.
`static int`	`compare(ByteBuf bufferA, ByteBuf bufferB)` Compares the two specified buffers as described in `ByteBuf.compareTo(ByteBuf)`.
`static void`	`copy(AsciiString src, int srcIdx, ByteBuf dst, int length)` Copies the content of `src` to a `ByteBuf` using `ByteBuf.writeBytes(byte[], int, int)`.
`static void`	`copy(AsciiString src, int srcIdx, ByteBuf dst, int dstIdx, int length)` Copies the content of `src` to a `ByteBuf` using `ByteBuf.writeBytes(byte[], int, int)`.
`static ByteBuf`	`encodeString(ByteBufAllocator alloc, CharBuffer src, Charset charset)` Encode the given `CharBuffer` using the given `Charset` into a new `ByteBuf` which is allocated via the `ByteBufAllocator`.
`static ByteBuf`	`encodeString(ByteBufAllocator alloc, CharBuffer src, Charset charset, int extraCapacity)` Encode the given `CharBuffer` using the given `Charset` into a new `ByteBuf` which is allocated via the `ByteBufAllocator`.
`static boolean`	`equals(ByteBuf bufferA, ByteBuf bufferB)` Returns `true` if and only if the two specified buffers are identical to each other as described in `ByteBuf.equals(Object)`.
`static boolean`	`equals(ByteBuf a, int aStartIndex, ByteBuf b, int bStartIndex, int length)` Returns `true` if and only if the two specified buffers are identical to each other for `length` bytes starting at `aStartIndex` index for the `a` buffer and `bStartIndex` index for the `b` buffer.
`static byte[]`	`getBytes(ByteBuf buf)` Create a copy of the underlying storage from `buf` into a byte array.
`static byte[]`	`getBytes(ByteBuf buf, int start, int length)` Create a copy of the underlying storage from `buf` into a byte array.
`static byte[]`	`getBytes(ByteBuf buf, int start, int length, boolean copy)` Return an array of the underlying storage from `buf` into a byte array.
`static int`	`hashCode(ByteBuf buffer)` Calculates the hash code of the specified buffer.
`static String`	`hexDump(byte[] array)` Returns a hex dump of the specified byte array.
`static String`	`hexDump(byte[] array, int fromIndex, int length)` Returns a hex dump of the specified byte array's sub-region.
`static String`	`hexDump(ByteBuf buffer)` Returns a hex dump of the specified buffer's readable bytes.
`static String`	`hexDump(ByteBuf buffer, int fromIndex, int length)` Returns a hex dump of the specified buffer's sub-region.
`static int`	`indexOf(ByteBuf needle, ByteBuf haystack)` Returns the reader index of needle in haystack, or -1 if needle is not in haystack.
`static int`	`indexOf(ByteBuf buffer, int fromIndex, int toIndex, byte value)` The default implementation of `ByteBuf.indexOf(int, int, byte)`.
`static boolean`	`isText(ByteBuf buf, Charset charset)` Returns `true` if the given `ByteBuf` is valid text using the given `Charset`, otherwise return `false`.
`static boolean`	`isText(ByteBuf buf, int index, int length, Charset charset)` Returns `true` if the specified `ByteBuf` starting at `index` with `length` is valid text using the given `Charset`, otherwise return `false`.
`static String`	`prettyHexDump(ByteBuf buffer)` Returns a multi-line hexadecimal dump of the specified `ByteBuf` that is easy to read by humans.
`static String`	`prettyHexDump(ByteBuf buffer, int offset, int length)` Returns a multi-line hexadecimal dump of the specified `ByteBuf` that is easy to read by humans, starting at the given `offset` using the given `length`.
`static ByteBuf`	`readBytes(ByteBufAllocator alloc, ByteBuf buffer, int length)` Read the given amount of bytes into a new `ByteBuf` that is allocated from the `ByteBufAllocator`.
`static int`	`swapInt(int value)` Toggles the endianness of the specified 32-bit integer.
`static long`	`swapLong(long value)` Toggles the endianness of the specified 64-bit long integer.
`static int`	`swapMedium(int value)` Toggles the endianness of the specified 24-bit medium integer.
`static short`	`swapShort(short value)` Toggles the endianness of the specified 16-bit short integer.
`static ByteBuf`	`threadLocalDirectBuffer()` Returns a cached thread-local direct buffer, if available.
`static int`	`utf8MaxBytes(CharSequence seq)` Returns max bytes length of UTF8 character sequence.
`static ByteBuf`	`writeAscii(ByteBufAllocator alloc, CharSequence seq)` Encode a `CharSequence` in ASCII and write it to a `ByteBuf` allocated with `alloc`.
`static int`	`writeAscii(ByteBuf buf, CharSequence seq)` Encode a `CharSequence` in ASCII and write it to a `ByteBuf`.
`static ByteBuf`	`writeUtf8(ByteBufAllocator alloc, CharSequence seq)` Encode a `CharSequence` in UTF-8 and write it to a `ByteBuf` allocated with `alloc`.
`static int`	`writeUtf8(ByteBuf buf, CharSequence seq)` Encode a `CharSequence` in UTF-8 and write it to a `ByteBuf`.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - hexDump
```
public static String hexDump(ByteBuf buffer)
```
    Returns a hex dump of the specified buffer's readable bytes.
  - hexDump
```
public static String hexDump(ByteBuf buffer,
                             int fromIndex,
                             int length)
```
    Returns a hex dump of the specified buffer's sub-region.
  - hexDump
```
public static String hexDump(byte[] array)
```
    Returns a hex dump of the specified byte array.
  - hexDump
```
public static String hexDump(byte[] array,
                             int fromIndex,
                             int length)
```
    Returns a hex dump of the specified byte array's sub-region.
  - hashCode
```
public static int hashCode(ByteBuf buffer)
```
    Calculates the hash code of the specified buffer. This method is useful when implementing a new buffer type.
  - indexOf
```
public static int indexOf(ByteBuf needle,
                          ByteBuf haystack)
```
    Returns the reader index of needle in haystack, or -1 if needle is not in haystack.
  - equals
```
public static boolean equals(ByteBuf a,
                             int aStartIndex,
                             ByteBuf b,
                             int bStartIndex,
                             int length)
```
    Returns true if and only if the two specified buffers are identical to each other for length bytes starting at aStartIndex index for the a buffer and bStartIndex index for the b buffer. A more compact way to express this is:
    a[aStartIndex : aStartIndex + length] == b[bStartIndex : bStartIndex + length]
  - equals
```
public static boolean equals(ByteBuf bufferA,
                             ByteBuf bufferB)
```
    Returns true if and only if the two specified buffers are identical to each other as described in ByteBuf.equals(Object). This method is useful when implementing a new buffer type.
  - compare
```
public static int compare(ByteBuf bufferA,
                          ByteBuf bufferB)
```
    Compares the two specified buffers as described in ByteBuf.compareTo(ByteBuf). This method is useful when implementing a new buffer type.
  - indexOf
```
public static int indexOf(ByteBuf buffer,
                          int fromIndex,
                          int toIndex,
                          byte value)
```
    The default implementation of ByteBuf.indexOf(int, int, byte). This method is useful when implementing a new buffer type.
  - swapShort
```
public static short swapShort(short value)
```
    Toggles the endianness of the specified 16-bit short integer.
  - swapMedium
```
public static int swapMedium(int value)
```
    Toggles the endianness of the specified 24-bit medium integer.
  - swapInt
```
public static int swapInt(int value)
```
    Toggles the endianness of the specified 32-bit integer.
  - swapLong
```
public static long swapLong(long value)
```
    Toggles the endianness of the specified 64-bit long integer.
  - readBytes
```
public static ByteBuf readBytes(ByteBufAllocator alloc,
                                ByteBuf buffer,
                                int length)
```
    Read the given amount of bytes into a new ByteBuf that is allocated from the ByteBufAllocator.
  - writeUtf8
```
public static ByteBuf writeUtf8(ByteBufAllocator alloc,
                                CharSequence seq)
```
    Encode a CharSequence in UTF-8 and write it to a ByteBuf allocated with alloc.
    
    Parameters:
    
    alloc - The allocator used to allocate a new ByteBuf.
    
    seq - The characters to write into a buffer.
    
    Returns:
    
    The ByteBuf which contains the UTF-8 encoded result.
  - writeUtf8
```
public static int writeUtf8(ByteBuf buf,
                            CharSequence seq)
```
    Encode a CharSequence in UTF-8 and write it to a ByteBuf. This method returns the actual number of bytes written.
  - utf8MaxBytes
```
public static int utf8MaxBytes(CharSequence seq)
```
    Returns max bytes length of UTF8 character sequence.
  - writeAscii
```
public static ByteBuf writeAscii(ByteBufAllocator alloc,
                                 CharSequence seq)
```
    Encode a CharSequence in ASCII and write it to a ByteBuf allocated with alloc.
    
    Parameters:
    
    alloc - The allocator used to allocate a new ByteBuf.
    
    seq - The characters to write into a buffer.
    
    Returns:
    
    The ByteBuf which contains the ASCII encoded result.
  - writeAscii
```
public static int writeAscii(ByteBuf buf,
                             CharSequence seq)
```
    Encode a CharSequence in ASCII and write it to a ByteBuf. This method returns the actual number of bytes written.
  - encodeString
```
public static ByteBuf encodeString(ByteBufAllocator alloc,
                                   CharBuffer src,
                                   Charset charset)
```
    Encode the given CharBuffer using the given Charset into a new ByteBuf which is allocated via the ByteBufAllocator.
  - encodeString
```
public static ByteBuf encodeString(ByteBufAllocator alloc,
                                   CharBuffer src,
                                   Charset charset,
                                   int extraCapacity)
```
    Encode the given CharBuffer using the given Charset into a new ByteBuf which is allocated via the ByteBufAllocator.
    
    Parameters:
    
    alloc - The ByteBufAllocator to allocate ByteBuf.
    
    src - The CharBuffer to encode.
    
    charset - The specified Charset.
    
    extraCapacity - the extra capacity to alloc except the space for decoding.
  - threadLocalDirectBuffer
```
public static ByteBuf threadLocalDirectBuffer()
```
    Returns a cached thread-local direct buffer, if available.
    
    Returns:
    
    a cached thread-local direct buffer, if available. null otherwise.
  - getBytes
```
public static byte[] getBytes(ByteBuf buf)
```
    Create a copy of the underlying storage from buf into a byte array. The copy will start at ByteBuf.readerIndex() and copy ByteBuf.readableBytes() bytes.
  - getBytes
```
public static byte[] getBytes(ByteBuf buf,
                              int start,
                              int length)
```
    Create a copy of the underlying storage from buf into a byte array. The copy will start at start and copy length bytes.
  - getBytes
```
public static byte[] getBytes(ByteBuf buf,
                              int start,
                              int length,
                              boolean copy)
```
    Return an array of the underlying storage from buf into a byte array. The copy will start at start and copy length bytes. If copy is true a copy will be made of the memory. If copy is false the underlying storage will be shared, if possible.
  - copy
```
public static void copy(AsciiString src,
                        int srcIdx,
                        ByteBuf dst,
                        int dstIdx,
                        int length)
```
    Copies the content of src to a ByteBuf using ByteBuf.writeBytes(byte[], int, int).
    
    Parameters:
    
    src - The source of the data to copy.
    
    srcIdx - the starting offset of characters to copy.
    
    dst - the destination byte array.
    
    dstIdx - the starting offset in the destination byte array.
    
    length - the number of characters to copy.
  - copy
```
public static void copy(AsciiString src,
                        int srcIdx,
                        ByteBuf dst,
                        int length)
```
    Copies the content of src to a ByteBuf using ByteBuf.writeBytes(byte[], int, int).
    
    Parameters:
    
    src - The source of the data to copy.
    
    srcIdx - the starting offset of characters to copy.
    
    dst - the destination byte array.
    
    length - the number of characters to copy.
  - prettyHexDump
```
public static String prettyHexDump(ByteBuf buffer)
```
    Returns a multi-line hexadecimal dump of the specified ByteBuf that is easy to read by humans.
  - prettyHexDump
```
public static String prettyHexDump(ByteBuf buffer,
                                   int offset,
                                   int length)
```
    Returns a multi-line hexadecimal dump of the specified ByteBuf that is easy to read by humans, starting at the given offset using the given length.
  - appendPrettyHexDump
```
public static void appendPrettyHexDump(StringBuilder dump,
                                       ByteBuf buf)
```
    Appends the prettified multi-line hexadecimal dump of the specified ByteBuf to the specified StringBuilder that is easy to read by humans.
  - appendPrettyHexDump
```
public static void appendPrettyHexDump(StringBuilder dump,
                                       ByteBuf buf,
                                       int offset,
                                       int length)
```
    Appends the prettified multi-line hexadecimal dump of the specified ByteBuf to the specified StringBuilder that is easy to read by humans, starting at the given offset using the given length.
  - isText
```
public static boolean isText(ByteBuf buf,
                             Charset charset)
```
    Returns true if the given ByteBuf is valid text using the given Charset, otherwise return false.
    
    Parameters:
    
    buf - The given ByteBuf.
    
    charset - The specified Charset.
  - isText
```
public static boolean isText(ByteBuf buf,
                             int index,
                             int length,
                             Charset charset)
```
    Returns true if the specified ByteBuf starting at index with length is valid text using the given Charset, otherwise return false.
    
    Parameters:
    
    buf - The given ByteBuf.
    
    index - The start index of the specified buffer.
    
    length - The length of the specified buffer.
    
    charset - The specified Charset.
    
    Throws:
    
    IndexOutOfBoundsException - if index + length is greater than buf.readableBytes

Class ByteBufUtil

Method Summary

Methods inherited from class java.lang.Object

Method Detail

hexDump

hexDump

hexDump

hexDump

hashCode

indexOf

equals

equals

compare

indexOf

swapShort

swapMedium

swapInt

swapLong

readBytes

writeUtf8

writeUtf8

utf8MaxBytes

writeAscii

writeAscii

encodeString

encodeString

threadLocalDirectBuffer

getBytes

getBytes

getBytes

copy

copy

prettyHexDump

prettyHexDump

appendPrettyHexDump

appendPrettyHexDump

isText

isText