Protected _comparatorProtected _countProtected _loopProtected _rootProtected _sizeProtected _visitedProtected _visitedProtected _visitedProtected _visitedProtected _visitedThe BFS function performs a breadth-first search on a binary tree and returns the results based on a specified node or property name.
an object of type ResultsByProperty<T>.
The BFS function performs a breadth-first search on a binary tree and returns the results based on a specified node or property name.
The parameter nodeOrPropertyName is an optional parameter that
represents either a node or a property name. If a node is provided, the breadth-first search algorithm will be
performed starting from that node. If a property name is provided, the breadth-first search algorithm will be
performed starting from the root node
an object of type ResultsByProperty<T>.
The BFS function performs a breadth-first search on a binary tree and returns the results based on a specified node or property name.
The parameter nodeOrPropertyName is an optional parameter that
represents either a node or a property name. If a node is provided, the breadth-first search algorithm will be
performed starting from that node. If a property name is provided, the breadth-first search algorithm will be
performed starting from the root node
an object of type ResultsByProperty<T>.
The BFS function performs a breadth-first search on a binary tree and returns the results based on a specified node or property name.
The parameter nodeOrPropertyName is an optional parameter that
represents either a node or a property name. If a node is provided, the breadth-first search algorithm will be
performed starting from that node. If a property name is provided, the breadth-first search algorithm will be
performed starting from the root node
an object of type ResultsByProperty<T>.
The BFS function performs a breadth-first search on a binary tree and returns the results based on a specified node or property name.
The parameter nodeOrPropertyName is an optional parameter that
represents either a node or a property name. If a node is provided, the breadth-first search algorithm will be
performed starting from that node. If a property name is provided, the breadth-first search algorithm will be
performed starting from the root node
an object of type ResultsByProperty<T>.
The DFS function performs a depth-first search traversal on a binary tree and returns the results based on the specified pattern and node or property name.
an object of type ResultsByProperty<T>.
The DFS function performs a depth-first search traversal on a binary tree and returns the results based on the specified pattern and node or property name.
Optional pattern: DFSOrderPatternThe "pattern" parameter is used to specify the order in which the nodes of a binary tree are traversed during the Depth-First Search (DFS) algorithm. It can take one of three values: 'in', 'pre', or 'post'.
Optional nodeOrPropertyName: "id"The nodeOrPropertyName parameter is a string that represents
either the name of a property in the BinaryTreeNode object or the value of the id property in the
BinaryTreeNode object. This parameter is used to accumulate the results based on the specified property name. If
no value
an object of type ResultsByProperty<T>.
The DFS function performs a depth-first search traversal on a binary tree and returns the results based on the specified pattern and node or property name.
Optional pattern: DFSOrderPatternThe "pattern" parameter is used to specify the order in which the nodes of a binary tree are traversed during the Depth-First Search (DFS) algorithm. It can take one of three values: 'in', 'pre', or 'post'.
Optional nodeOrPropertyName: "val"The nodeOrPropertyName parameter is a string that represents
either the name of a property in the BinaryTreeNode object or the value of the id property in the
BinaryTreeNode object. This parameter is used to accumulate the results based on the specified property name. If
no value
an object of type ResultsByProperty<T>.
The DFS function performs a depth-first search traversal on a binary tree and returns the results based on the specified pattern and node or property name.
Optional pattern: DFSOrderPatternThe "pattern" parameter is used to specify the order in which the nodes of a binary tree are traversed during the Depth-First Search (DFS) algorithm. It can take one of three values: 'in', 'pre', or 'post'.
Optional nodeOrPropertyName: "node"The nodeOrPropertyName parameter is a string that represents
either the name of a property in the BinaryTreeNode object or the value of the id property in the
BinaryTreeNode object. This parameter is used to accumulate the results based on the specified property name. If
no value
an object of type ResultsByProperty<T>.
The DFS function performs a depth-first search traversal on a binary tree and returns the results based on the specified pattern and node or property name.
Optional pattern: DFSOrderPatternThe "pattern" parameter is used to specify the order in which the nodes of a binary tree are traversed during the Depth-First Search (DFS) algorithm. It can take one of three values: 'in', 'pre', or 'post'.
Optional nodeOrPropertyName: "count"The nodeOrPropertyName parameter is a string that represents
either the name of a property in the BinaryTreeNode object or the value of the id property in the
BinaryTreeNode object. This parameter is used to accumulate the results based on the specified property name. If
no value
an object of type ResultsByProperty<T>.
Time complexity is O(n) Space complexity of Iterative DFS equals to recursive DFS which is O(n) because of the stack
Time complexity is O(n) Space complexity of Iterative DFS equals to recursive DFS which is O(n) because of the stack
Optional pattern: DFSOrderPatternOptional nodeOrPropertyName: "id"Time complexity is O(n) Space complexity of Iterative DFS equals to recursive DFS which is O(n) because of the stack
Optional pattern: DFSOrderPatternOptional nodeOrPropertyName: "val"Time complexity is O(n) Space complexity of Iterative DFS equals to recursive DFS which is O(n) because of the stack
Optional pattern: DFSOrderPatternOptional nodeOrPropertyName: "node"Time complexity is O(n) Space complexity of Iterative DFS equals to recursive DFS which is O(n) because of the stack
Optional pattern: DFSOrderPatternOptional nodeOrPropertyName: "count"Protected _accumulatedThe function _accumulatedByPropertyName pushes a property value of a binary tree node into an array based on the
provided property name or a default property name.
The node parameter is of type BinaryTreeNode<T>, which represents a node in a binary tree.
Optional nodeOrPropertyName: NodeOrPropertyNameThe parameter nodeOrPropertyName is an optional parameter that
can be either a string representing a property name or a reference to a node object. If it is a string, it specifies
the property name of the node that should be accumulated. If it is a node object, it specifies the node itself
Protected _compareThe function compares two binary tree node IDs using a comparator function and returns whether the first ID is greater than, less than, or equal to the second ID.
a is a BinaryTreeNodeId, which represents the identifier of a binary tree node.
The parameter "b" in the above code refers to a BinaryTreeNodeId.
a value of type CP (ComparisonResult). The possible return values are CP.gt (greater than), CP.lt (less than), or CP.eq (equal).
Protected _getThe function _getResultByPropertyName returns different results based on the provided property name or defaulting
to 'id'.
Optional nodeOrPropertyName: NodeOrPropertyNameThe parameter nodeOrPropertyName is an optional parameter that
can accept a value of type NodeOrPropertyName.
The method returns an object of type ResultsByProperty<T>.
Protected _pushThe function checks if a given property of a binary tree node matches a specified value, and if so, adds the node to a result array.
The current binary tree node that is being checked.
An array that stores the matching nodes found during the traversal.
The nodeProperty parameter is the value that we are searching for in
the binary tree nodes. It can be either the id, count, or val property of the node.
Optional propertyName: BinaryTreeNodePropertyNameThe propertyName parameter is an optional parameter that
specifies the property of the BinaryTreeNode object that you want to compare with the nodeProperty value. It can
be one of the following values: 'id', 'count', or 'val'. If no propertyName is provided,
Optional onlyOne: booleanThe onlyOne parameter is an optional boolean parameter that determines whether to
stop after finding the first matching node or continue searching for all matching nodes. If onlyOne is set to
true, the function will stop after finding the first matching node and return true. If `onlyOne
a boolean value indicating whether or not a node was pushed into the result array.
Protected _resetThe add function inserts a new node into a binary search tree, updating the count and value of an existing node if
the ID matches, and returns the inserted node.
The id parameter represents the identifier of the binary tree node. It is used to
determine the position of the node in the binary search tree.
The val parameter represents the value to be stored in the binary search tree node. It can
be of type T (the generic type) or null.
Optional count: number = 1The count parameter represents the number of times the value should be inserted into
the binary search tree. By default, it is set to 1, meaning that if no count is specified, the value will be
inserted once.
The method add returns a BSTNode<T> object or null.
The addMany function inserts multiple items into a binary tree and returns an array of the inserted nodes or
null/undefined values.
The data parameter can be either an array of elements of type T or an
array of BinaryTreeNode<T> objects.
The function addMany returns an array of BinaryTreeNode<T>, null, or undefined values.
The function inserts a new node into a binary tree as the left or right child of a given parent node.
The newNode parameter is an instance of the BinaryTreeNode class or
null. It represents the node that needs to be inserted into the binary tree.
The parent parameter is a BinaryTreeNode object representing the parent node to which the new node
will be inserted as a child.
The method returns the newly inserted node, either as the left child or the right child of the parent node.
The function allGreaterNodesAdd updates the value of a specified property for all nodes in a binary search tree
that have a greater value than a given node.
The node parameter is of type BSTNode<T>, which represents a node in a binary search tree. It
contains properties such as id and count.
The delta parameter is a number that represents the amount by which the property value of
each node should be increased.
Optional propertyName: BinaryTreeNodePropertyNamepropertyName is an optional parameter that specifies the property of the BSTNode to be modified. It can be either 'id' or 'count'. If propertyName is not provided, it defaults to 'id'.
a boolean value.
The function creates a new binary tree node with the given id, value, and count, or returns null if the value is null.
The id parameter is the identifier for the binary tree node. It is of type
BinaryTreeNodeId, which could be a string or a number, depending on how you want to identify your nodes.
The val parameter represents the value to be stored in the binary tree node. It can be of
any type T or null.
Optional count: numberThe count parameter is an optional parameter that represents the number of occurrences of the value in the binary tree node. It is of type number.
The function createNode returns a BinaryTreeNode<T> object if the val parameter is not null.
Otherwise, it returns null.
The fill function clears the current data and inserts new data, returning a boolean indicating if the insertion
was successful.
The data parameter can be either an array of elements of type T or an
array of BinaryTreeNode<T> objects.
The method is returning a boolean value.
The get function returns the first node in a binary search tree that matches the given property value or name.
The nodeProperty parameter can be either a BinaryTreeNodeId or a
generic type T. It represents the value of the property that you want to search for in the binary search tree.
Optional propertyName: BinaryTreeNodePropertyNameThe propertyName parameter is an optional parameter that
specifies the property name to use for searching the binary search tree nodes. If not provided, it defaults to
'id'.
The method is returning a BSTNode
The function calculates the depth of a binary tree node by traversing its parent nodes.
BinaryTreeNode
The depth of the given binary tree node.
The getHeight function calculates the maximum height of a binary tree using either a recursive or iterative
approach.
Optional beginRoot: null | BinaryTreeNode<T>The beginRoot parameter is an optional parameter of type
BinaryTreeNode<T> | null. It represents the starting node from which to calculate the height of the binary tree.
If no value is provided for beginRoot, the function will use the root property of the class instance as
the height of the binary tree.
The getLeftMost function returns the leftmost node in a binary tree, either recursively or iteratively using tail
recursion optimization.
The getLeftMost function returns the leftmost node in a binary tree.
The getLeftMost function returns the leftmost node in a binary tree, either recursively or iteratively using tail
recursion optimization.
The node parameter is an optional parameter of type BinaryTreeNode<T> | null. It represents the starting node from which to find the leftmost node in a binary tree. If no node is
provided, the function will use the root node of the binary tree.
The getLeftMost function returns the leftmost node in a binary tree.
The getMinHeight function calculates the minimum height of a binary tree using either a recursive or iterative
approach.
Optional beginRoot: null | BinaryTreeNode<T>The beginRoot parameter is an optional parameter of type
BinaryTreeNode<T> | null. It represents the starting node from which to calculate the minimum height of the binary
tree. If no value is provided for beginRoot, the function will use the root node of the binary tree.
The function getMinHeight returns the minimum height of the binary tree.
The function getNodes returns an array of binary search tree nodes that match a given property value, with the
option to specify the property name and whether to return only one node.
The nodeProperty parameter can be either a BinaryTreeNodeId or a
generic type T. It represents the property value that you want to search for in the binary search tree.
Optional propertyName: BinaryTreeNodePropertyNameThe propertyName parameter is an optional parameter that
specifies the property of the nodes to compare with the nodeProperty parameter. If not provided, it defaults to
'id'.
Optional onlyOne: booleanA boolean value indicating whether to return only one node that matches the given nodeProperty. If set to true, the function will stop traversing the tree and return the first matching node. If set to false or not provided, the function will return all nodes that match the given nodeProperty.
an array of BSTNode
The function getPathToRoot returns an array of BinaryTreeNode objects representing the path from a given node to the root of a binary tree.
The node parameter is a BinaryTreeNode object.
The function getPathToRoot returns an array of BinaryTreeNode<T> objects, representing the path from
the given node to the root of the binary tree.
The function returns the predecessor of a given node in a binary tree.
The parameter node is a BinaryTreeNode object, representing a node in a binary tree.
the predecessor of the given node in a binary tree.
The getRightMost function returns the rightmost node in a binary tree, either recursively or iteratively using
tail recursion optimization.
The getRightMost function returns the rightmost node in a binary tree.
The getRightMost function returns the rightmost node in a binary tree, either recursively or iteratively using
tail recursion optimization.
The node parameter is an optional parameter of type BinaryTreeNode<T> | null. It represents the starting node from which to find the rightmost node in a binary tree. If no node is
provided, the function will use the root node of the binary tree.
The getRightMost function returns the rightmost node in a binary tree.
The function calculates the size and count of a subtree in a binary tree using either recursive or iterative traversal.
The subTreeRoot parameter is the root node of a binary
tree.
The function getSubTreeSizeAndCount returns an array [number, number]. The first element of the array
represents the size of the subtree, and the second element represents the count of the nodes in the subtree.
The function checks if a binary tree node has a specific property or if any node in the tree has a specific property.
The nodeProperty parameter can be either a BinaryTreeNodeId or a
generic type T. It represents the property of a binary tree node that you want to check.
Optional propertyName: BinaryTreeNodePropertyNameThe propertyName parameter is an optional parameter that
specifies the name of the property to check for in the nodes.
a boolean value.
The function isAVLBalanced checks if a binary search tree is balanced according to the AVL tree property.
The function isAVLBalanced() returns a boolean value. It returns true if the binary search tree (BST)
is balanced according to the AVL tree property, and false otherwise.
The isBST function checks if a binary tree is a binary search tree.
Optional node: null | BinaryTreeNode<T>The node parameter is an optional parameter of type BinaryTreeNode<T> | null. It represents the root node of the binary search tree (BST) that we want to check for validity. If no node
is provided, the function will default to using the root node of the BST instance that
The isBST function returns a boolean value. It returns true if the binary tree is a valid binary search
tree, and false otherwise.
The function checks if a binary tree is balanced by comparing the minimum height and the maximum height of the tree.
Optional beginRoot: null | BinaryTreeNode<T>The beginRoot parameter is the root node of a binary tree. It is
of type BinaryTreeNode<T> | null, which means it can either be a BinaryTreeNode object or null.
The method is returning a boolean value.
The function returns the id of the rightmost node if the comparison between two values is less than, the id of the leftmost node if the comparison is greater than, and the id of the rightmost node otherwise.
The function lastKey() returns the ID of the rightmost node in a binary tree. If the comparison between
the first two elements in the tree is less than, it returns the ID of the rightmost node. If the comparison is
greater than, it returns the ID of the leftmost node. Otherwise, it also returns the ID of the rightmost node. If
there are no nodes in
The lesserSum function calculates the sum of a specified property in all nodes with an ID less than a given ID in
a binary search tree.
The id parameter is the identifier of the binary tree node for which you want to
calculate the lesser sum.
Optional propertyName: BinaryTreeNodePropertyNameThe propertyName parameter is an optional parameter that
specifies the property of the binary tree node to use for calculating the sum. If not provided, it defaults to 'id'.
The function lesserSum returns a number, which represents the sum of the values of the nodes in the
binary search tree that have a property value lesser than the given id.
The levelIterative function performs a level-order traversal on a binary tree and returns the values of the nodes
in an array, based on a specified property name.
The node parameter is a BinaryTreeNode object representing the starting
node for the level order traversal. It can be null if no specific node is provided, in which case the root node of
the tree is used as the starting node.
The function levelIterative returns an object of type ResultsByProperty<T>.
The levelIterative function performs a level-order traversal on a binary tree and returns the values of the nodes
in an array, based on a specified property name.
The node parameter is a BinaryTreeNode object representing the starting
node for the level order traversal. It can be null if no specific node is provided, in which case the root node of
the tree is used as the starting node.
Optional nodeOrPropertyName: "id"The nodeOrPropertyName parameter is an optional parameter that
can be either a BinaryTreeNode property name or the string 'id'. If a property name is provided, the function
will accumulate results based on that property. If no property name is provided, the function will default to
accumulating results
The function levelIterative returns an object of type ResultsByProperty<T>.
The levelIterative function performs a level-order traversal on a binary tree and returns the values of the nodes
in an array, based on a specified property name.
The node parameter is a BinaryTreeNode object representing the starting
node for the level order traversal. It can be null if no specific node is provided, in which case the root node of
the tree is used as the starting node.
Optional nodeOrPropertyName: "val"The nodeOrPropertyName parameter is an optional parameter that
can be either a BinaryTreeNode property name or the string 'id'. If a property name is provided, the function
will accumulate results based on that property. If no property name is provided, the function will default to
accumulating results
The function levelIterative returns an object of type ResultsByProperty<T>.
The levelIterative function performs a level-order traversal on a binary tree and returns the values of the nodes
in an array, based on a specified property name.
The node parameter is a BinaryTreeNode object representing the starting
node for the level order traversal. It can be null if no specific node is provided, in which case the root node of
the tree is used as the starting node.
Optional nodeOrPropertyName: "node"The nodeOrPropertyName parameter is an optional parameter that
can be either a BinaryTreeNode property name or the string 'id'. If a property name is provided, the function
will accumulate results based on that property. If no property name is provided, the function will default to
accumulating results
The function levelIterative returns an object of type ResultsByProperty<T>.
The levelIterative function performs a level-order traversal on a binary tree and returns the values of the nodes
in an array, based on a specified property name.
The node parameter is a BinaryTreeNode object representing the starting
node for the level order traversal. It can be null if no specific node is provided, in which case the root node of
the tree is used as the starting node.
Optional nodeOrPropertyName: "count"The nodeOrPropertyName parameter is an optional parameter that
can be either a BinaryTreeNode property name or the string 'id'. If a property name is provided, the function
will accumulate results based on that property. If no property name is provided, the function will default to
accumulating results
The function levelIterative returns an object of type ResultsByProperty<T>.
The listLevels function collects nodes from a binary tree by a specified property and organizes them into levels.
The node parameter is a BinaryTreeNode object or null. It represents the
root node of a binary tree. If it is null, the function will use the root node of the current binary tree instance.
The function listLevels returns a 2D array of ResultByProperty<T> objects.
The listLevels function collects nodes from a binary tree by a specified property and organizes them into levels.
The node parameter is a BinaryTreeNode object or null. It represents the
root node of a binary tree. If it is null, the function will use the root node of the current binary tree instance.
Optional nodeOrPropertyName: "id"The nodeOrPropertyName parameter is an optional parameter that
specifies the property of the BinaryTreeNode object to collect at each level. It can be one of the following
values:
The function listLevels returns a 2D array of ResultByProperty<T> objects.
The listLevels function collects nodes from a binary tree by a specified property and organizes them into levels.
The node parameter is a BinaryTreeNode object or null. It represents the
root node of a binary tree. If it is null, the function will use the root node of the current binary tree instance.
Optional nodeOrPropertyName: "val"The nodeOrPropertyName parameter is an optional parameter that
specifies the property of the BinaryTreeNode object to collect at each level. It can be one of the following
values:
The function listLevels returns a 2D array of ResultByProperty<T> objects.
The listLevels function collects nodes from a binary tree by a specified property and organizes them into levels.
The node parameter is a BinaryTreeNode object or null. It represents the
root node of a binary tree. If it is null, the function will use the root node of the current binary tree instance.
Optional nodeOrPropertyName: "node"The nodeOrPropertyName parameter is an optional parameter that
specifies the property of the BinaryTreeNode object to collect at each level. It can be one of the following
values:
The function listLevels returns a 2D array of ResultByProperty<T> objects.
The listLevels function collects nodes from a binary tree by a specified property and organizes them into levels.
The node parameter is a BinaryTreeNode object or null. It represents the
root node of a binary tree. If it is null, the function will use the root node of the current binary tree instance.
Optional nodeOrPropertyName: "count"The nodeOrPropertyName parameter is an optional parameter that
specifies the property of the BinaryTreeNode object to collect at each level. It can be one of the following
values:
The function listLevels returns a 2D array of ResultByProperty<T> objects.
The morris function performs an in-order, pre-order, or post-order traversal on a binary tree using the Morris
traversal algorithm and returns the results based on the specified property name.
The time complexity of Morris traversal is O(n), it's may slower than others
The space complexity Morris traversal is O(1) because no using stack
The function morris returns an object of type ResultsByProperty<T>.
The morris function performs an in-order, pre-order, or post-order traversal on a binary tree using the Morris
traversal algorithm and returns the results based on the specified property name.
The time complexity of Morris traversal is O(n), it's may slower than others
The space complexity Morris traversal is O(1) because no using stack
Optional pattern: DFSOrderPatternThe pattern parameter is an optional parameter that determines the
traversal pattern of the binary tree. It can have one of three values:
Optional nodeOrPropertyName: "id"The nodeOrPropertyName parameter is used to specify the
property of the nodes that you want to retrieve in the results. It can be either the node itself or the name of the
property. If not provided, it defaults to 'id'.
The function morris returns an object of type ResultsByProperty<T>.
The morris function performs an in-order, pre-order, or post-order traversal on a binary tree using the Morris
traversal algorithm and returns the results based on the specified property name.
The time complexity of Morris traversal is O(n), it's may slower than others
The space complexity Morris traversal is O(1) because no using stack
Optional pattern: DFSOrderPatternThe pattern parameter is an optional parameter that determines the
traversal pattern of the binary tree. It can have one of three values:
Optional nodeOrPropertyName: "val"The nodeOrPropertyName parameter is used to specify the
property of the nodes that you want to retrieve in the results. It can be either the node itself or the name of the
property. If not provided, it defaults to 'id'.
The function morris returns an object of type ResultsByProperty<T>.
The morris function performs an in-order, pre-order, or post-order traversal on a binary tree using the Morris
traversal algorithm and returns the results based on the specified property name.
The time complexity of Morris traversal is O(n), it's may slower than others
The space complexity Morris traversal is O(1) because no using stack
Optional pattern: DFSOrderPatternThe pattern parameter is an optional parameter that determines the
traversal pattern of the binary tree. It can have one of three values:
Optional nodeOrPropertyName: "node"The nodeOrPropertyName parameter is used to specify the
property of the nodes that you want to retrieve in the results. It can be either the node itself or the name of the
property. If not provided, it defaults to 'id'.
The function morris returns an object of type ResultsByProperty<T>.
The morris function performs an in-order, pre-order, or post-order traversal on a binary tree using the Morris
traversal algorithm and returns the results based on the specified property name.
The time complexity of Morris traversal is O(n), it's may slower than others
The space complexity Morris traversal is O(1) because no using stack
Optional pattern: DFSOrderPatternThe pattern parameter is an optional parameter that determines the
traversal pattern of the binary tree. It can have one of three values:
Optional nodeOrPropertyName: "count"The nodeOrPropertyName parameter is used to specify the
property of the nodes that you want to retrieve in the results. It can be either the node itself or the name of the
property. If not provided, it defaults to 'id'.
The function morris returns an object of type ResultsByProperty<T>.
The remove function in this TypeScript code removes a node from a binary search tree and returns information about
the deleted node and any nodes that need to be balanced.
The id parameter is the identifier of the binary tree node that needs to be removed
from the binary search tree.
Optional ignoreCount: booleanA boolean flag indicating whether to ignore the count of the node being removed. If set to true, the count of the node will not be considered and the node will be removed regardless of its count. If set to false or not provided, the count of the node will be taken into account and the
an array of BSTDeletedResult<T> objects.
The function subTreeAdd adds a specified delta value to a property of each node in a binary tree.
The subTreeRoot parameter is the root node of the subtree where the values will be modified.
The delta parameter is a number that represents the amount by which the property value of
each node in the subtree should be increased or decreased.
Optional propertyName: BinaryTreeNodePropertyNameThe propertyName parameter is an optional parameter that
specifies the property of the BinaryTreeNode that should be modified. It defaults to 'id' if not provided.
a boolean value, which is true.
The function subTreeSum calculates the sum of a specified property in a binary tree, either recursively or
iteratively.
The subTreeRoot parameter is the root node of the subtree for which you want to calculate the sum.
Optional propertyName: BinaryTreeNodePropertyNameThe propertyName parameter is an optional parameter that
specifies the property of the BinaryTreeNode object to use for calculating the sum. If propertyName is not
provided, it defaults to 'val'.
a number, which is the sum of the values of the nodes in the subtree rooted at subTreeRoot.
Generated using TypeDoc
The constructor function accepts an optional options object and sets the comparator property if provided.