sscanf — Parse formatted values from text.
[A, count, errmsg, nextindex] = sscanf(text, format, size) - Parse formatted values from text.
Syntax
[A, count, errmsg, nextindex] = sscanf(text, format, size)Inputs
text- Type
Any- Required
- Yes
- Description
- Input text.
format- Type
Any- Required
- No
- Default
%f- Description
- Scan format.
sizeA- Type
Any- Required
- No
- Description
- Optional positive scalar or two-element output size and read limit.
Returns
A- Type
Any- Description
- Scanned numeric values or a character array for character-only formats.
count- Type
IntegerScalar- Description
- Number of scanned values, returned as double.
errmsg- Type
Any- Description
- Scan diagnostic character vector.
nextindex- Type
IntegerScalar- Description
- One-based next character index, returned as double.
Returned values from sscanf depend on how many outputs the caller requests.
Errors
RunMat:sscanf:TooManyOutputs- When
- More than four outputs are requested.
- Message
sscanf: too many output arguments
Behavior
Parse formatted values from text.
Supports repeated literal/whitespace-aware scan formats for %f/%e/%g, %d/%i/%u/%o/%x, %s, %c, field widths, assignment suppression, optional size-limited reads, and requested outputs for count, errmsg, and nextindex.
A format containing only %ld or %li conversions returns native int64 storage, and a format containing only %lu, %lo, or %lx conversions returns native uint64 storage. Mixed numeric formats return double.
The optional positive size argument accepts single, double, and all eight integer classes as a scalar or two-element vector, limits scanning, and controls output shape without converting typed dimensions through double. A matrix pads only its incomplete final column.
Character-only scan formats return a character vector or matrix. Mixed numeric and character formats return double character codes, including when a numeric conversion is suppressed. Suppressed fields consume input but not the output limit.
Execution and placement
No GPU kernel is registered. Text and format must be host text; numeric/resident values in those roles reject before transfer. A resident numeric size control gathers through its owning provider before scanning.
Not eligible for fusion; this builtin materializes host numeric or character results and metadata outputs.
Example
sscanf parses two values and reports the first unconsumed character
[A,count,errmsg,nextindex] = sscanf("1 2 x", "%f")Using sscanf with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how sscanf changes the result.
Run a small sscanf example, explain the result, then change one input and compare the output.
Related Strings functions
Core
blanks · char · compose · convertCharsToStrings · convertContainedStringsToChars · convertStringsToChars · genvarname · int2str · isletter · isspace · isStringScalar · isstrprop · mat2str · native2unicode · newline · num2str · sprintf · str2double · str2num · strcmp · strcmpi · string · string.empty · strings · strlength · strncmp · strncmpi · strtok · unicode2native
Text Analytics
addDependencyDetails · addEntityDetails · addLemmaDetails · addPartOfSpeechDetails · addSentenceDetails · addTypeDetails · bagOfNgrams · bagOfWords · cosineSimilarity · doc2sequence · encode · extractFileText · extractHTMLText · fastTextWordEmbedding · findElement · getAttribute · htmlTree · ind2word · 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
Search
contains · endsWith · matches · startsWith · strfind
Pattern
digitsPattern · lettersPattern · pattern · regexpPattern · textBoundary · wildcardPattern
Source you can read
Every RunMat function's source is public. Read exactly how sscanf is executed, line by line, in Rust.
- View the source for sscanf 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.