ParameterList
open class ParameterList : ListBase, Sequence, @unchecked Sendable
A list of item type Parameter.
-
Undocumented
Declaration
Swift
public subscript(index: Int) -> Parameter { get set } -
An immutable empty
ParameterList.Declaration
Swift
public static let empty: ParameterList -
Construct a new list with
lengthof zero and optional initialcapacity. A list can expand in length beyond its initial capacity, but best performance will be obtained if the initial capacity is close to (and not less than) the list’s maximum length.Declaration
Swift
override public init(capacity: Int = (4 as Int))Parameters
capacityOptional initial capacity.
-
Add a formal parameter.
See also
with.Declaration
Swift
open func addFormal(name: String, type: DataType)Parameters
nameParameter name.
typeParameter type.
-
Add
itemto the end of this list.Declaration
Swift
public final func append(_ item: Parameter)Parameters
itemItem to be added.
-
Add all the items of
listto the end of this list.Declaration
Swift
public final func append(contentsOf list: ParameterList)Parameters
listItems to be added.
-
Declaration
Swift
public final func copy() -> ParameterListReturn Value
A shallow copy of this list.
-
Declaration
Swift
override open func copyMutable() -> DataValueReturn Value
a copy of this list which doesn’t share any mutable values with this list. The resulting list will not share any mutable values with this list. The resulting list might share immutable values with this list.
-
Declaration
Swift
public final func filter(_ predicate: @escaping (Parameter) -> Bool) -> ParameterListParameters
predicateFunction to be applied to each item of this list. Items matching this predicate will be returned in the new list.
Return Value
A new list which contains the items of this list that match a specified predicate function. Ordering is preserved.
-
Throws
EmptyListExceptionif the list is empty.Declaration
Swift
public final func first() -> ParameterReturn Value
The first item in this list.
-
Convert array to list.
Declaration
Swift
open class func fromArray(_ array: Array<Parameter>) -> ParameterListParameters
arrayArray with source items.
Return Value
New list with items copied from
arrayparameter. -
Declaration
Swift
public final func indexOf(item: Parameter, start: Int = (0 as Int)) -> IntParameters
itemItem for comparison. Comparison uses the
equalityproperty, which would usually be expected to match the==operator for item typeParameter.startZero-based starting index (search moves forwards from this index).
Return Value
First index in this list of
item, or-1if not found. -
Insert
iteminto this list, before the item (if any) atindex.Throws
ListIndexExceptionifindexis out of range (0 tolength).Declaration
Swift
public final func insert(at index: Int, item: Parameter)Parameters
indexZero-based index.
itemItem to be added.
-
Insert all items of
listinto this list, before the item (if any) atindex.Throws
ListIndexExceptionifindexis out of range (0 tolength).Declaration
Swift
public final func insert(at index: Int, contentsOf list: ParameterList)Parameters
indexZero-based index.
listList of items to be inserted.
-
Throws
ListIndexExceptionifindexis out of range (0 tolength- 1).Declaration
Swift
public final func item(at index: Int) -> ParameterParameters
indexZero-based index.
Return Value
The item in this list at the specified
index. -
Throws
EmptyListExceptionif the list is empty.Declaration
Swift
public final func last() -> ParameterReturn Value
The last item in this list.
-
Declaration
Swift
public final func lastIndexOf(item: Parameter, start: Int = (2147483647 as Int)) -> IntParameters
itemItem for comparison. Comparison uses the
equalityproperty, which would usually be expected to match the==operator for item typeParameter.startZero-based starting index (search moves backwards from this index).
Return Value
Last index in this list of
item, or-1if not found. -
Declaration
Swift
open func makeIterator() -> IndexingIterator<Array<Parameter>>Return Value
This list converted to a Swift iterator.
-
Removed the parameter with the specified
name.Declaration
Swift
open func remove(name: String) -> BoolParameters
nameName of parameter to be removed.
Return Value
trueif a parameter with the specified name was found (and removed), otherwise false. -
Declaration
Swift
open func required(name: String) -> DataValue?Parameters
nameRequired parameter name.
Return Value
the value of a required parameter, or throw
DataServiceExceptionwith status 400 (Client Error) if the parameter is missing. -
Declaration
Swift
open func requiredList(name: String) -> ListBaseParameters
nameRequired parameter name.
Return Value
the value of a required parameter with list type, or throw
DataServiceExceptionwith status 400 (Client Error) if the parameter is missing. -
See also
copy,reverse.Declaration
Swift
open func reversed() -> ParameterListReturn Value
a reversed copy of this list.
-
Return a new
ParameterListthat shares theListBase.untypedListas thelistparameter. To ensure type safety, items inlistthat do not have the item typeParameterwill be removed.Declaration
Swift
open class func share(_ list: ListBase) -> ParameterListParameters
listList whose items will be shared by the resulting list.
Return Value
A new list of item type
Parameter, sharing the same items aslist. -
Throws
EmptyListExceptionif the list has no items,NotUniqueExceptionif the list has multiple items.Declaration
Swift
public final func single() -> ParameterReturn Value
A single item from this list.
-
Declaration
Swift
public final func slice(start: Int, end: Int = (2147483647 as Int)) -> ParameterListParameters
startZero-based starting index (inclusive), or negative for starting index relative to the end of this list.
endZero-based ending index (exclusive), or negative for ending index relative to the end of this list.
Return Value
A slice of this list from index
start(inclusive) to indexend(exclusive). -
Sort this list in place (stable sort, O(n log n) complexity).
See also
copy,sort.Parameters
increasingPredicate that returns
trueif its first argument should preceed its second argument in the desired ordering. -
See also
copy,sort.Declaration
Swift
public final func sorted() -> ParameterListReturn Value
a sorted copy of this list using this list’s default
comparerfor ordering (stable sort, O(n log n) complexity). -
See also
copy,sortBy.Declaration
Parameters
increasingPredicate that returns
trueif its first argument should preceed its second argument in the desired ordering.Return Value
a sorted copy of this list (stable sort, O(n log n) complexity).
-
Declaration
Swift
open func toArray() -> Array<Parameter>Return Value
This list converted to a Swift array.
-
Declaration
Swift
open func toNameList() -> StringListReturn Value
A list with the
Parameter.namefor each parameter in this list. -
Set the item in this list at the specified
index.Declaration
Swift
public final func update(at index: Int, item: Parameter)Parameters
indexZero-based index.
itemItem value.
-
See also
add.Declaration
Swift
open func with(name: String, value: DataValue?) -> ParameterListParameters
nameParameter name.
valueParameter value.
Return Value
This list after adding an actual parameter.