CINXE.COM

<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, height=device-height, initial-scale=1, user-scalable=no"> <meta name="description" content="API docs for the AsciiCodec class from the dart:convert library, for the Dart programming language."> <title>AsciiCodec class - dart:convert library - Dart API</title> <link rel="canonical" href="https://api.dart.dev/dart-convert/AsciiCodec-class.html"> <link rel="preconnect" href="https://fonts.gstatic.com"> <link href="https://fonts.googleapis.com/css2?family=Roboto+Mono:ital,wght@0,300;0,400;0,500;0,700;1,400&display=swap" rel="stylesheet"> <link href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@24,400,0,0" rel="stylesheet"> <link rel="stylesheet" href="../static-assets/github.css?v1"> <link rel="stylesheet" href="../static-assets/styles.css?v1"> <link rel="icon" href="../static-assets/favicon.png?v1">  <script async src="https://www.googletagmanager.com/gtag/js?id=G-VVQ8908SJ5"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'G-VVQ8908SJ5'); </script> <link rel="preconnect" href="https://fonts.googleapis.com"> <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin> <link rel="preload" href="https://fonts.googleapis.com/css2?family=Google+Sans+Text:wght@400&family=Google+Sans:wght@500&display=swap" as="style"> <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Google+Sans+Text:wght@400&family=Google+Sans:wght@500&display=swap"> <link rel="stylesheet" href="https://www.gstatic.com/glue/cookienotificationbar/cookienotificationbar.min.css"> </head> <body data-base-href="../" data-using-base-href="false" class="light-theme"> <div id="overlay-under-drawer"></div> <header id="title"> <span id="sidenav-left-toggle" class="material-symbols-outlined" role="button" tabindex="0">menu</span> <ol class="breadcrumbs gt-separated dark hidden-xs"> <li><a href="../index.html">Dart</a></li> <li><a href="../dart-convert/dart-convert-library.html">dart:convert</a></li> <li class="self-crumb">AsciiCodec class</li> </ol> <div class="self-name">AsciiCodec</div> <form class="search navbar-right" role="search"> <input type="text" id="search-box" autocomplete="off" disabled class="form-control typeahead" placeholder="Loading search..."> </form> <div class="toggle" id="theme-button" title="Toggle brightness"> <label for="theme"> <input type="checkbox" id="theme" value="light-theme"> <span id="dark-theme-button" class="material-symbols-outlined"> dark_mode </span> <span id="light-theme-button" class="material-symbols-outlined"> light_mode </span> </label> </div> </header> <main> <div id="dartdoc-main-content" class="main-content" data-above-sidebar="dart-convert/dart-convert-library-sidebar.html" data-below-sidebar="dart-convert/AsciiCodec-class-sidebar.html"> <div> <div id="external-links" class="btn-group"><a title="View source code" class="source-link" href="https://github.com/dart-lang/sdk/blob/88c9758ef131d430d8ce595c6bfb4c90574d3ddd/sdk/lib/convert/ascii.dart#L24"><span class="material-symbols-outlined">description</span></a></div> <h1><span class="kind-class">AsciiCodec</span> class <a href="https://dart.dev/language/class-modifiers#final" class="feature feature-final" title="This class can neither be extended, implemented, nor mixed in.">final</a> </h1></div> <section class="desc markdown"> <p>An <a href="../dart-convert/AsciiCodec-class.html">AsciiCodec</a> allows encoding strings as ASCII bytes and decoding ASCII bytes to strings.</p> </section> <section> <dl class="dl-horizontal"> <dt>Inheritance</dt> <dd> <ul class="gt-separated dark clazz-relationships"> <li><a href="../dart-core/Object-class.html">Object</a></li> <li><a href="../dart-convert/Codec-class.html">Codec</a><span class="signature"><<wbr><span class="type-parameter"><a href="../dart-core/String-class.html">String</a></span>, <span class="type-parameter"><a href="../dart-core/List-class.html">List</a><span class="signature"><<wbr><span class="type-parameter"><a href="../dart-core/int-class.html">int</a></span>></span></span>></span></li> <li><a href="../dart-convert/Encoding-class.html">Encoding</a></li> <li>AsciiCodec</li> </ul> </dd> </dl> </section> <section class="summary offset-anchor" id="constructors"> <h2>Constructors</h2> <dl class="constructor-summary-list"> <dt id="AsciiCodec" class="callable"> <span class="name"><a href="../dart-convert/AsciiCodec/AsciiCodec.html">AsciiCodec</a></span><span class="signature">({<span class="parameter" id="-param-allowInvalid"><span class="type-annotation"><a href="../dart-core/bool-class.html">bool</a></span> <span class="parameter-name">allowInvalid</span> = <span class="default-value">false</span></span>})</span> </dt> <dd> Instantiates a new <a href="../dart-convert/AsciiCodec-class.html">AsciiCodec</a>. <div class="constructor-modifier features">const</div> </dd> </dl> </section> <section class="summary offset-anchor" id="instance-properties"> <h2>Properties</h2> <dl class="properties"> <dt id="decoder" class="property"> <span class="name"><a href="../dart-convert/AsciiCodec/decoder.html">decoder</a></span> <span class="signature">→ <a href="../dart-convert/AsciiDecoder-class.html">AsciiDecoder</a></span> </dt> <dd> Returns the decoder of <code>this</code>, converting from <code>List<int></code> to <code>String</code>. <div class="features"><span class="feature">no setter</span><span class="feature">override</span></div> </dd> <dt id="encoder" class="property"> <span class="name"><a href="../dart-convert/AsciiCodec/encoder.html">encoder</a></span> <span class="signature">→ <a href="../dart-convert/AsciiEncoder-class.html">AsciiEncoder</a></span> </dt> <dd> Returns the encoder from <code>String</code> to <code>List<int></code>. <div class="features"><span class="feature">no setter</span><span class="feature">override</span></div> </dd> <dt id="hashCode" class="property inherited"> <span class="name"><a href="../dart-core/Object/hashCode.html">hashCode</a></span> <span class="signature">→ <a href="../dart-core/int-class.html">int</a></span> </dt> <dd class="inherited"> The hash code for this object. <div class="features"><span class="feature">no setter</span><span class="feature">inherited</span></div> </dd> <dt id="inverted" class="property inherited"> <span class="name"><a href="../dart-convert/Codec/inverted.html">inverted</a></span> <span class="signature">→ <a href="../dart-convert/Codec-class.html">Codec</a><span class="signature"><<wbr><span class="type-parameter"><a href="../dart-core/List-class.html">List</a><span class="signature"><<wbr><span class="type-parameter"><a href="../dart-core/int-class.html">int</a></span>></span></span>, <span class="type-parameter"><a href="../dart-core/String-class.html">String</a></span>></span></span> </dt> <dd class="inherited"> Inverts <code>this</code>. <div class="features"><span class="feature">no setter</span><span class="feature">inherited</span></div> </dd> <dt id="name" class="property"> <span class="name"><a href="../dart-convert/AsciiCodec/name.html">name</a></span> <span class="signature">→ <a href="../dart-core/String-class.html">String</a></span> </dt> <dd> The name of this codec is "us-ascii". <div class="features"><span class="feature">no setter</span><span class="feature">override</span></div> </dd> <dt id="runtimeType" class="property inherited"> <span class="name"><a href="../dart-core/Object/runtimeType.html">runtimeType</a></span> <span class="signature">→ <a href="../dart-core/Type-class.html">Type</a></span> </dt> <dd class="inherited"> A representation of the runtime type of the object. <div class="features"><span class="feature">no setter</span><span class="feature">inherited</span></div> </dd> </dl> </section> <section class="summary offset-anchor" id="instance-methods"> <h2>Methods</h2> <dl class="callables"> <dt id="decode" class="callable"> <span class="name"><a href="../dart-convert/AsciiCodec/decode.html">decode</a></span><span class="signature">(<wbr><span class="parameter" id="decode-param-bytes"><span class="type-annotation"><a href="../dart-core/List-class.html">List</a><span class="signature"><<wbr><span class="type-parameter"><a href="../dart-core/int-class.html">int</a></span>></span></span> <span class="parameter-name">bytes</span>, {</span><span class="parameter" id="decode-param-allowInvalid"><span class="type-annotation"><a href="../dart-core/bool-class.html">bool</a>?</span> <span class="parameter-name">allowInvalid</span></span>}) <span class="returntype parameter">→ <a href="../dart-core/String-class.html">String</a></span> </span> </dt> <dd> Decodes the ASCII <code>bytes</code> (a list of unsigned 7-bit integers) to the corresponding string. <div class="features"><span class="feature">override</span></div> </dd> <dt id="decodeStream" class="callable inherited"> <span class="name"><a href="../dart-convert/Encoding/decodeStream.html">decodeStream</a></span><span class="signature">(<wbr><span class="parameter" id="decodeStream-param-byteStream"><span class="type-annotation"><a href="../dart-async/Stream-class.html">Stream</a><span class="signature"><<wbr><span class="type-parameter"><a href="../dart-core/List-class.html">List</a><span class="signature"><<wbr><span class="type-parameter"><a href="../dart-core/int-class.html">int</a></span>></span></span>></span></span> <span class="parameter-name">byteStream</span></span>) <span class="returntype parameter">→ <a href="../dart-async/Future-class.html">Future</a><span class="signature"><<wbr><span class="type-parameter"><a href="../dart-core/String-class.html">String</a></span>></span></span> </span> </dt> <dd class="inherited"> <div class="features"><span class="feature">inherited</span></div> </dd> <dt id="encode" class="callable"> <span class="name"><a href="../dart-convert/AsciiCodec/encode.html">encode</a></span><span class="signature">(<wbr><span class="parameter" id="encode-param-source"><span class="type-annotation"><a href="../dart-core/String-class.html">String</a></span> <span class="parameter-name">source</span></span>) <span class="returntype parameter">→ <a href="../dart-typed_data/Uint8List-class.html">Uint8List</a></span> </span> </dt> <dd> Encodes <code>input</code>. <div class="features"><span class="feature">override</span></div> </dd> <dt id="fuse" class="callable inherited"> <span class="name"><a href="../dart-convert/Codec/fuse.html">fuse</a></span><span class="signature"><<wbr><span class="type-parameter">R</span>></span><span class="signature">(<wbr><span class="parameter" id="fuse-param-other"><span class="type-annotation"><a href="../dart-convert/Codec-class.html">Codec</a><span class="signature"><<wbr><span class="type-parameter"><a href="../dart-core/List-class.html">List</a><span class="signature"><<wbr><span class="type-parameter"><a href="../dart-core/int-class.html">int</a></span>></span></span>, <span class="type-parameter">R</span>></span></span> <span class="parameter-name">other</span></span>) <span class="returntype parameter">→ <a href="../dart-convert/Codec-class.html">Codec</a><span class="signature"><<wbr><span class="type-parameter"><a href="../dart-core/String-class.html">String</a></span>, <span class="type-parameter">R</span>></span></span> </span> </dt> <dd class="inherited"> Fuses <code>this</code> with <code>other</code>. <div class="features"><span class="feature">inherited</span></div> </dd> <dt id="noSuchMethod" class="callable inherited"> <span class="name"><a href="../dart-core/Object/noSuchMethod.html">noSuchMethod</a></span><span class="signature">(<wbr><span class="parameter" id="noSuchMethod-param-invocation"><span class="type-annotation"><a href="../dart-core/Invocation-class.html">Invocation</a></span> <span class="parameter-name">invocation</span></span>) <span class="returntype parameter">→ dynamic</span> </span> </dt> <dd class="inherited"> Invoked when a nonexistent method or property is accessed. <div class="features"><span class="feature">inherited</span></div> </dd> <dt id="toString" class="callable inherited"> <span class="name"><a href="../dart-core/Object/toString.html">toString</a></span><span class="signature">(<wbr>) <span class="returntype parameter">→ <a href="../dart-core/String-class.html">String</a></span> </span> </dt> <dd class="inherited"> A string representation of this object. <div class="features"><span class="feature">inherited</span></div> </dd> </dl> </section> <section class="summary offset-anchor inherited" id="operators"> <h2>Operators</h2> <dl class="callables"> <dt id="operator ==" class="callable inherited"> <span class="name"><a href="../dart-core/Object/operator_equals.html">operator ==</a></span><span class="signature">(<wbr><span class="parameter" id="==-param-other"><span class="type-annotation"><a href="../dart-core/Object-class.html">Object</a></span> <span class="parameter-name">other</span></span>) <span class="returntype parameter">→ <a href="../dart-core/bool-class.html">bool</a></span> </span> </dt> <dd class="inherited"> The equality operator. <div class="features"><span class="feature">inherited</span></div> </dd> </dl> </section> </div>  <div id="dartdoc-sidebar-left" class="sidebar sidebar-offcanvas-left">  <header id="header-search-sidebar" class="hidden-l"> <form class="search-sidebar" role="search"> <input type="text" id="search-sidebar" autocomplete="off" disabled class="form-control typeahead" placeholder="Loading search..."> </form> </header> <ol class="breadcrumbs gt-separated dark hidden-l" id="sidebar-nav"> <li><a href="../index.html">Dart</a></li> <li><a href="../dart-convert/dart-convert-library.html">dart:convert</a></li> <li class="self-crumb">AsciiCodec class</li> </ol> <h5>dart:convert library</h5> <div id="dartdoc-sidebar-left-content"></div> </div> <div id="dartdoc-sidebar-right" class="sidebar sidebar-offcanvas-right"> </div> </main> <footer> <span class="no-break"> Dart 3.5.4 </span> <span class="glue-footer"> <span class="no-break"> | <a href="https://dart.dev/terms" title="Terms of use">Terms</a> </span> <span class="no-break"> | <a href="https://policies.google.com/privacy" target="_blank" rel="noopener" title="Privacy policy" class="no-automatic-external">Privacy</a> </span> <span class="no-break"> | <a href="https://dart.dev/security" title="Security philosophy and practices">Security</a> </span> <div class="copyright" style="font-size: 0.9em; color: darkgrey; margin-top: 0.5em;"> Except as otherwise noted, this site is licensed under a <a style="color: darkgrey;" href="https://creativecommons.org/licenses/by/4.0/"> Creative Commons Attribution 4.0 International License</a> and code samples are licensed under the <a style="color: darkgrey;" href="https://opensource.org/licenses/BSD-3-Clause" class="no-automatic-external"> 3-Clause BSD License</a> </div> </span> </footer> <script src="../static-assets/highlight.pack.js?v1"></script> <script src="../static-assets/docs.dart.js"></script> <button aria-hidden="true" class="glue-footer__link glue-cookie-notification-bar-control"> Cookies management controls </button> <script src="https://www.gstatic.com/glue/cookienotificationbar/cookienotificationbar.min.js" data-glue-cookie-notification-bar-category="2B"> </script> </body> </html>