com.landawn.abacus.util.function.LongPredicate Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of abacus-common Show documentation
A general programming library in Java/Android. It's easy to learn and simple to use with concise and powerful APIs.
There is a newer version: 5.2.4
/*
 * Copyright (C) 2016 HaiYang Li
 *
 * 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.landawn.abacus.util.function;

import com.landawn.abacus.util.N;
import com.landawn.abacus.util.Throwables;

/**
 * Refer to JDK API documentation at: https://docs.oracle.com/javase/8/docs/api/java/util/function/package-summary.html
 * @since 0.8
 *
 * @author Haiyang Li
 */
public interface LongPredicate extends Throwables.LongPredicate, java.util.function.LongPredicate { //NOSONAR

    LongPredicate ALWAYS_TRUE = value -> true;

    LongPredicate ALWAYS_FALSE = value -> false;

    LongPredicate IS_ZERO = value -> value == 0;

    LongPredicate NOT_ZERO = value -> value != 0;

    LongPredicate IS_POSITIVE = value -> value > 0;

    LongPredicate NOT_POSITIVE = value -> value <= 0;

    LongPredicate IS_NEGATIVE = value -> value < 0;

    LongPredicate NOT_NEGATIVE = value -> value >= 0;

    /**
     * 
     *
     * @param value 
     * @return 
     */
    @Override
    boolean test(long value);

    /**
     * 
     *
     * @return 
     */
    @Override
    default LongPredicate negate() {
        return value -> !test(value);
    }

    /**
     * 
     *
     * @param other 
     * @return 
     */
    @Override
    default LongPredicate or(java.util.function.LongPredicate other) {
        N.checkArgNotNull(other);
        return value -> test(value) || other.test(value);
    }

    /**
     * 
     *
     * @param other 
     * @return 
     */
    @Override
    default LongPredicate and(java.util.function.LongPredicate other) {
        N.checkArgNotNull(other);
        return value -> test(value) && other.test(value);
    }

    /**
     * Returns the specified instance.
     *
     * @param predicate 
     * @return 
     */
    static LongPredicate of(final LongPredicate predicate) {
        N.checkArgNotNull(predicate);

        return predicate;
    }

    /**
     * 
     *
     * @param targetLong 
     * @return 
     */
    static LongPredicate equal(long targetLong) { //NOSONAR
        return value -> value == targetLong;
    }

    /**
     * 
     *
     * @param targetLong 
     * @return 
     */
    static LongPredicate notEqual(long targetLong) {
        return value -> value != targetLong;
    }

    /**
     * 
     *
     * @param targetLong 
     * @return 
     */
    static LongPredicate greaterThan(long targetLong) {
        return value -> value > targetLong;
    }

    /**
     * 
     *
     * @param targetLong 
     * @return 
     */
    static LongPredicate greaterEqual(long targetLong) {
        return value -> value >= targetLong;
    }

    /**
     * 
     *
     * @param targetLong 
     * @return 
     */
    static LongPredicate lessThan(long targetLong) {
        return value -> value < targetLong;
    }

    /**
     * 
     *
     * @param targetLong 
     * @return 
     */
    static LongPredicate lessEqual(long targetLong) {
        return value -> value <= targetLong;
    }

    /**
     * 
     *
     * @param minValue 
     * @param maxValue 
     * @return 
     */
    static LongPredicate between(long minValue, long maxValue) {
        return value -> value > minValue && value < maxValue;
    }
}