ind2word — Map wordEncoding indices back to words.
ind2word(enc, M) returns the vocabulary words corresponding to 1-based indices in M.
Syntax
words = ind2word(enc, M)Inputs
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
enc | Any | Yes | — | wordEncoding object. |
M | NumericArray | Yes | — | Positive integer word encoding indices. |
Returns
| Name | Type | Description |
|---|---|---|
words | Any | Words mapped from encoding indices. |
Errors
| Identifier | When | Message |
|---|---|---|
RunMat:ind2word:InvalidInput | Inputs do not match a supported ind2word form. | ind2word received invalid input |
How ind2word works
encmust be a RunMatwordEncodingcompatibility object.Mmay be a numeric scalar or numeric tensor of positive integer indices.- MATLAB-compatible mode accepts host double index vectors. Native typed-integer vectors, nonvector index arrays, and resident indices are separate
runmatmode extensions; admitted integer indices are read exactly. - The output is a string array with the same shape as
M. - Indices must be finite positive integers within the vocabulary size. Invalid, NaN, fractional, zero, negative, or out-of-range indices are rejected with a controlled error.
GPU memory and residency
ind2word reads host text/model metadata and returns a CPU string array.
Example
Map Indices To Words
enc = wordEncoding(["fairest" "desire" "thereby"]);
words = ind2word(enc, [1 3])Expected output:
`words` is `["fairest" "thereby"]`.Using ind2word with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how ind2word changes the result.
Run a small ind2word example, explain the result, then change one input and compare the output.
FAQ
Does ind2word return missing strings for invalid indices?⌄
No. The documented input is positive integer indices, so RunMat rejects invalid or out-of-range indices.
Does ind2word execute on the GPU?⌄
No. It is a host metadata lookup.
Related Strings functions
Text Analytics
addDependencyDetails · addEntityDetails · addLemmaDetails · addPartOfSpeechDetails · addSentenceDetails · addTypeDetails · bagOfNgrams · bagOfWords · cosineSimilarity · doc2sequence · encode · extractFileText · extractHTMLText · fastTextWordEmbedding · findElement · getAttribute · htmlTree · isVocabularyWord · normalizeWords · readWordEmbedding · removeLongWords · removeShortWords · removeStopWords · removeWords · stopWords · tokenDetails · tokenizedDocument · trainWordEmbedding · vaderSentimentScores · vec2word · word2ind · word2vec · wordEncoding · writeWordEmbedding
Transform
append · deblank · erase · eraseBetween · erasePunctuation · eraseURLs · extractAfter · extractBefore · extractBetween · insertAfter · insertBefore · join · lower · pad · replace · replaceBetween · reverse · split · splitlines · strcat · strip · strjoin · strjust · strrep · strsplit · strtrim · upper
Core
blanks · char · compose · convertCharsToStrings · convertContainedStringsToChars · convertStringsToChars · genvarname · int2str · isletter · isspace · isStringScalar · isstrprop · mat2str · native2unicode · newline · num2str · sprintf · sscanf · str2double · str2num · strcmp · strcmpi · string · string.empty · strings · strlength · strncmp · strncmpi · strtok · unicode2native
Search
contains · endsWith · matches · startsWith · strfind
Pattern
digitsPattern · lettersPattern · pattern · regexpPattern · textBoundary · wildcardPattern
Open-source implementation
Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how ind2word is executed, line by line, in Rust.
- View the source for ind2word in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is an open-source runtime that executes MATLAB-syntax code blazing on any GPU. It is licensed under the Apache 2.0 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.