From 1449f7b1b3e81ceb3373a21915b2cc1d5c3f9ee8 Mon Sep 17 00:00:00 2001 From: qaz Date: Sun, 16 Nov 2025 09:32:13 +0100 Subject: [PATCH 1/3] Document differences between `get` and `select` --- lang-guide/chapters/filters/select-get.md | 24 ++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/lang-guide/chapters/filters/select-get.md b/lang-guide/chapters/filters/select-get.md index 3863c3c9bf5..1e2d8632754 100644 --- a/lang-guide/chapters/filters/select-get.md +++ b/lang-guide/chapters/filters/select-get.md @@ -3,4 +3,26 @@ head: [[meta, {name: draft}]] --- # Understanding the difference between `get` and `select` -TODO +`get` extracts the value and returns a single value or array if multiple keys have been specified. +```nu +~> {a: 1, b: 2, c: 3} | get b +2 +~> {a: 1, b: 2, c: 3} | get b c +╭───┬───╮ +│ 0 │ 2 │ +│ 1 │ 3 │ +╰───┴───╯ +``` + +`select` returns a record without the other values. +```nu +~> {a: 1, b: 2, c: 3} | select b +╭───┬───╮ +│ b │ 2 │ +╰───┴───╯ +~> {a: 1, b: 2, c: 3} | select b c +╭───┬───╮ +│ b │ 2 │ +│ c │ 3 │ +╰───┴───╯ +``` From 747fb7db9769a3b53cbfb1b27d5ff3ebd5aaf26c Mon Sep 17 00:00:00 2001 From: qaz Date: Sun, 16 Nov 2025 13:21:10 +0100 Subject: [PATCH 2/3] Change "array" to "list" Co-authored-by: Darren Schroeder <343840+fdncred@users.noreply.github.com> --- lang-guide/chapters/filters/select-get.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lang-guide/chapters/filters/select-get.md b/lang-guide/chapters/filters/select-get.md index 1e2d8632754..32eb662679b 100644 --- a/lang-guide/chapters/filters/select-get.md +++ b/lang-guide/chapters/filters/select-get.md @@ -3,7 +3,7 @@ head: [[meta, {name: draft}]] --- # Understanding the difference between `get` and `select` -`get` extracts the value and returns a single value or array if multiple keys have been specified. +`get` extracts the value and returns a single value or list if multiple keys have been specified. ```nu ~> {a: 1, b: 2, c: 3} | get b 2 From 7982a437b6ba286063b8426aec2db5121a085099 Mon Sep 17 00:00:00 2001 From: qaz Date: Sun, 16 Nov 2025 13:22:49 +0100 Subject: [PATCH 3/3] Update lang-guide/chapters/filters/select-get.md Co-authored-by: Darren Schroeder <343840+fdncred@users.noreply.github.com> --- lang-guide/chapters/filters/select-get.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lang-guide/chapters/filters/select-get.md b/lang-guide/chapters/filters/select-get.md index 32eb662679b..b4576d6af97 100644 --- a/lang-guide/chapters/filters/select-get.md +++ b/lang-guide/chapters/filters/select-get.md @@ -14,7 +14,7 @@ head: [[meta, {name: draft}]] ╰───┴───╯ ``` -`select` returns a record without the other values. +`select` maintains the nushell values and returns the records selected by column name or key. ```nu ~> {a: 1, b: 2, c: 3} | select b ╭───┬───╮