All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.couchbase.lite.internal.fleece.FLArray Maven / Gradle / Ivy

//
// Copyright (c) 2020, 2017 Couchbase, Inc All rights reserved.
//
// Licensed 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.
//
package com.couchbase.lite.internal.fleece;

import java.util.ArrayList;
import java.util.List;

import com.couchbase.lite.internal.utils.Fn;
import com.couchbase.lite.internal.utils.Preconditions;


public class FLArray {
    private final long handle; // pointer to FLArray

    //-------------------------------------------------------------------------
    // constructor
    //-------------------------------------------------------------------------

    public FLArray(long handle) {
        Preconditions.assertNotZero(handle, "handle");
        this.handle = handle;
    }

    //-------------------------------------------------------------------------
    // public methods
    //-------------------------------------------------------------------------

    /**
     * Returns the number of items in an array; 0 if handle is null.
     *
     * @return the number of items in an array; 0 if handle is null.
     */
    public long count() { return count(handle); }

    /**
     * Returns an value at an array index, or null if the index is out of range.
     *
     * @param index index for value
     * @return the FLValue at index
     */
    public FLValue get(long index) { return new FLValue(get(handle, index)); }

    public List asArray() { return asTypedArray(); }

    @SuppressWarnings("unchecked")
    public  List asTypedArray() {
        final List results = new ArrayList<>();
        final FLArrayIterator itr = new FLArrayIterator();

        itr.begin(this);
        FLValue value;
        while ((value = itr.getValue()) != null) {
            results.add((T) value.asObject());
            if (!itr.next()) { break; }
        }

        return results;
    }

    //-------------------------------------------------------------------------
    // package level access
    //-------------------------------------------------------------------------

     T withContent(Fn.Function fn) { return fn.apply(handle); }

    //-------------------------------------------------------------------------
    // native methods
    //-------------------------------------------------------------------------

    private static native long count(long array);

    private static native long get(long array, long index);
}