SquirrelJME/SquirrelJME

// -*- Mode: Java; indent-tabs-mode: t; tab-width: 4 -*-
// ---------------------------------------------------------------------------
// SquirrelJME
//     Copyright (C) Stephanie Gawroriski <xer@multiphasicapps.net>
// ---------------------------------------------------------------------------
// SquirrelJME is under the Mozilla Public License Version 2.0.
// See license.mkd for licensing and copyright information.
// ---------------------------------------------------------------------------

package cc.squirreljme.runtime.cldc.io;

/**
 * This encodes ASCII.
 *
 * @since 2018/12/23
 */
public final class ASCIIEncoder
    implements Encoder
{
    /**
     * {@inheritDoc}
     * @since 2018/12/23
     */
    @Override
    public final double averageSequenceLength()
    {
        return 1.0;
    }
    
    /**
     * {@inheritDoc}
     * @since 2018/12/23
     */
    @Override
    public int encode(char __c, byte[] __b, int __o, int __l)
        throws IndexOutOfBoundsException, NullPointerException
    {
        if (__b == null)
            throw new NullPointerException("NARG");
        if (__o < 0 || __l < 0 || (__o + __l) < 0 || (__o + __l) > __b.length)
            throw new IndexOutOfBoundsException("IOOB");
        
        // Always encodes to one character, so if one character cannot fit in
        // the buffer then fail
        if (__l < 1)
            return -1;
        
        // These characters are invalid, so they all become the replacement
        // character
        if (__c >= 0x80)
            __b[__o] = '?';
        
        // Encode as is
        else
            __b[__o] = (byte)__c;
        
        // Only single characters written
        return 1;
    }
    
    /**
     * {@inheritDoc}
     * @since 2018/12/23
     */
    @Override
    public final String encodingName()
    {
        return "ascii";
    }
    
    /**
     * {@inheritDoc}
     * @since 2018/12/23
     */
    @Override
    public final int maximumSequenceLength()
    {
        return 1;
    }
}