Packages > pkl > pkl.base

Listing0.25.3

Overview
Properties
Methods

class Listing<out Element> extends Object

An object containing an ordered sequence of elements.

Known subtypes:
Known usages:
All versions:

Properties

link

hidden

default: (Int) -> Element

The function used to compute the default value for a listing element given its index.
link

length: Int

The number of elements in this listing.
link

isEmpty: Boolean

Tells if this listing is empty, that is, has zero elements.
link
isDistinct: Boolean

Tells if this listing has no duplicate elements.

Also known as:

isUnique
Facts:
```
new Listing { 1; 2; 3 }.isDistinct
!new Listing { 1; 2; 1 }.isDistinct
```
link
distinct: Listing<Element>

Removes duplicate elements from this listing, preserving the first occurrence.

Also known as:

unique
Facts:
```
new Listing { 1; 2; 3 }.distinct == new Listing { 1; 2; 3 }
new Listing { 1; 2; 1 }.distinct == new Listing { 1; 2 }
```

Methods(show inherited)

link

function

Any.getClass(): Class (pkl.base)

Returns the class of this.
link

function

Any.toString(): String (pkl.base)

Returns a string representation of this.

This method is used to convert the values of string interpolation expressions to strings.
link

function

Any.ifNonNull<Result>(transform: (NonNull) -> Result): Result? (pkl.base)

Returns this |> transform if this is non-null, and null otherwise.

This method is the complement of the ?? operator and the equivalent of an Option type's map and flatMap methods.
link

function
isDistinctBy(selector: (Element) -> Any): Boolean

Tells if this listing has no elements that are duplicates after applying selector.

Also known as:

isUniqueBy
Facts:
```
new Listing { "a"; "ab"; "abc" }.isDistinctBy((it) -> it.length)
!new Listing { "a"; "ab"; "c" }.isDistinctBy((it) -> it.length)
```
link

function
distinctBy(selector: (Element) -> Any): Listing<Element>

Removes elements that are duplicates after applying selector from this listing, preserving the first occurrence.

Also known as:

uniqueBy
Facts:
```
new Listing { "a"; "ab"; "abc" }.distinctBy((it) -> it.length) == new Listing { "a"; "ab"; "abc" }
new Listing { "a"; "ab"; "c" }.distinctBy((it) -> it.length) == new Listing { "a"; "ab" }
```
link

function

fold<Result>(initial: Result, operator: (Result, Element) -> Result): Result

Folds this listing in iteration order using operator, starting with initial.
link

function

foldIndexed<Result>(initial: Result, operator: (Int, Result, Element) -> Result): Result

Folds this listing in iteration order using operator, starting with initial.

The first parameter of operator is the zero-based index of the current element.
link

function

join(separator: String): String

Converts the elements of this listing to strings and concatenates them inserting separator between elements.
link

function

toList(): List<Element>

Converts this listing to a List.
link

function

toSet(): Set<Element>

Converts this listing to a Set.