Package: org.apache.groovy.json.internal

## [Java] Class JsonParserCharArray

- org.apache.groovy.json.internal.JsonParserCharArray

-     public class JsonParserCharArray
      extends BaseJsonParser

  Converts an input JSON String into Java objects works with String or char array as input. Produces an Object which can be any of the basic JSON types mapped to Java.

- - ### Field Summary

    Fields
    Modifiers | Name | Description
    --- | --- | ---
    `protected static char[]` | `FALSE` | Character buffer for the `false` literal.
    `protected static char[]` | `NULL` | Character buffer for the `null` literal.
    `protected static char[]` | `TRUE` | Character buffer for the `true` literal.
    `protected char` | `__currentChar` | Character at the current parser position.
    `protected int` | `__index` | Current position within charArray.
    `protected char[]` | `charArray` | Character buffer currently being parsed.

  - Inherited fields
    Fields inherited from class | Fields
    --- | ---
    `class BaseJsonParser` | `ALPHA_0, ALPHA_1, ALPHA_2, ALPHA_3, ALPHA_4, ALPHA_5, ALPHA_6, ALPHA_7, ALPHA_8, ALPHA_9, CLOSED_BRACKET, CLOSED_CURLY, COLON, COMMA, DECIMAL_POINT, DEFAULT_MAX_NESTING_DEPTH, DOUBLE_QUOTE, ESCAPE, LETTER_BIG_E, LETTER_E, MINUS, PLUS, bufSize, charset, internKeys, internedKeysCache, maxNestingDepth`

  - ### Methods Summary

    Methods
    Type Params | Return Type | Name and description
    --- | --- | ---
    `` | `protected final void` | `complain(String complaint)` Throws a JsonException for the current location.
    `` | `protected final char` | `currentChar()` Returns the current character in the input buffer.
    `` | `protected final boolean` | `decodeFalse()` Consumes the `false` literal.
    `` | `protected Object` | `decodeFromChars(char[] cs)` Initializes parser state and decodes a character buffer.
    `` | `protected final List` | `decodeJsonArray()` Decodes a JSON array from the current position.
    `` | `protected final Object` | `decodeJsonObject()` Decodes a JSON object from the current position.
    `` | `protected final Object` | `decodeNull()` Consumes the `null` literal.
    `` | `protected final boolean` | `decodeTrue()` Consumes the `true` literal.
    `` | `protected Object` | `decodeValue()` Decodes the next JSON value.
    `` | `protected String` | `exceptionDetails(String message)` Builds an error message using the current parser position.
    `` | `protected final boolean` | `hasCurrent()` Checks whether the current index is still within the buffer.
    `` | `protected final boolean` | `hasMore()` Checks whether more characters remain after the current index.
    `` | `protected final char` | `nextChar()` Advances to the next character in the input buffer.
    `` | `public Object` | `parse(char[] chars)` Parses JSON from a character array.
    `` | `protected final void` | `skipWhiteSpace()` Advances past JSON whitespace characters.

  - ### Inherited Methods Summary

    Inherited Methods
    Methods inherited from class | Name
    --- | ---
    `class BaseJsonParser` | `charDescription, enterNesting, exitNesting, findEndQuote, getMaxNestingDepth, hasEscapeChar, isDecimalChar, isDelimiter, isDoubleQuote, isEscape, isNumberDigit, parse, parse, parse, parse, parse, parse, parse, parse, resetNesting, setCharset, setMaxNestingDepth`

- - ### Field Detail

    - #### protected static char[] FALSE

      Character buffer for the `false` literal.

    - #### protected static final char[] NULL

      Character buffer for the `null` literal.

    - #### protected static final char[] TRUE

      Character buffer for the `true` literal.

    - #### protected char __currentChar

      Character at the current parser position.

    - #### protected int __index

      Current position within charArray.

    - #### protected char[] charArray

      Character buffer currently being parsed.

  - ### Method Detail

    - #### protected final void complain(String complaint)

      Throws a JsonException for the current location.

      Parameters:
        `complaint` - message describing the parse failure

    - #### protected final char currentChar()

      Returns the current character in the input buffer.

      Returns:
        current character, or `0` when the index is past the end

    - #### protected final boolean decodeFalse()

      Consumes the `false` literal.

      Returns:
        `false`

    - #### protected Object decodeFromChars(char[] cs)

      Initializes parser state and decodes a character buffer.

      Parameters:
        `cs` - JSON content to parse
      Returns:
        parsed Groovy JSON value

    - #### protected final List decodeJsonArray()

      Decodes a JSON array from the current position.

      Returns:
        parsed array contents

    - #### protected final Object decodeJsonObject()

      Decodes a JSON object from the current position.

      Returns:
        parsed object as a LazyMap

    - #### protected final Object decodeNull()

      Consumes the `null` literal.

      Returns:
        `null`

    - #### protected final boolean decodeTrue()

      Consumes the `true` literal.

      Returns:
        `true`

    - #### protected Object decodeValue()

      Decodes the next JSON value.

      Returns:
        parsed Groovy JSON value

    - #### protected String exceptionDetails(String message)

      Builds an error message using the current parser position.

      Parameters:
        `message` - parser-specific message
      Returns:
        formatted error details

    - #### protected final boolean hasCurrent()

      Checks whether the current index is still within the buffer.

      Returns:
        `true` when the current position is valid

    - #### protected final boolean hasMore()

      Checks whether more characters remain after the current index.

      Returns:
        `true` when another character can be consumed

    - #### protected final char nextChar()

      Advances to the next character in the input buffer.

      Returns:
        next character, or `0` when the buffer is exhausted

    - #### public Object parse(char[] chars)

      Parses JSON from a character array.

      Parameters:
        `chars` - JSON content to parse
      Returns:
        parsed Groovy JSON value

    - #### protected final void skipWhiteSpace()

      Advances past JSON whitespace characters.