dispstr
Matlab does not provide a general, polymorphic object display function, like Java's toString() method. This makes it hard to write generic code that can do concise debugging display of objects, which is useful for logging, error messages, and interaction at the console.
The Dispstr API provides a concise API for generic, polymorphic, customizable object display, and implementations for the major types that come with Matlab.
Dispstr only provides a few functions and classes:
dispstr() and dispstrs()
prettyprint()
sprintfds(), fprintfds(), errords(), and warningds()
dispstrlib.Displayable and dispstrlib.DisplayableHandle
dispstr() and disptrs() are generic object display functions, which can be overridden by user-defined classes to customize their display. prettyprint() is a function for dumping the details of an array, and respects dispstr/dispstrs. sprintfds() and fprintfds() let you do formatted output that respects dispstr(). errords() and warningds() are variants of error() and warning() that respect dispstr formatting. And @dispstrlib.Displayable is a convenience mixin that makes it easier to write classes that implement dispstr/dispstrs.
When using this library, your user-defined objects can now be displayed inside structs and tables with meaningful data representations, instead of just "<1-by-1 SomeClass>", which Matlab's default disp() does when objects are stuck inside fields of cells or variables of tables.
I think the major value in this library is in establishing the function convention and signatures, not in the implementation code itself.
To use Dispstr, get it on your Matlab path, and then define dispstr() and dispstrs() methods on your classes that you want to have custom displays for. (Or have them inherit from @dispstrlib.Displayable and just define dispstr_scalar().)
This project's home is on GitHub at https://github.com/apjanke/dispstr.
Citation pour cette source
Andrew Janke (2024). dispstr (https://github.com/janklab/dispstr), GitHub. Récupéré le .
Compatibilité avec les versions de MATLAB
Plateformes compatibles
Windows macOS LinuxCatégories
- Reporting and Database Access > MATLAB Report Generator > Interactive Report Program Builder > Format Reports >
Tags
Community Treasure Hunt
Find the treasures in MATLAB Central and discover how the community can help you!
Start Hunting!Découvrir Live Editor
Créez des scripts avec du code, des résultats et du texte formaté dans un même document exécutable.
Mcode
Mcode-monkeypatch
Mcode-monkeypatch/@cell
Mcode-monkeypatch/@struct
Mcode-monkeypatch/@tabular
Mcode/+dispstrlib
Mcode/+dispstrlib/+internal
Mcode/+dispstrlib/+internal/+util
Mcode/+dispstrlib/+internal/+util/private
Mcode/+dispstrlib/private
Mcode/private
dev-kit
dev-kit/private
dev-kit/util-shims
docs/examples
examples
test-code
Les versions qui utilisent la branche GitHub par défaut ne peuvent pas être téléchargées
Version | Publié le | Notes de version | |
---|---|---|---|
1.1.1 | * Fix a bug with orientation of numeric arrays in dispstr |
|
|
1.1.0 | * Use strings instead of cellstrs
|
|
|
1.0.0 |
|