Skip to content

Commit

Permalink
fix typos, links
Browse files Browse the repository at this point in the history
  • Loading branch information
MaryaBelanger committed Nov 7, 2024
1 parent c0c61bc commit a578081
Showing 1 changed file with 6 additions and 6 deletions.
12 changes: 6 additions & 6 deletions src/content/language/concurrency.md
Original file line number Diff line number Diff line change
Expand Up @@ -431,26 +431,26 @@ objects, so they're subject to the same limitations.
#### Synchronous blocking communication between isolates

There is a limit to the number of isolates that can run in parallel, or *synchronously*.
This limit doesn't affect the standard *asynchronous* communction between isolates
This limit doesn't affect the standard *asynchronous* communication between isolates
via messages in Dart. You can have hundreds of isolates running concurrently
and making progress. The isolates are scheduled on the CPU in round-robin fashion
and making progress. The isolates are scheduled on the CPU in round-robin fashion,
and yield to each other often.

Isolates can only communicate *synchronously* outside of pure Dart,
using C code via [FFI] to do so.
Attempts to do synchronous communication between isolates in FFI calls
Attempts to perform synchronous communication between isolates in FFI calls
over the limit may result in deadlock unless special care is taken.
The limit is not hardcoded to a particular number,
it's calculated based on the Dart VM heap size available to the Dart application.

To avoid this situation, the C code that does synchronous communication
To avoid this situation, the C code performing synchronous communication
needs to leave the current isolate before performing the blocking operation
and re-enter it before returning to Dart from the FFI call.
Read about [`Dart_EnterIsolate`] and [`Dart_ExitIsolate`] to learn more.

[FFI]: /interop/c-interop
[`Dart_EnterIsolate`]: ({{site.repo.dart.sdk}}/blob/c9a8bbd8d6024e419b5e5f26b5131285eb19cc93/runtime/include/dart_api.h#L1254)
[`Dart_ExitIsolate`]: ({{site.repo.dart.sdk}}/blob/c9a8bbd8d6024e419b5e5f26b5131285eb19cc93/runtime/include/dart_api.h#L1455)
[`Dart_EnterIsolate`]: {{site.repo.dart.sdk}}/blob/c9a8bbd8d6024e419b5e5f26b5131285eb19cc93/runtime/include/dart_api.h#L1254
[`Dart_ExitIsolate`]: {{site.repo.dart.sdk}}/blob/c9a8bbd8d6024e419b5e5f26b5131285eb19cc93/runtime/include/dart_api.h#L1455

<a id="web"></a>
## Concurrency on the web
Expand Down

0 comments on commit a578081

Please sign in to comment.