aboutsummaryrefslogtreecommitdiff
path: root/src/content/chapter4_standard_library/lesson02_result_module/en.html
diff options
context:
space:
mode:
authorLouis Pilfold <louis@lpil.uk>2024-02-15 12:18:17 +0000
committerLouis Pilfold <louis@lpil.uk>2024-02-19 18:18:04 +0000
commitf70130322cd306268c5da12c1517dc5725615ae8 (patch)
tree2f047d58f0bd0c9438d57b42499d40d13fea73ad /src/content/chapter4_standard_library/lesson02_result_module/en.html
parent63120914512bd4a3003788a7592ef3cc4ff32cf5 (diff)
downloadtour-f70130322cd306268c5da12c1517dc5725615ae8.tar.gz
tour-f70130322cd306268c5da12c1517dc5725615ae8.zip
text -> en
Diffstat (limited to 'src/content/chapter4_standard_library/lesson02_result_module/en.html')
-rw-r--r--src/content/chapter4_standard_library/lesson02_result_module/en.html40
1 files changed, 40 insertions, 0 deletions
diff --git a/src/content/chapter4_standard_library/lesson02_result_module/en.html b/src/content/chapter4_standard_library/lesson02_result_module/en.html
new file mode 100644
index 0000000..4901afd
--- /dev/null
+++ b/src/content/chapter4_standard_library/lesson02_result_module/en.html
@@ -0,0 +1,40 @@
+<p>
+ The
+ <a href="https://hexdocs.pm/gleam_stdlib/gleam/result.html"
+ ><code>gleam/result</code></a
+ >
+ standard library module contains functions for working with results. Gleam
+ programs will make heavy use of this module to avoid excessive nested case
+ expressions when calling multiple functions that can fail.
+</p>
+
+<p>
+ <a href="https://hexdocs.pm/gleam_stdlib/gleam/result.html#map"
+ ><code>map</code></a
+ >
+ updates a value held within the Ok of a result by calling a given function on
+ it. If the result is an error then the function is not called.
+</p>
+
+<p>
+ <a href="https://hexdocs.pm/gleam_stdlib/gleam/result.html#try"
+ ><code>try</code></a
+ >
+ runs a result returning function on the value held within an Ok of a result.
+ If the result is an error then the function is not called. This is useful for
+ chaining together multiple function calls that can fail, one after the other,
+ stopping at the first error.
+</p>
+
+<p>
+ <a href="https://hexdocs.pm/gleam_stdlib/gleam/result.html#unwrap"
+ ><code>unwrap</code></a
+ >
+ extracts the success value from a result, or returning a default value if the
+ result is an error.
+</p>
+
+<p>
+ Result functions are often used with pipelines to chain together multiple
+ calls to result returning functions.
+</p>