containers.Map.remove — Remove existing keys from a containers.Map handle.
Remove existing keys from a containers.Map handle. Removal mutates the shared handle. Removing a missing key raises an error; resident key inputs require the RunMat compatibility extension.
Syntax
containers.Map.remove(M, keySet)Inputs
M- Type
Any- Required
- Yes
- Default
- —
- Description
- containers.Map handle object.
keySet- Type
Any- Required
- Yes
- Default
- —
- Description
- Key scalar or key collection to query/mutate.
Errors
RunMat:containers.Map:InvalidArgument- When
- Map constructor/method inputs, option grammar, or key/value payloads are invalid.
- Message
containers.Map: invalid argument
RunMat:containers.Map:MissingKey- When
- Lookup/removal targets a key that is not present in the map.
- Message
containers.Map: The specified key is not present in this container.
RunMat:containers.Map:Internal- When
- Map registry/storage operations fail unexpectedly.
- Message
containers.Map: internal operation failed
Behavior
Removal mutates the shared handle. Removing a missing key raises an error; resident key inputs require the RunMat compatibility extension.
Execution and placement
Map storage and outputs are host-resident. Supported resident inputs gather only after compatibility and argument admission; map operations do not use GPU kernels or numeric fusion.
Map handles are local mutable identities backed by a runtime registry. Copying a handle is not a distributed transfer of the map.
Example
Exercise containers.Map.remove
m = containers.Map({'a','b'},{1,2});
remove(m,{'a'});Using containers.Map.remove with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how containers.Map.remove changes the result.
Run a small containers.Map.remove example, explain the result, then change one input and compare the output.
FAQ
Does remove return a new map?⌄
No. It changes the existing handle and has no public output.
Related Containers functions
containers.Map · containers.Map.isKey · containers.Map.keys · containers.Map.subsasgn · containers.Map.subsref · containers.Map.values
Source you can read
Every RunMat function's source is public. Read exactly how containers.Map.remove is executed, line by line, in Rust.
- View the source for containers.Map.remove in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.