Record Class BitwiseOpNode

java.lang.Object
java.lang.Record
cloud.opencode.base.expression.ast.BitwiseOpNode
Record Components:
operator - the bitwise operator | 位运算符
left - the left operand (or sole operand for ~) | 左操作数（~ 运算的唯一操作数）
right - the right operand (null for ~) | 右操作数（~ 运算时为 null）
All Implemented Interfaces:
Node
public record BitwiseOpNode(String operator, Node left, Node right) extends Record implements Node
Bitwise Operation Node 位运算节点

Represents bitwise operations: AND, OR, XOR, NOT, left shift, right shift.

表示位运算：与、或、异或、取反、左移、右移。

Features | 主要功能:

  • Binary bitwise: &, |, ^, <<, >> - 二元位运算
  • Unary bitwise NOT: ~ - 一元位取反
  • Operands converted to long for computation - 操作数转换为 long 进行计算

Usage Examples | 使用示例:

// 0xFF & 0x0F
Node and = BitwiseOpNode.of(leftNode, "&", rightNode);
Object result = and.evaluate(ctx);  // 15L

// ~value
Node not = BitwiseOpNode.ofNot(operandNode);
Object result2 = not.evaluate(ctx);

Security | 安全性:

  • Thread-safe: Yes, immutable record - 线程安全: 是，不可变记录
  • Null-safe: No, operator and left required non-null; right nullable only for ~ - 空值安全: 否，运算符和左操作数要求非空；右操作数仅在 ~ 时可为空
  • Type-safe: Throws exception for non-integer types - 类型安全：非整数类型抛出异常
Since:
JDK 25, opencode-base-expression V1.0.3
Author:
Leon Soo www.LeonSoo.com
See Also:

  • Constructor Details

    • BitwiseOpNode

      public BitwiseOpNode(String operator, Node left, Node right)
      Creates an instance of a BitwiseOpNode record class.
      Parameters:
      operator - the value for the operator record component
      left - the value for the left record component
      right - the value for the right record component

  • Method Details

    • of

      public static BitwiseOpNode of(Node left, String operator, Node right)
      Create binary bitwise operation node 创建二元位运算节点
      Parameters:
      left - the left operand | 左操作数
      operator - the operator string (&, |, ^, <<, >>) | 运算符字符串
      right - the right operand | 右操作数
      Returns:
      the bitwise operation node | 位运算节点

    • ofNot

      public static BitwiseOpNode ofNot(Node operand)
      Create unary bitwise NOT node 创建一元位取反节点
      Parameters:
      operand - the operand | 操作数
      Returns:
      the bitwise NOT node | 位取反节点

    • evaluate

      public Object evaluate(EvaluationContext context)
      Description copied from interface: Node
      Evaluate this node 求值此节点
      Specified by:
      evaluate in interface Node
      Parameters:
      context - the evaluation context | 求值上下文
      Returns:
      the evaluation result | 求值结果

    • toExpressionString

      public String toExpressionString()
      Description copied from interface: Node
      Get string representation for debugging 获取用于调试的字符串表示
      Specified by:
      toExpressionString in interface Node
      Returns:
      the string representation | 字符串表示

    • toString

      public final String toString()
      Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.
      Specified by:
      toString in class Record
      Returns:
      a string representation of this object

    • hashCode

      public final int hashCode()
      Returns a hash code value for this object. The value is derived from the hash code of each of the record components.
      Specified by:
      hashCode in class Record
      Returns:
      a hash code value for this object

    • equals

      public final boolean equals(Object o)
      Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. All components in this record class are compared with Objects::equals(Object,Object).
      Specified by:
      equals in class Record
      Parameters:
      o - the object with which to compare
      Returns:
      true if this object is the same as the o argument; false otherwise.

    • operator

      public String operator()
      Returns the value of the operator record component.
      Returns:
      the value of the operator record component

    • left

      public Node left()
      Returns the value of the left record component.
      Returns:
      the value of the left record component

    • right

      public Node right()
      Returns the value of the right record component.
      Returns:
      the value of the right record component