CKTIS / Java
StringJoiner — združevanje elementov z ločilom
StringJoiner gradi besedilo z ločilom, predpono in pripono. merge ohrani notranje ločilo dodane vsebine.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
new StringJoiner(delimiter, prefix, suffix)
joiner.add(element)
joiner.merge(other)
joiner.toString()java.util.StringJoiner združuje elemente. StringJoiner(CharSequence,CharSequence,CharSequence) v tem vrstnem redu sprejme ločilo, predpono in pripono; kopira jih, pri vrednosti null pa sproži NullPointerException.
add(CharSequence) kopira element; null postane besedilo "null". Tako add kot merge vrneta ciljni objekt, zato je mogoče klice verižiti.
merge(StringJoiner) doda neprazno vsebino kot en element. Pri tem izpusti njeno predpono in pripono, ohrani pa njeno notranje ločilo. Prazen argument ne spremeni ničesar; null povzroči NullPointerException.
toString() vrne omejeno besedilo. Če ni elementov, vrne prefix + suffix, razen če to vrednost prepiše setEmptyValue. Klic add("") povzroči, da joiner ni več prazen.
Referenčni identifikatorji, zajeti v tem geslu: StringJoiner.add, StringJoiner.merge, StringJoiner.toString.
Primeri
import java.util.StringJoiner;
public class Main {
public static void main(String[] args) {
StringJoiner result = new StringJoiner(", ", "[", "]");
System.out.println(result.toString());
result.add("A");
StringJoiner other = new StringJoiner("/", "(", ")");
other.add("B").add("C");
result.merge(other);
System.out.println(result.toString());
}
}Rezultat
[] [A, B/C]
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.