1 2 3<!DOCTYPE html> 4<html lang="en"> 5 <head> 6 <meta charset="utf-8"> 7 <meta name="viewport" content="width=device-width, initial-scale=1"> 8 <meta name="description" content="All you need to know to get started." /> 9 10 <link rel="shortcut icon" href="https://cdn.perl.org/perlweb/favicon.ico" /> 11 12 <title>Docs - www.perl.org</title> 13 14 15 16 17 <link rel="stylesheet" type="text/css" href="https://cdn.perl.org/perlweb/css/perlweb_bootstrap.min.css" /> 18 19 20 <!-- Fonts --> 21 <link href='https://fonts.googleapis.com/css?family=Lato:400,100,300,700,900' rel='stylesheet' type='text/css'> 22 23 24 <link rel="canonical" href="https://www.perl.org/docs.html" /> 25 26 27 28 </head> 29 <body class="page-www section_docs"> 30 <nav class="navbar navbar-expand-lg navbar-dark navbar-inverse"> 31 <div class="container-fluid"> 32 <a class="navbar-brand" href="/"> 33 34 <img src="https://cdn.perl.org/perlweb/images/logo.svg" alt="Docs | Perl, modern programming" class="page-logo"> 35 </a> 36 <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation"> 37 <span class="navbar-toggler-icon"></span> 38 </button> 39 <div id="navbar" class="collapse navbar-collapse"> 40 <ul class="navbar-nav ms-auto text-center"> 41 <li class="nav-item sub"> 42 <a class="nav-link" href="/about.html"> 43 <img src="https://cdn.perl.org/perlweb/images/icons/ic_header_about.svg" class="header-img-nav"> 44 About 45 </a> 46 </li> 47 <li class="nav-item sub"> 48 <a class="nav-link" href="/get.html"> 49 <img src="https://cdn.perl.org/perlweb/images/icons/ic_header_download.svg" class="header-img-nav"> 50 <div class="perl-version d-none d-sm-block"> 51 <span class="version-highlight">5.44.0</span> 52 </div> 53 Download 54 </a> 55 </li> 56 <li class="nav-item sub"> 57 <a class="nav-link" href="/learn.html"> 58 <img src="https://cdn.perl.org/perlweb/images/icons/ic_header_learn.svg" class="header-img-nav"> 59 Learn 60 </a> 61 </li> 62 <li class="nav-item sub selected"> 63 <a class="nav-link" href="/docs.html"> 64 <img src="https://cdn.perl.org/perlweb/images/icons/ic_header_docs.svg" class="header-img-nav"> 65 Docs 66 </a> 67 </li> 68 <li class="nav-item sub"> 69 <a class="nav-link" href="/cpan.html"> 70 <img src="https://cdn.perl.org/perlweb/images/icons/ic_header_cpan.svg" class="header-img-nav"> 71 CPAN 72 </a> 73 </li> 74 <li class="nav-item sub"> 75 <a class="nav-link" href="/community.html"> 76 <img src="https://cdn.perl.org/perlweb/images/icons/ic_header_community.svg" class="header-img-nav"> 77 Community 78 </a> 79 </li> 80</ul> 81 82 </div> 83 </div> 84 </nav> 85 86 87 <div class="jumbotron jumbotron-internal p-5 mb-4 text-center"> 88 <div class="container"> 89 <h1 class="display-5 fw-bold">Docs</h1> 90 <p class="col-md-8 fs-4 mx-auto">All you need to know to get started.</p> 91 </div> 92 </div> 93 94 95 <div class="container"> 96 <div class="row row-height"> 97 <div class="col-12 col-sm-4"> 98 <h3>Official Docs</h3> 99 <p>The <a href="http://perldoc.perl.org">perldoc.perl.org</a> contains the official documentation from the Perl distribution(s). Here are some direct links which may be of interest.</p> 100 <ul class="list-unstyled"> 101 <li> 102 <a href="http://perldoc.perl.org/perl.html">Manual Pages</a> 103 </li> 104 <li> 105 <a href="http://perldoc.perl.org/index-modules-A.html">Core Modules</a> 106 </li> 107 <li> 108 <a href="http://perldoc.perl.org/index-tutorials.html">Tutorials</a> 109 </li> 110 </ul> 111 </div> 112 <div class="col-12 col-sm-4"> 113 <h3>Module Docs</h3> 114 <p>Perl modules come with their own documentation. This includes modules installed from <a href="/cpan.html">CPAN</a>. On Unix-like (including Linux and Mac OS X) systems, you can access the documentation (for installed modules) with the <code>perldoc</code> command.</p> 115 <p> 116 For example, to get the documentation for <a href="https://metacpan.org/module/IO::File ">IO::File</a>, enter<br /> 117 <code>perldoc IO::File</code> from your command prompt. Module documentation is also available on <a href="https://metacpan.org/">metacpan.org</a> 118 </p> 119 </div> 120 <div class="col-12 col-sm-4"> 121 <h3>The Perl FAQ</h3> 122 <p>Perl FAQs are available as part of your Perl distribution with the<br /> 123 <code>perldoc perlfaq</code> command. Read FAQs online at <a href="http://learn.perl.org/faq/">http://learn.perl.org/faq/</a></p> 124 </div> 125 <div class="col-12 col-sm-4"> 126 <h3>Mailing List Archives</h3> 127 <p>Perl-related mail lists are archived in several places.</p> 128 <ul class="list-unstyled"> 129 <li> 130 <a href="http://www.nntp.perl.org">perl.org archives</a> <small><a href="nntp://nntp.perl.org">(via NNTP)</a></small> 131 </li> 132 <li> 133 <a href="http://perl.markmail.org">Perl lists on MarkMail</a> 134 </li> 135 <li> 136 <a href="http://groups.google.com/groups/dir?q=perl">Google Groups</a> - Perl newsgroups 137 </li> 138 <li> 139 <a href="http://lists.perl.org/">Perl Mailing Lists</a> - a list of lists 140 </li> 141 </ul> 142 </div> 143 <div class="col-12 col-sm-4"> 144 <h3>Translations</h3> 145 <ul class="list-unstyled"> 146 <li> 147 <a href="https://metacpan.org/release/POD2-PT_BR">Brazilian Portuguese</a> 148 </li> 149 <li> 150 <a href="http://perl.enstimac.fr/DocFr.html">French</a> 151 </li> 152 <li> 153 <a href="http://perldoc.jp/">Japanese</a> 154 </li> 155 <li> 156 <a href="https://metacpan.org/release/POD2-RU">Russian</a> 157 </li> 158 <li> 159 <a href="https://metacpan.org/release/POD2-ES">Spanish</a> 160 </li> 161 </ul> 162 </div> 163</div> 164
165<div class="row space-top-large text-center"> 166 <div class="col-12"> 167 168 169
169<script type='text/javascript'> 170 var amzn_wdgt={widget:'Carousel'}; 171 amzn_wdgt.tag='develooper'; 172 amzn_wdgt.widgetType='ASINList'; 173 amzn_wdgt.title='Reference and other Perl books'; 174 amzn_wdgt.width='600'; 175 amzn_wdgt.height='200'; 176 amzn_wdgt.ASIN='1430223650,1558607013,1884777791,0596004761,0596001738,1565922433,1930110006,0596100922'; 177 amzn_wdgt.shuffleProducts='True'; 178 amzn_wdgt.marketPlace='US'; 179 </script>
179 180
180<script type='text/javascript' src='//wms.assoc-amazon.com/20070822/US/js/swfobject_1_5.js'> 181 </script>
181 182 </div> 183</div> 184 185 </div> 186 187 188 <div class="container my-4"> 189 <div class="row"> 190 <div class="quicklinks p-4"> 191 <div class="col-12 col-sm-4"> 192 <h4>See also</h4> 193 <ul class="list-unstyled"> 194 195 <li><a href="/books/library.html">Free online books</a></li> 196 197 <li><a href="/media.html">Books and More</a></li> 198 199 <li><a href="http://www.slideshare.net/tag/perl?sort=fav">Presentations</a></li> 200 201 </ul> 202</div> 203 204 205 <div class="col-12 col-sm-4"> 206 <h4>Related sites</h4> 207 <ul class="list-unstyled"> 208 209 <li><a href="http://perldoc.perl.org/">Perldoc</a></li> 210 211 <li><a href="https://metacpan.org/">MetaCPAN</a></li> 212 213 <li><a href="http://learn.perl.org/">Learn</a></li> 214 215 </ul> 216</div> 217 218 219 220 221 </div> 222 </div> 223 </div> 224 225 226 <div class="container-fluid"> 227 <footer class="row"> 228 229<div class="tip-module text-center d-none d-sm-block"> 230 Perl -- More braces. Fewer spaces. 231</div> 232 233 <div class="footer p-5"> 234 235 <div class="row"> 236 237 <ul class="col-12 col-sm-4 list-unstyled"> 238 239 240 <li><h4>Latest Uploads to CPAN</h4></li> 241 242 243 <li><a href="https://metacpan.org/release/MSLM/InternetData-1.6.1">InternetData-1.6.1</a></li> 244 245 246 247 <li><a href="https://metacpan.org/release/LNATION/Fetch-0.28">Fetch-0.28</a></li> 248 249 250 251 <li><a href="https://metacpan.org/release/ASPEER/Cloudflare-API-1.010">Cloudflare-API-1.010</a></li> 252 253 254 255 <li><a href="https://metacpan.org/release/PLICEASE/Params-SomeUtil-1.12">Params-SomeUtil-1.12</a></li> 256 257 258 259 <li><a href="https://metacpan.org/release/ASPEER/Cloudflare-API-1.009">Cloudflare-API-1.009</a></li> 260 261 262 263 <li><a href="https://metacpan.org/release/BWARDEN/Protocol-IR-Code-1.0">Protocol-IR-Code-1.0</a></li> 264 265 266 267 <li><a href="https://metacpan.org/release/JLEE/IO-Socket-SSL-SelfCertificate-1.00-upload">IO-Socket-SSL-SelfCertificate-1.00-upload</a></li> 268 269 270 271 <li><a href="https://metacpan.org/release/JLEE/IO-Socket-SSL-SelfCertificate-1.00">IO-Socket-SSL-SelfCertificate-1.00</a></li> 272 273 274 275 <li><a href="https://metacpan.org/release/BWARDEN/Protocol-IR-Code-0.08">Protocol-IR-Code-0.08</a></li> 276 277 278 279 <li><a href="https://metacpan.org/release/NHORNE/Database-BI-0.009.0">Database-BI-0.009.0</a></li> 280 281 282 </ul> 283 <ul class="col-12 col-sm-4 list-unstyled"> 284 285 286 <li><h4>Perl News</h4></li> 287 288 289 <li><a href="https://www.perl.com/article/herodevs-donates-10-000-to-the-perl-and-raku-foundation/">HeroDevs Donates $10,000 to The Perl and Raku Foundation</a></li> 290 291 292 293 <li><a href="https://www.perl.com/article/alpha-omega-donates-usd-250-000-for-perl-and-cpan-security/">Alpha-Omega Donates USD 250,000 for Perl and CPAN Security</a></li> 294 295 296 297 <li><a href="https://www.perl.com/article/three-ways-to-write-a-table-in-podlite/">Three ways to write a table in Podlite</a></li> 298 299 300 301 <li><a href="https://www.perl.com/article/perl-toolchain-summit-2026-key-results/">The Perl Toolchain Summit 2026: Security, Testing, Porting and Community Collaboration</a></li> 302 303 304 305 <li><a href="https://www.perl.com/article/making-an-asynchronous-clocking-drum-machine-in-perl/">Making an Asynchronous Clocking Drum Machine App in Perl</a></li> 306 307 308 </ul> 309 310 <ul class="col-12 col-sm-2 list-unstyled"> 311 <li><h4>Perl.org</h4></li> 312 <li><a href="http://www.perl.org/">www</a></li> 313 <li><a href="http://blogs.perl.org/">blogs</a></li> 314 <li><a href="http://jobs.perl.org/">jobs</a></li> 315 <li><a href="http://learn.perl.org/">learn</a></li> 316 <li><a href="http://dev.perl.org/">dev</a></li> 317 </ul> 318 <ul class="col-12 col-sm-2 list-unstyled"> 319 <li><h4>Connect</h4></li> 320 <li><a href="/siteinfo.html">Site Info</a></li> 321 </ul> 322 </div> 323 <div class="col-12 mt-5"> 324 <p class="copyright"> 325 <a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/3.0/us/">
325<img alt="Creative Commons License" style="border-width:0" src="https://cdn.perl.org/perlweb/images/icons/creativecommons-by-nc-nd-3.0-us-80x15.png" /></a> © 2002-2026 Perl.org 326 </p> 327 </div> 328 </div> 329 </footer> 330 </div>
331<script defer data-domain="perl.org" src="https://cdn.perl.org/js/script.file-downloads.outbound-links.js"></script>
331 332 333<!-- Global site tag (gtag.js) - Google Analytics -->
vendor: 64 bytes, lines 333-334
333 334<script async src="https://www.googletagmanager.com/gtag/js?id=
334UA-50555-1
vendor: 12 bytes, line 334
334"></script>
335<script> 336 window.dataLayer = window.dataLayer || []; 337 function gtag(){dataLayer.push(arguments);} 338 gtag('js', new Date()); 339 340 gtag('config', 'UA-50555-1', { 341 'link_attribution': true, 342 'custom_map': {'dimension1': 'protocol'} 343 }); 344 gtag('event', 'pageload', {'protocol': window.location.protocol}); 345</script>
vendor: 1 bytes, line 345
345
346<script type="text/javascript" src="https://cdn.perl.org/perlweb/js/perlweb_bootstrap.min.js" charset="UTF-8"></script>
346 347 348 349 350 351 </body> 352</html> 353 354
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.