getAttribute — Read an HTML attribute from htmlTree objects.
getAttribute(tree, attr) returns the value of an HTML attribute from a scalar RunMat htmlTree object or from each object in a cell array of htmlTree objects.
Syntax
str = getAttribute(tree, attr)Inputs
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
tree | Any | Yes | — | htmlTree object or cell array of htmlTree objects. |
attr | StringScalar | Yes | — | Attribute name. |
Returns
| Name | Type | Description |
|---|---|---|
str | Any | Extracted text. |
Errors
| Identifier | When | Message |
|---|---|---|
RunMat:html:InvalidInput | Inputs are not a supported htmlTree or extractHTMLText form. | HTML Text Analytics helper received invalid input |
How getAttribute works
treemust be a scalar RunMathtmlTreeobject or a cell array ofhtmlTreeobjects, such as the output offindElement.attrmust be a nonempty string scalar or character vector.- Attribute names are normalized to lowercase and matched against the parser's lowercase attribute map.
- A scalar
htmlTreeinput returns a string scalar. - A cell array of
htmlTreeobjects returns a string array with the same shape unless there is only one cell element. - If the requested attribute is absent, RunMat returns
<missing>for that element. - Full MATLAB missing-string scalar representation for
htmlTreeattributes remains tied to broader missing/object-array compatibility work.
GPU memory and residency
getAttribute reads host-resident HTML metadata and has no provider kernel.
Examples
Read Link Attributes
tree = htmlTree("<a href='/home'>Home</a>");
href = getAttribute(tree, "href")Expected output:
href = "/home"Read Attributes From Matches
tree = htmlTree("<div><a href='/home'>Home</a><a>Docs</a></div>");
links = findElement(tree, "a");
hrefs = getAttribute(links, "href")Expected output:
hrefs = ["/home"; "<missing>"]Using getAttribute with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how getAttribute changes the result.
Run a small getAttribute example, explain the result, then change one input and compare the output.
FAQ
What does RunMat return for a missing attribute?⌄
RunMat returns the string <missing> for that element. A first-class MATLAB missing-string scalar for this object path remains tracked with broader missing/object compatibility work.
Does getAttribute execute on the GPU?⌄
No. Attribute lookup is host HTML metadata access and has no runmat-accelerate provider path.
Related Strings functions
Text Analytics
addDependencyDetails · addEntityDetails · addLemmaDetails · addPartOfSpeechDetails · addSentenceDetails · addTypeDetails · bagOfNgrams · bagOfWords · cosineSimilarity · doc2sequence · encode · extractFileText · extractHTMLText · fastTextWordEmbedding · findElement · 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
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 getAttribute is executed, line by line, in Rust.
- View the source for getAttribute 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.