containers.Map.subsref — Read a key value or a read-only map property through a standard subscript path.
Read a key value or a read-only map property through a standard subscript path. Parenthesis indexing accepts one scalar key; dot indexing exposes Count, KeyType, and ValueType. The key lookup result depends on the stored value and remains dynamic in static inference.
Syntax
value = containers.Map.subsref(M, S)Inputs
M- Type
Any- Required
- Yes
- Default
- —
- Description
- containers.Map handle object.
S- Type
Any- Required
- Yes
- Default
- —
- Description
- Standard substruct-compatible indexing path.
Returns
value- Type
Any- Description
- Lookup/property value result.
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
Parenthesis indexing accepts one scalar key; dot indexing exposes Count, KeyType, and ValueType. The key lookup result depends on the stored value and remains dynamic in static inference.
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.subsref
m = containers.Map({'a'},{2});
s = struct('type','()','subs',{{'a'}});
v = subsref(m,s);Using containers.Map.subsref with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how containers.Map.subsref changes the result.
Run a small containers.Map.subsref example, explain the result, then change one input and compare the output.
FAQ
What happens for an unknown key?⌄
Lookup raises a missing-key error.
Related Containers functions
containers.Map · containers.Map.isKey · containers.Map.keys · containers.Map.remove · containers.Map.subsasgn · containers.Map.values
Source you can read
Every RunMat function's source is public. Read exactly how containers.Map.subsref is executed, line by line, in Rust.
- View the source for containers.Map.subsref 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.