Skip to content

Commit 84b014b

Browse files
committed
Reduce and focus closure command examples
In this section of the language reference we want to explore and demonstrate examples of variance of use. The unnecessary layout separation (headlines, horizontal line separators) and command elaboration took away from that. This change focuses the examples into demonstrating different closure use cases and behaviors in the context of commands. It also adjusts the examples to have one code block with input and output. It also improves some code examples, like the sort-by actually doing some sorting, demonstrating. With the sometimes adjusted examples and documented output, the closure behavior does not need the redundant explanation.
1 parent 6dbce64 commit 84b014b

File tree

1 file changed

+25
-59
lines changed

1 file changed

+25
-59
lines changed

lang-guide/chapters/types/basic_types/closure.md

Lines changed: 25 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -111,78 +111,44 @@ Closures are used in Nu extensively as parameters to iteration style commands li
111111

112112
Here are a few select, concise examples to illustrate the broad use of closures with some of the aforementioned common Nushell commands:
113113

114-
#### `each` – Applying a transformation
115-
116114
The `each` command iterates over input, applying a closure to transform each item.
117115

118116
```nu
119-
[1 2 3] | each { |num| $num * 10 }
120-
```
121-
122-
_Explanation:_ This takes a list of numbers. The closure `{|num| $num * 10}` is executed for each number (`num`), multiplying it by 10.
123-
124-
**Output:**
125-
126-
```nu
127-
[10 20 30]
128-
```
129-
130-
---
131-
132-
#### `where` – Filtering data
133-
134-
The `where` command filters data based on a condition defined in a closure. The closure must return true (keep) or false (discard).
135-
136-
```nu
137-
ls | where { |file_info| $file_info.size > 1mb }
138-
```
139-
140-
_Explanation:_ This lists files and then filters them. The closure `{|file_info| $file_info.size > 1mb}` checks if each file's size is greater than 1 megabyte.
141-
142-
**Output:**
143-
144-
```nu
145-
# A table of files larger than 1MB
117+
[1 2 3] | each {|num| $num * 10 }
118+
# => ╭───┬────╮
119+
# => │ 0 │ 10 │
120+
# => │ 1 │ 20 │
121+
# => │ 2 │ 30 │
122+
# => ╰───┴────╯
146123
```
147124

148-
_Closure's role:_ Defines the operation to perform on every element.
149-
150-
---
151-
152-
#### `sort-by` – Custom sorting logic
153-
154-
The `sort-by` command sorts a list or table. The closure is used to extract or calculate the value to sort on for each item.
125+
The `where` command filters data based on the result of a closure (true: keep, false: reject).
155126

156127
```nu
157-
["kiwi" "apple" "banana"] | sort-by { |fruit_name| $fruit_name | str length }
128+
1..100 | where {|num| $num > 80 and $num < 86 }
129+
# => ╭───┬────╮
130+
# => │ 0 │ 81 │
131+
# => │ 1 │ 82 │
132+
# => │ 2 │ 83 │
133+
# => │ 3 │ 84 │
134+
# => │ 4 │ 85 │
135+
# => ╰───┴────╯
158136
```
159137

160-
_Explanation:_ This sorts a list of fruit names. The closure `{|fruit_name| $fruit_name | str length}` calculates the length of each fruit name. `sort-by` then uses these lengths for sorting.
161-
162-
**Output:**
138+
The `sort-by` command sorts a list or table. The closure determines and returns the sort key.
163139

164140
```nu
165-
["kiwi" "apple" "banana"] # sorted by string length: kiwi (4), apple (5), banana (6)
141+
["apple" "banana" "kiwi"] | sort-by {|fruit_name| $fruit_name | str length }
142+
# => ╭───┬────────╮
143+
# => │ 0 │ kiwi │
144+
# => │ 1 │ apple │
145+
# => │ 2 │ banana │
146+
# => ╰───┴────────╯
166147
```
167148

168-
_Closure's role:_ Specifies the attribute or derived value to use for comparison during sorting.
169-
170-
---
171-
172-
#### `reduce` – Aggregating values
173-
174-
The `reduce` command processes a list to accumulate a single result. The closure defines how to combine the current item with the accumulated value.
149+
The `reduce` command processes a list to accumulate a single result. The closure defines how to combine the current item with the (intermediate) accumulated value.
175150

176151
```nu
177-
[1 2 3 4] | reduce { |accumulator, current_value| $accumulator + $current_value }
152+
[1 2 3 4] | reduce {|accumulator, current_value| $accumulator + $current_value }
153+
# => 10
178154
```
179-
180-
_Explanation:_ This sums the numbers in the list. The closure `{|current_value, accumulator| $accumulator + $current_value}` adds the `current_value` to the `accumulator`. By default, the first item is the initial accumulator, and iteration starts from the second.
181-
182-
**Output:**
183-
184-
```nu
185-
10
186-
```
187-
188-
_Closure's role:_ Defines the operation for combining elements into a single accumulated value.

0 commit comments

Comments
 (0)