JavaTuples - 三元組類



介紹

org.javatuples.Triplet 類表示一個包含三個元素的元組。

類宣告

以下是 org.javatuples.Triplet 類的宣告:

public final class Triplet<A,B,C>
   extends Tuple
      implements IValue0<A>, IValue1<B>, IValue2<C>

類建構函式

序號 建構函式及描述
1

Triplet(A value0, B value1, C value2)

這將建立一個三元組元組。

類方法

類似地,setAt1() 到 setAt2() 將值設定為索引 1 等等。

序號 方法及描述
1

Quartet add(Unit tuple)

此方法返回一個四元組元組。

類似地,還有其他新增元組的方法,例如 add(Pair tuple) 返回五元組,直到 add(Septet tuple) 返回十元組。

2

Quartet add(X0 value)

此方法向元組新增一個值並返回一個四元組元組。

類似地,還有其他新增值的方法,例如 add(X0 value0, X1 value1) 返回五元組,依此類推,直到 add() 帶有七個引數。

3

Quartet addAt0(Unit value)

此方法在索引 0 處新增一個單元元組並返回一個四元組元組。

類似地,還有其他新增元組的方法,例如 addAt0(Pair value) 返回五元組,依此類推,直到 addAt0(Septet)。其他類似的方法是 addAt1(Unit value),它在索引 0 處新增一個單元,並具有類似的方法,直到 addAt2(Septet)。

4

Quartet addAt0(X0 value)

此方法在索引 0 處新增一個值並返回一個四元組元組。

類似地,還有其他新增值的方法,例如 addAt0(X0 value0, X1 value1) 返回五元組,依此類推,直到 addAt0() 帶有七個引數。其他類似的方法是 addAt1(X0 value),它在索引 0 處新增一個值,並具有類似的方法,直到 addAt2() 帶有七個引數。

5

static <X> Triplet<X,X,X> fromArray(X[] array)

從陣列建立元組。

6

static <X> Triplet<X,X,X> fromCollection(Collection<X> collection)

從集合建立元組。

7

static <X> Triplet<X,X,X> fromIterable(Iterable<X> iterable)

從可迭代物件建立元組。

8

static <X> Triplet<X,X,X> fromIterable(Iterable<X> iterable, int index)

從可迭代物件建立元組,從指定的索引開始。

9

int getSize()

返回元組的大小。

10

A getValue0()

返回元組在索引 0 處的值。

類似地,getValue1() 到 getValue2() 返回索引 1 處的值,依此類推。

11

Pair<B,C> removeFrom0()

刪除元組在索引 0 處的值後返回元組。

類似地,removeFrom1() 到 removeFrom2() 刪除元組在索引 1 處的值後返回元組,依此類推。

12

<X> Triplet<X,B,C> setAt0(X value)

設定元組在索引 0 處的值。

13

static <A> Triplet<A,B,C> with(A value0, B value1, C value2)

使用給定值建立元組。

繼承的方法

此類繼承自以下類的方法:

  • org.javatuples.Tuple

  • Object

示例

讓我們看看三元組類在實際中的應用。在這裡,我們將瞭解如何使用各種方法。

C:\>JavaTuples 中建立一個名為 TupleTester 的 Java 類檔案。

檔案:TupleTester.java

package com.tutorialspoint;
import java.util.ArrayList;
import java.util.List;
import org.javatuples.Pair;
import org.javatuples.Quartet;
import org.javatuples.Triplet;

public class TupleTester {
   public static void main(String args[]){
      Triplet<Integer, Integer, Integer> triplet = Triplet.with(5, 6, 7);
      System.out.println(triplet);
      boolean isPresent = triplet.contains(5);
      System.out.println("5 is present: " + isPresent);
      List<Integer> list = new ArrayList<>();
      list.add(1);
      list.add(2);
      list.add(3);
      Quartet<Integer, Integer, Integer, String> quartet = triplet.add("Test");
      System.out.println(quartet);
      Integer value = triplet.getValue0();
      System.out.println(value);
      Pair<Integer, Integer> pair = triplet.removeFrom0();
      System.out.println(pair);
      Triplet<Integer, Integer, Integer> triplet1 = 
         Triplet.fromCollection(list);   
      System.out.println(triplet1);
   }
}

驗證結果

使用 javac 編譯器編譯類,如下所示:

C:\JavaTuples>javac -cp javatuples-1.2.jar ./com/tutorialspoint/TupleTester.java

現在執行 TupleTester 以檢視結果:

C:\JavaTuples>java  -cp .;javatuples-1.2.jar com.tutorialspoint.TupleTester

輸出

驗證輸出

[5, 6, 7]
5 is present: true
[5, 6, 7, Test]
5
[6, 7]
[1, 2, 3]
廣告