aboutsummaryrefslogtreecommitdiff
path: root/src/content/chapter5_advanced_features/lesson04_externals/text.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/chapter5_advanced_features/lesson04_externals/text.html
parent63120914512bd4a3003788a7592ef3cc4ff32cf5 (diff)
downloadtour-f70130322cd306268c5da12c1517dc5725615ae8.tar.gz
tour-f70130322cd306268c5da12c1517dc5725615ae8.zip
text -> en
Diffstat (limited to 'src/content/chapter5_advanced_features/lesson04_externals/text.html')
-rw-r--r--src/content/chapter5_advanced_features/lesson04_externals/text.html25
1 files changed, 0 insertions, 25 deletions
diff --git a/src/content/chapter5_advanced_features/lesson04_externals/text.html b/src/content/chapter5_advanced_features/lesson04_externals/text.html
deleted file mode 100644
index 8815fa7..0000000
--- a/src/content/chapter5_advanced_features/lesson04_externals/text.html
+++ /dev/null
@@ -1,25 +0,0 @@
-<p>
- Sometimes in our projects we want to use code written in other languages, most
- commonly Erlang and JavaScript, depending on which runtime is being used.
- Gleam's <em>external functions</em> and <em>external types</em> allow us to
- import and use this non-Gleam code.
-</p>
-<p>
- An external type is one that has no constructors. Gleam doesn't know what
- shape it has or how to create one, it only knows that it exists.
-</p>
-<p>
- An external function is one that has the <code>@external</code> attribute on
- it, directing the compiler to use the specified module function as the
- implementation, instead of Gleam code.
-</p>
-<p>
- The compiler can't tell the types of functions written in other languages, so
- when the external attribute is given type annotations must be provided. Gleam
- trusts that the type given is correct so an inaccurate type annotation can
- result in unexpected behaviour and crashes at runtime. Be careful!
-</p>
-<p>
- External functions are useful but should be used sparingly. Prefer to write
- Gleam code where possible.
-</p>