mirror of
https://github.com/openjdk/jdk.git
synced 2026-02-10 18:38:27 +00:00
756dd5bb0d
8294945: Compiler implementation for Pattern Matching for switch (Fourth Preview) Co-authored-by: Aggelos Biboudis <abimpoudis@openjdk.org> Co-authored-by: Maurizio Cimadamore <mcimadamore@openjdk.org> Reviewed-by: mcimadamore, vromero
105 lines
3.1 KiB
Java
105 lines
3.1 KiB
Java
/*
|
|
* Copyright (c) 2005, 2020, Oracle and/or its affiliates. All rights reserved.
|
|
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
|
*
|
|
* This code is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License version 2 only, as
|
|
* published by the Free Software Foundation. Oracle designates this
|
|
* particular file as subject to the "Classpath" exception as provided
|
|
* by Oracle in the LICENSE file that accompanied this code.
|
|
*
|
|
* This code is distributed in the hope that it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
* version 2 for more details (a copy is included in the LICENSE file that
|
|
* accompanied this code).
|
|
*
|
|
* You should have received a copy of the GNU General Public License version
|
|
* 2 along with this work; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*
|
|
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
|
* or visit www.oracle.com if you need additional information or have any
|
|
* questions.
|
|
*/
|
|
|
|
package com.sun.source.tree;
|
|
|
|
import jdk.internal.javac.PreviewFeature;
|
|
|
|
/**
|
|
* A tree node for an {@code instanceof} expression.
|
|
*
|
|
* For example:
|
|
* <pre>
|
|
* <em>expression</em> instanceof <em>type</em>
|
|
* </pre>
|
|
*
|
|
* @jls 15.20.2 Type Comparison Operator instanceof
|
|
*
|
|
* @author Peter von der Ahé
|
|
* @author Jonathan Gibbons
|
|
* @since 1.6
|
|
*/
|
|
public interface InstanceOfTree extends ExpressionTree {
|
|
|
|
/**
|
|
* Two possible variants of instanceof expressions:
|
|
* <ul>
|
|
* <li> testing types, and
|
|
* <li> performing pattern matching
|
|
* </ul>
|
|
* @since 20
|
|
*/
|
|
@PreviewFeature(feature=PreviewFeature.Feature.RECORD_PATTERNS, reflective=true)
|
|
public enum TestKind {
|
|
/** instanceof only testing a type */
|
|
TYPE,
|
|
/** instanceof doing a pattern matching */
|
|
PATTERN
|
|
}
|
|
|
|
/**
|
|
* Returns the expression to be tested.
|
|
* @return the expression
|
|
*/
|
|
ExpressionTree getExpression();
|
|
|
|
/**
|
|
* Returns the type for which to check.
|
|
* @return the type
|
|
* @see #getPattern()
|
|
*/
|
|
Tree getType();
|
|
|
|
/**
|
|
* Returns the tested pattern, or null if this instanceof does not use
|
|
* a pattern.
|
|
*
|
|
* <p>For instanceof with a pattern, i.e. in the following form:
|
|
* <pre>
|
|
* <em>expression</em> instanceof <em>type</em> <em>variable name</em>
|
|
* </pre>
|
|
* returns the pattern.
|
|
*
|
|
* <p>For instanceof without a pattern, i.e. in the following form:
|
|
* <pre>
|
|
* <em>expression</em> instanceof <em>type</em>
|
|
* </pre>
|
|
* returns null.
|
|
*
|
|
* @return the tested pattern, or null if this instanceof does not use a pattern
|
|
* @since 16
|
|
*/
|
|
PatternTree getPattern();
|
|
|
|
/**
|
|
* Returns the kind of this instanceof expression.
|
|
*
|
|
* @return the kind of this instanceof expression
|
|
* @since 20
|
|
*/
|
|
@PreviewFeature(feature=PreviewFeature.Feature.RECORD_PATTERNS, reflective=true)
|
|
TestKind getTestKind();
|
|
}
|