CharsetToolkit (groovy 2.4.4 API)

groovy.util.CharsetToolkit

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Constructor Summary

Constructors
Constructor and description
`CharsetToolkit (File file)` Constructor of the `CharsetToolkit` utility class.

Methods Summary

Methods
Type	Name and description
`static Charset[]`	`getAvailableCharsets()` Retrieves all the available `Charset`s on the platform, among which the default `charset`.
`Charset`	`getCharset()`
`Charset`	`getDefaultCharset()` Retrieves the default Charset
`static Charset`	`getDefaultSystemCharset()` Retrieve the default charset of the system.
`boolean`	`getEnforce8Bit()` Gets the enforce8Bit flag, in case we do not want to ever get a US-ASCII encoding.
`BufferedReader`	`getReader()` Gets a `BufferedReader` (indeed a `LineNumberReader`) from the `File` specified in the constructor of `CharsetToolkit` using the charset discovered or the default charset if an 8-bit `Charset` is encountered.
`boolean`	`hasUTF16BEBom()` Has a Byte Order Marker for UTF-16 Big Endian (utf-16 and ucs-2).
`boolean`	`hasUTF16LEBom()` Has a Byte Order Marker for UTF-16 Low Endian (ucs-2le, ucs-4le, and ucs-16le).
`boolean`	`hasUTF8Bom()` Has a Byte Order Marker for UTF-8 (Used by Microsoft's Notepad and other editors).
`void`	`setDefaultCharset(Charset defaultCharset)` Defines the default `Charset` used in case the buffer represents an 8-bit `Charset`.
`void`	`setEnforce8Bit(boolean enforce)` If US-ASCII is recognized, enforce to return the default encoding, rather than US-ASCII.

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class Object`	`wait, wait, wait, equals, toString, hashCode, getClass, notify, notifyAll`

- Constructor Detail
  - public CharsetToolkit(File file)
    
    Constructor of the CharsetToolkit utility class.
    Parameters:
    file - of which we want to know the encoding.
- Method Detail
  - public static Charset[] getAvailableCharsets()
    
    Retrieves all the available Charsets on the platform, among which the default charset.
    Returns:
    an array of Charsets.
  - public Charset getCharset()
  - public Charset getDefaultCharset()
    
    Retrieves the default Charset
  - public static Charset getDefaultSystemCharset()
    
    Retrieve the default charset of the system.
    Returns:
    the default Charset.
  - public boolean getEnforce8Bit()
    
    Gets the enforce8Bit flag, in case we do not want to ever get a US-ASCII encoding.
    Returns:
    a boolean representing the flag of use of US-ASCII.
  - public BufferedReader getReader()
    
    Gets a BufferedReader (indeed a LineNumberReader) from the File specified in the constructor of CharsetToolkit using the charset discovered or the default charset if an 8-bit Charset is encountered.
    throws:
    FileNotFoundException if the file is not found.
    
    Returns:
    a BufferedReader
  - public boolean hasUTF16BEBom()
    
    Has a Byte Order Marker for UTF-16 Big Endian (utf-16 and ucs-2).
    Returns:
    true if the buffer has a BOM for UTF-16 Big Endian.
  - public boolean hasUTF16LEBom()
    
    Has a Byte Order Marker for UTF-16 Low Endian (ucs-2le, ucs-4le, and ucs-16le).
    Returns:
    true if the buffer has a BOM for UTF-16 Low Endian.
  - public boolean hasUTF8Bom()
    
    Has a Byte Order Marker for UTF-8 (Used by Microsoft's Notepad and other editors).
    Returns:
    true if the buffer has a BOM for UTF8.
  - public void setDefaultCharset(Charset defaultCharset)
    
    Defines the default Charset used in case the buffer represents an 8-bit Charset.
    Parameters:
    defaultCharset - the default Charset to be returned if an 8-bit Charset is encountered.
  - public void setEnforce8Bit(boolean enforce)
    
    If US-ASCII is recognized, enforce to return the default encoding, rather than US-ASCII. It might be a file without any special character in the range 128-255, but that may be or become a file encoded with the default charset rather than US-ASCII.
    Parameters:
    enforce - a boolean specifying the use or not of US-ASCII.

Summary:
Constructor
Method

| Detail:
Constructor
Method

[Java] Class CharsetToolkit

Constructor Summary

Methods Summary

Inherited Methods Summary

Constructor Detail

public CharsetToolkit(File file)

Method Detail

public static Charset[] getAvailableCharsets()

public Charset getCharset()

public Charset getDefaultCharset()

public static Charset getDefaultSystemCharset()

public boolean getEnforce8Bit()

public BufferedReader getReader()

public boolean hasUTF16BEBom()

public boolean hasUTF16LEBom()

public boolean hasUTF8Bom()

public void setDefaultCharset(Charset defaultCharset)

public void setEnforce8Bit(boolean enforce)