Startsida Utforska Hjälp
Logga in
levovix
/
Nim
spegling av https://github.com/nim-lang/Nim
Bevaka 1
Stjärnmärk 0
Fork 1
Filer Ärenden 0 Wiki
Gren: gh-pages
Grenar Taggar
Nim
/
strutils.html

strutils.html 452 KB
Permalänk Historik Rå

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331 
  1. <?xml version="1.0" encoding="utf-8" ?>
    2. 

  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    3. 

  3. <!--  This file is generated by Nim. -->
    4. 

  4. <html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
    5. 

  5. <head>
    6. 

  6. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    7. 

  7. <meta name="viewport" content="width=device-width, initial-scale=1.0">
    8. 

  8. <title>std/strutils</title>
    9. 

  9. 

  10. <!-- Google fonts -->
    11. 

  11. <link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
    12. 

  12. <link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
    13. 

  13. 

  14. <!-- Favicon -->
    15. 

  15. <link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
    16. 

  16. <link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
    17. 

  17. 

  18. <!-- CSS -->
    19. 

  19. <link rel="stylesheet" type="text/css" href="nimdoc.out.css?v=2.3.1">
    20. 

  20. 

  21. <!-- JS -->
    22. 

  22. <script type="text/javascript" src="dochack.js?v=2.3.1"></script>
    23. 

  23. </head>
    24. 

  24. <body>
    25. 

  25.   <div class="document" id="documentId">
    26. 

  26.     <div class="container">
    27. 

  27.       <h1 class="title">std/strutils</h1>
    28. 

  28.       <div class="row">
    29. 

  29.   <div class="three columns">
    30. 

  30.     <div class="theme-select-wrapper">
    31. 

  31.       <label for="theme-select">Theme:&nbsp;</label>
    32. 

  32.       <select id="theme-select" onchange="setTheme(this.value)">
    33. 

  33.         <option value="auto">🌗 Match OS</option>
    34. 

  34.         <option value="dark">🌑 Dark</option>
    35. 

  35.         <option value="light">🌕 Light</option>
    36. 

  36.       </select>
    37. 

  37.     </div>
    38. 

  38.     <div id="global-links">
    39. 

  39.       <ul class="simple-boot">
    40. 

  40.         <li><a href="manual.html">Manual</a></li>
    41. 

  41.         <li><a href="lib.html">Standard library</a></li>
    42. 

  42.         <li> <a id="indexLink" href="theindex.html">Index</a></li>
    43. 

  43.         <li><a href="compiler/theindex.html">Compiler docs</a></li>
    44. 

  44.         <li><a href="https://nim-lang.github.io/fusion/theindex.html">Fusion docs</a></li>
    45. 

  45.         <li><a href="https://nim-lang.github.io/Nim/">devel</a>, <a href="https://nim-lang.org/documentation.html">stable</a></li>
    46. 

  46.       </ul>
    47. 

  47.     </div>
    48. 

  48.     <div id="searchInputDiv">
    49. 

  49.       Search: <input type="search" id="searchInput"
    50. 

  50.         oninput="search()" />
    51. 

  51.     </div>
    52. 

  52.     
    53. 

  53.     <ul class="simple simple-toc" id="toc-list">
    54. 

  54.   <li>
    55. 

  55.   <a class="reference reference-toplevel" href="#6" id="56">Imports</a>
    56. 

  56. </li>
    57. 

  57. <li>
    58. 

  58.   <details open>
    59. 

  59.     <summary><a class="reference reference-toplevel" href="#7" id="57">Types</a></summary>
    60. 

  60.     <ul class="simple simple-toc-section">
    61. 

  61.       <li><a class="reference" href="#BinaryPrefixMode" title="BinaryPrefixMode = enum
    62. 

  62.   bpIEC, bpColloquial">BinaryPrefixMode</a></li>
    63. 

  63. <li><a class="reference" href="#FloatFormatMode" title="FloatFormatMode = enum
    64. 

  64.   ffDefault,                ## use the shorter floating point notation
    65. 

  65.   ffDecimal,                ## use decimal floating point notation
    66. 

  66.   ffScientific               ## use scientific notation (using `e` character)">FloatFormatMode</a></li>
    67. 

  67. <li><a class="reference" href="#SkipTable" title="SkipTable = array[char, int]">SkipTable</a></li>
    68. 

  68. 

  69.     </ul>
    70. 

  70.   </details>
    71. 

  71. </li>
    72. 

  72. <li>
    73. 

  73.   <details open>
    74. 

  74.     <summary><a class="reference reference-toplevel" href="#10" id="60">Consts</a></summary>
    75. 

  75.     <ul class="simple simple-toc-section">
    76. 

  76.       <li><a class="reference" href="#AllChars" title="AllChars = {'\x00'..'\xFF'}">AllChars</a></li>
    77. 

  77. <li><a class="reference" href="#Digits" title="Digits = {'0'..'9'}">Digits</a></li>
    78. 

  78. <li><a class="reference" href="#HexDigits" title="HexDigits = {'0'..'9', 'A'..'F', 'a'..'f'}">HexDigits</a></li>
    79. 

  79. <li><a class="reference" href="#IdentChars" title="IdentChars = {'a'..'z', 'A'..'Z', '0'..'9', '_'}">IdentChars</a></li>
    80. 

  80. <li><a class="reference" href="#IdentStartChars" title="IdentStartChars = {'a'..'z', 'A'..'Z', '_'}">IdentStartChars</a></li>
    81. 

  81. <li><a class="reference" href="#Letters" title="Letters = {'A'..'Z', 'a'..'z'}">Letters</a></li>
    82. 

  82. <li><a class="reference" href="#LowercaseLetters" title="LowercaseLetters = {'a'..'z'}">LowercaseLetters</a></li>
    83. 

  83. <li><a class="reference" href="#Newlines" title="Newlines = {'\r', '\n'}">Newlines</a></li>
    84. 

  84. <li><a class="reference" href="#PrintableChars" title="PrintableChars = {'\t'..'\r', ' '..'~'}">PrintableChars</a></li>
    85. 

  85. <li><a class="reference" href="#PunctuationChars" title="PunctuationChars = {'!'..'/', ':'..'@', '['..'`', '{'..'~'}">PunctuationChars</a></li>
    86. 

  86. <li><a class="reference" href="#UppercaseLetters" title="UppercaseLetters = {'A'..'Z'}">UppercaseLetters</a></li>
    87. 

  87. <li><a class="reference" href="#Whitespace" title="Whitespace = {' ', '\t', '\v', '\r', '\n', '\f'}">Whitespace</a></li>
    88. 

  88. 

  89.     </ul>
    90. 

  90.   </details>
    91. 

  91. </li>
    92. 

  92. <li>
    93. 

  93.   <details open>
    94. 

  94.     <summary><a class="reference reference-toplevel" href="#12" id="62">Procs</a></summary>
    95. 

  95.     <ul class="simple simple-toc-section">
    96. 

  96.       <ul class="simple nested-toc-section">%
    97. 

  97.   <li><a class="reference" href="#%25%2Cstring%2Cstring" title="`%`(formatstr, a: string): string">`%`(formatstr, a: string): string</a></li>
    98. 

  98. <li><a class="reference" href="#%25%2Cstring%2CopenArray%5Bstring%5D" title="`%`(formatstr: string; a: openArray[string]): string">`%`(formatstr: string; a: openArray[string]): string</a></li>
    99. 

  99. 

  100. </ul>
    101. 

  101. <ul class="simple nested-toc-section">abbrev
    102. 

  102.   <li><a class="reference" href="#abbrev%2Cstring%2CopenArray%5Bstring%5D" title="abbrev(s: string; possibilities: openArray[string]): int">abbrev(s: string; possibilities: openArray[string]): int</a></li>
    103. 

  103. 

  104. </ul>
    105. 

  105. <ul class="simple nested-toc-section">addf
    106. 

  106.   <li><a class="reference" href="#addf%2Cstring%2Cstring%2Cvarargs%5Bstring%2C%5D" title="addf(s: var string; formatstr: string; a: varargs[string, `$`])">addf(s: var string; formatstr: string; a: varargs[string, `$`])</a></li>
    107. 

  107. 

  108. </ul>
    109. 

  109. <ul class="simple nested-toc-section">addSep
    110. 

  110.   <li><a class="reference" href="#addSep%2Cstring%2Cstring%2CNatural" title="addSep(dest: var string; sep = &quot;, &quot;; startLen: Natural = 0)">addSep(dest: var string; sep = &quot;, &quot;; startLen: Natural = 0)</a></li>
    111. 

  111. 

  112. </ul>
    113. 

  113. <ul class="simple nested-toc-section">align
    114. 

  114.   <li><a class="reference" href="#align%2Cstring%2CNatural%2Cchar" title="align(s: string; count: Natural; padding = ' '): string">align(s: string; count: Natural; padding = ' '): string</a></li>
    115. 

  115. 

  116. </ul>
    117. 

  117. <ul class="simple nested-toc-section">alignLeft
    118. 

  118.   <li><a class="reference" href="#alignLeft%2Cstring%2CNatural%2Cchar" title="alignLeft(s: string; count: Natural; padding = ' '): string">alignLeft(s: string; count: Natural; padding = ' '): string</a></li>
    119. 

  119. 

  120. </ul>
    121. 

  121. <ul class="simple nested-toc-section">allCharsInSet
    122. 

  122.   <li><a class="reference" href="#allCharsInSet%2Cstring%2Cset%5Bchar%5D" title="allCharsInSet(s: string; theSet: set[char]): bool">allCharsInSet(s: string; theSet: set[char]): bool</a></li>
    123. 

  123. 

  124. </ul>
    125. 

  125. <ul class="simple nested-toc-section">capitalizeAscii
    126. 

  126.   <li><a class="reference" href="#capitalizeAscii%2Cstring" title="capitalizeAscii(s: string): string">capitalizeAscii(s: string): string</a></li>
    127. 

  127. 

  128. </ul>
    129. 

  129. <ul class="simple nested-toc-section">center
    130. 

  130.   <li><a class="reference" href="#center%2Cstring%2Cint%2Cchar" title="center(s: string; width: int; fillChar: char = ' '): string">center(s: string; width: int; fillChar: char = ' '): string</a></li>
    131. 

  131. 

  132. </ul>
    133. 

  133. <ul class="simple nested-toc-section">cmpIgnoreCase
    134. 

  134.   <li><a class="reference" href="#cmpIgnoreCase%2Cstring%2Cstring" title="cmpIgnoreCase(a, b: string): int">cmpIgnoreCase(a, b: string): int</a></li>
    135. 

  135. 

  136. </ul>
    137. 

  137. <ul class="simple nested-toc-section">cmpIgnoreStyle
    138. 

  138.   <li><a class="reference" href="#cmpIgnoreStyle%2Cstring%2Cstring" title="cmpIgnoreStyle(a, b: string): int">cmpIgnoreStyle(a, b: string): int</a></li>
    139. 

  139. 

  140. </ul>
    141. 

  141. <ul class="simple nested-toc-section">contains
    142. 

  142.   <li><a class="reference" href="#contains%2Cstring%2Cstring" title="contains(s, sub: string): bool">contains(s, sub: string): bool</a></li>
    143. 

  143. <li><a class="reference" href="#contains%2Cstring%2Cset%5Bchar%5D" title="contains(s: string; chars: set[char]): bool">contains(s: string; chars: set[char]): bool</a></li>
    144. 

  144. 

  145. </ul>
    146. 

  146. <ul class="simple nested-toc-section">continuesWith
    147. 

  147.   <li><a class="reference" href="#continuesWith%2Cstring%2Cstring%2CNatural" title="continuesWith(s, substr: string; start: Natural): bool">continuesWith(s, substr: string; start: Natural): bool</a></li>
    148. 

  148. 

  149. </ul>
    150. 

  150. <ul class="simple nested-toc-section">count
    151. 

  151.   <li><a class="reference" href="#count%2Cstring%2Cchar" title="count(s: string; sub: char): int">count(s: string; sub: char): int</a></li>
    152. 

  152. <li><a class="reference" href="#count%2Cstring%2Cstring%2Cbool" title="count(s: string; sub: string; overlapping: bool = false): int">count(s: string; sub: string; overlapping: bool = false): int</a></li>
    153. 

  153. <li><a class="reference" href="#count%2Cstring%2Cset%5Bchar%5D" title="count(s: string; subs: set[char]): int">count(s: string; subs: set[char]): int</a></li>
    154. 

  154. 

  155. </ul>
    156. 

  156. <ul class="simple nested-toc-section">countLines
    157. 

  157.   <li><a class="reference" href="#countLines%2Cstring" title="countLines(s: string): int">countLines(s: string): int</a></li>
    158. 

  158. 

  159. </ul>
    160. 

  160. <ul class="simple nested-toc-section">dedent
    161. 

  161.   <li><a class="reference" href="#dedent%2Cstring%2CNatural" title="dedent(s: string; count: Natural = indentation(s)): string">dedent(s: string; count: Natural = indentation(s)): string</a></li>
    162. 

  162. 

  163. </ul>
    164. 

  164. <ul class="simple nested-toc-section">delete
    165. 

  165.   <li><a class="reference" href="#delete%2Cstring%2Cint%2Cint" title="delete(s: var string; first, last: int)">delete(s: var string; first, last: int)</a></li>
    166. 

  166. <li><a class="reference" href="#delete%2Cstring%2CSlice%5Bint%5D" title="delete(s: var string; slice: Slice[int])">delete(s: var string; slice: Slice[int])</a></li>
    167. 

  167. 

  168. </ul>
    169. 

  169. <ul class="simple nested-toc-section">endsWith
    170. 

  170.   <li><a class="reference" href="#endsWith%2Cstring%2Cstring" title="endsWith(s, suffix: string): bool">endsWith(s, suffix: string): bool</a></li>
    171. 

  171. <li><a class="reference" href="#endsWith%2Cstring%2Cchar" title="endsWith(s: string; suffix: char): bool">endsWith(s: string; suffix: char): bool</a></li>
    172. 

  172. 

  173. </ul>
    174. 

  174. <ul class="simple nested-toc-section">escape
    175. 

  175.   <li><a class="reference" href="#escape%2Cstring%2Cstring%2Cstring" title="escape(s: string; prefix = &quot;\&quot;&quot;; suffix = &quot;\&quot;&quot;): string">escape(s: string; prefix = &quot;\&quot;&quot;; suffix = &quot;\&quot;&quot;): string</a></li>
    176. 

  176. 

  177. </ul>
    178. 

  178. <ul class="simple nested-toc-section">find
    179. 

  179.   <li><a class="reference" href="#find%2CSkipTable%2Cstring%2Cstring%2CNatural%2Cint" title="find(a: SkipTable; s, sub: string; start: Natural = 0; last = -1): int">find(a: SkipTable; s, sub: string; start: Natural = 0; last = -1): int</a></li>
    180. 

  180. <li><a class="reference" href="#find%2Cstring%2Cstring%2CNatural%2Cint" title="find(s, sub: string; start: Natural = 0; last = -1): int">find(s, sub: string; start: Natural = 0; last = -1): int</a></li>
    181. 

  181. <li><a class="reference" href="#find%2Cstring%2Cset%5Bchar%5D%2CNatural%2Cint" title="find(s: string; chars: set[char]; start: Natural = 0; last = -1): int">find(s: string; chars: set[char]; start: Natural = 0; last = -1): int</a></li>
    182. 

  182. <li><a class="reference" href="#find%2Cstring%2Cchar%2CNatural%2Cint" title="find(s: string; sub: char; start: Natural = 0; last = -1): int">find(s: string; sub: char; start: Natural = 0; last = -1): int</a></li>
    183. 

  183. 

  184. </ul>
    185. 

  185. <ul class="simple nested-toc-section">format
    186. 

  186.   <li><a class="reference" href="#format%2Cstring%2Cvarargs%5Bstring%2C%5D" title="format(formatstr: string; a: varargs[string, `$`]): string">format(formatstr: string; a: varargs[string, `$`]): string</a></li>
    187. 

  187. 

  188. </ul>
    189. 

  189. <ul class="simple nested-toc-section">formatBiggestFloat
    190. 

  190.   <li><a class="reference" href="#formatBiggestFloat%2CBiggestFloat%2CFloatFormatMode%2Crange%5B%5D%2Cchar" title="formatBiggestFloat(f: BiggestFloat; format: FloatFormatMode = ffDefault;
    191. 

  191.                    precision: range[-1 .. 32] = 16; decimalSep = '.'): string">formatBiggestFloat(f: BiggestFloat; format: FloatFormatMode = ffDefault;
    192. 

  192.                    precision: range[-1 .. 32] = 16; decimalSep = '.'): string</a></li>
    193. 

  193. 

  194. </ul>
    195. 

  195. <ul class="simple nested-toc-section">formatEng
    196. 

  196.   <li><a class="reference" href="#formatEng%2CBiggestFloat%2Crange%5B%5D%2Cbool%2Cbool%2Cstring%2Cchar" title="formatEng(f: BiggestFloat; precision: range[0 .. 32] = 10; trim: bool = true;
    197. 

  197.           siPrefix: bool = false; unit: string = &quot;&quot;; decimalSep = '.';
    198. 

  198.           useUnitSpace = false): string">formatEng(f: BiggestFloat; precision: range[0 .. 32] = 10; trim: bool = true;
    199. 

  199.           siPrefix: bool = false; unit: string = &quot;&quot;; decimalSep = '.';
    200. 

  200.           useUnitSpace = false): string</a></li>
    201. 

  201. 

  202. </ul>
    203. 

  203. <ul class="simple nested-toc-section">formatFloat
    204. 

  204.   <li><a class="reference" href="#formatFloat%2Cfloat%2CFloatFormatMode%2Crange%5B%5D%2Cchar" title="formatFloat(f: float; format: FloatFormatMode = ffDefault;
    205. 

  205.             precision: range[-1 .. 32] = 16; decimalSep = '.'): string">formatFloat(f: float; format: FloatFormatMode = ffDefault;
    206. 

  206.             precision: range[-1 .. 32] = 16; decimalSep = '.'): string</a></li>
    207. 

  207. 

  208. </ul>
    209. 

  209. <ul class="simple nested-toc-section">formatSize
    210. 

  210.   <li><a class="reference" href="#formatSize%2Cint64%2Cchar" title="formatSize(bytes: int64; decimalSep = '.'; prefix = bpIEC; includeSpace = false): string">formatSize(bytes: int64; decimalSep = '.'; prefix = bpIEC; includeSpace = false): string</a></li>
    211. 

  211. 

  212. </ul>
    213. 

  213. <ul class="simple nested-toc-section">fromBin
    214. 

  214.   <li><a class="reference" href="#fromBin%2Cstring" title="fromBin[T: SomeInteger](s: string): T">fromBin[T: SomeInteger](s: string): T</a></li>
    215. 

  215. 

  216. </ul>
    217. 

  217. <ul class="simple nested-toc-section">fromHex
    218. 

  218.   <li><a class="reference" href="#fromHex%2Cstring" title="fromHex[T: SomeInteger](s: string): T">fromHex[T: SomeInteger](s: string): T</a></li>
    219. 

  219. 

  220. </ul>
    221. 

  221. <ul class="simple nested-toc-section">fromOct
    222. 

  222.   <li><a class="reference" href="#fromOct%2Cstring" title="fromOct[T: SomeInteger](s: string): T">fromOct[T: SomeInteger](s: string): T</a></li>
    223. 

  223. 

  224. </ul>
    225. 

  225. <ul class="simple nested-toc-section">indent
    226. 

  226.   <li><a class="reference" href="#indent%2Cstring%2CNatural%2Cstring" title="indent(s: string; count: Natural; padding: string = &quot; &quot;): string">indent(s: string; count: Natural; padding: string = &quot; &quot;): string</a></li>
    227. 

  227. 

  228. </ul>
    229. 

  229. <ul class="simple nested-toc-section">indentation
    230. 

  230.   <li><a class="reference" href="#indentation%2Cstring" title="indentation(s: string): Natural">indentation(s: string): Natural</a></li>
    231. 

  231. 

  232. </ul>
    233. 

  233. <ul class="simple nested-toc-section">initSkipTable
    234. 

  234.   <li><a class="reference" href="#initSkipTable%2CSkipTable%2Cstring" title="initSkipTable(a: var SkipTable; sub: string)">initSkipTable(a: var SkipTable; sub: string)</a></li>
    235. 

  235. <li><a class="reference" href="#initSkipTable%2Cstring" title="initSkipTable(sub: string): SkipTable">initSkipTable(sub: string): SkipTable</a></li>
    236. 

  236. 

  237. </ul>
    238. 

  238. <ul class="simple nested-toc-section">insertSep
    239. 

  239.   <li><a class="reference" href="#insertSep%2Cstring%2Cchar%2Cint" title="insertSep(s: string; sep = '_'; digits = 3): string">insertSep(s: string; sep = '_'; digits = 3): string</a></li>
    240. 

  240. 

  241. </ul>
    242. 

  242. <ul class="simple nested-toc-section">intToStr
    243. 

  243.   <li><a class="reference" href="#intToStr%2Cint%2CPositive" title="intToStr(x: int; minchars: Positive = 1): string">intToStr(x: int; minchars: Positive = 1): string</a></li>
    244. 

  244. 

  245. </ul>
    246. 

  246. <ul class="simple nested-toc-section">isAlphaAscii
    247. 

  247.   <li><a class="reference" href="#isAlphaAscii%2Cchar" title="isAlphaAscii(c: char): bool">isAlphaAscii(c: char): bool</a></li>
    248. 

  248. 

  249. </ul>
    250. 

  250. <ul class="simple nested-toc-section">isAlphaNumeric
    251. 

  251.   <li><a class="reference" href="#isAlphaNumeric%2Cchar" title="isAlphaNumeric(c: char): bool">isAlphaNumeric(c: char): bool</a></li>
    252. 

  252. 

  253. </ul>
    254. 

  254. <ul class="simple nested-toc-section">isDigit
    255. 

  255.   <li><a class="reference" href="#isDigit%2Cchar" title="isDigit(c: char): bool">isDigit(c: char): bool</a></li>
    256. 

  256. 

  257. </ul>
    258. 

  258. <ul class="simple nested-toc-section">isEmptyOrWhitespace
    259. 

  259.   <li><a class="reference" href="#isEmptyOrWhitespace%2Cstring" title="isEmptyOrWhitespace(s: string): bool">isEmptyOrWhitespace(s: string): bool</a></li>
    260. 

  260. 

  261. </ul>
    262. 

  262. <ul class="simple nested-toc-section">isLowerAscii
    263. 

  263.   <li><a class="reference" href="#isLowerAscii%2Cchar" title="isLowerAscii(c: char): bool">isLowerAscii(c: char): bool</a></li>
    264. 

  264. 

  265. </ul>
    266. 

  266. <ul class="simple nested-toc-section">isSpaceAscii
    267. 

  267.   <li><a class="reference" href="#isSpaceAscii%2Cchar" title="isSpaceAscii(c: char): bool">isSpaceAscii(c: char): bool</a></li>
    268. 

  268. 

  269. </ul>
    270. 

  270. <ul class="simple nested-toc-section">isUpperAscii
    271. 

  271.   <li><a class="reference" href="#isUpperAscii%2Cchar" title="isUpperAscii(c: char): bool">isUpperAscii(c: char): bool</a></li>
    272. 

  272. 

  273. </ul>
    274. 

  274. <ul class="simple nested-toc-section">join
    275. 

  275.   <li><a class="reference" href="#join%2CopenArray%5Bstring%5D%2Cstring" title="join(a: openArray[string]; sep: string = &quot;&quot;): string">join(a: openArray[string]; sep: string = &quot;&quot;): string</a></li>
    276. 

  276. <li><a class="reference" href="#join%2CopenArray%5BT%5D%2Cstring" title="join[T: not string](a: openArray[T]; sep: string = &quot;&quot;): string">join[T: not string](a: openArray[T]; sep: string = &quot;&quot;): string</a></li>
    277. 

  277. 

  278. </ul>
    279. 

  279. <ul class="simple nested-toc-section">multiReplace
    280. 

  280.   <li><a class="reference" href="#multiReplace%2Cstring%2Cvarargs%5B%5D" title="multiReplace(s: string; replacements: varargs[(string, string)]): string">multiReplace(s: string; replacements: varargs[(string, string)]): string</a></li>
    281. 

  281. 

  282. </ul>
    283. 

  283. <ul class="simple nested-toc-section">nimIdentNormalize
    284. 

  284.   <li><a class="reference" href="#nimIdentNormalize%2Cstring" title="nimIdentNormalize(s: string): string">nimIdentNormalize(s: string): string</a></li>
    285. 

  285. 

  286. </ul>
    287. 

  287. <ul class="simple nested-toc-section">normalize
    288. 

  288.   <li><a class="reference" href="#normalize%2Cstring" title="normalize(s: string): string">normalize(s: string): string</a></li>
    289. 

  289. 

  290. </ul>
    291. 

  291. <ul class="simple nested-toc-section">parseBiggestInt
    292. 

  292.   <li><a class="reference" href="#parseBiggestInt%2Cstring" title="parseBiggestInt(s: string): BiggestInt">parseBiggestInt(s: string): BiggestInt</a></li>
    293. 

  293. 

  294. </ul>
    295. 

  295. <ul class="simple nested-toc-section">parseBiggestUInt
    296. 

  296.   <li><a class="reference" href="#parseBiggestUInt%2Cstring" title="parseBiggestUInt(s: string): BiggestUInt">parseBiggestUInt(s: string): BiggestUInt</a></li>
    297. 

  297. 

  298. </ul>
    299. 

  299. <ul class="simple nested-toc-section">parseBinInt
    300. 

  300.   <li><a class="reference" href="#parseBinInt%2Cstring" title="parseBinInt(s: string): int">parseBinInt(s: string): int</a></li>
    301. 

  301. 

  302. </ul>
    303. 

  303. <ul class="simple nested-toc-section">parseBool
    304. 

  304.   <li><a class="reference" href="#parseBool%2Cstring" title="parseBool(s: string): bool">parseBool(s: string): bool</a></li>
    305. 

  305. 

  306. </ul>
    307. 

  307. <ul class="simple nested-toc-section">parseEnum
    308. 

  308.   <li><a class="reference" href="#parseEnum%2Cstring" title="parseEnum[T: enum](s: string): T">parseEnum[T: enum](s: string): T</a></li>
    309. 

  309. <li><a class="reference" href="#parseEnum%2Cstring%2CT" title="parseEnum[T: enum](s: string; default: T): T">parseEnum[T: enum](s: string; default: T): T</a></li>
    310. 

  310. 

  311. </ul>
    312. 

  312. <ul class="simple nested-toc-section">parseFloat
    313. 

  313.   <li><a class="reference" href="#parseFloat%2Cstring" title="parseFloat(s: string): float">parseFloat(s: string): float</a></li>
    314. 

  314. 

  315. </ul>
    316. 

  316. <ul class="simple nested-toc-section">parseHexInt
    317. 

  317.   <li><a class="reference" href="#parseHexInt%2Cstring" title="parseHexInt(s: string): int">parseHexInt(s: string): int</a></li>
    318. 

  318. 

  319. </ul>
    320. 

  320. <ul class="simple nested-toc-section">parseHexStr
    321. 

  321.   <li><a class="reference" href="#parseHexStr%2Cstring" title="parseHexStr(s: string): string">parseHexStr(s: string): string</a></li>
    322. 

  322. 

  323. </ul>
    324. 

  324. <ul class="simple nested-toc-section">parseInt
    325. 

  325.   <li><a class="reference" href="#parseInt%2Cstring" title="parseInt(s: string): int">parseInt(s: string): int</a></li>
    326. 

  326. 

  327. </ul>
    328. 

  328. <ul class="simple nested-toc-section">parseOctInt
    329. 

  329.   <li><a class="reference" href="#parseOctInt%2Cstring" title="parseOctInt(s: string): int">parseOctInt(s: string): int</a></li>
    330. 

  330. 

  331. </ul>
    332. 

  332. <ul class="simple nested-toc-section">parseUInt
    333. 

  333.   <li><a class="reference" href="#parseUInt%2Cstring" title="parseUInt(s: string): uint">parseUInt(s: string): uint</a></li>
    334. 

  334. 

  335. </ul>
    336. 

  336. <ul class="simple nested-toc-section">removePrefix
    337. 

  337.   <li><a class="reference" href="#removePrefix%2Cstring%2Cchar" title="removePrefix(s: var string; c: char)">removePrefix(s: var string; c: char)</a></li>
    338. 

  338. <li><a class="reference" href="#removePrefix%2Cstring%2Cset%5Bchar%5D" title="removePrefix(s: var string; chars: set[char] = Newlines)">removePrefix(s: var string; chars: set[char] = Newlines)</a></li>
    339. 

  339. <li><a class="reference" href="#removePrefix%2Cstring%2Cstring" title="removePrefix(s: var string; prefix: string)">removePrefix(s: var string; prefix: string)</a></li>
    340. 

  340. 

  341. </ul>
    342. 

  342. <ul class="simple nested-toc-section">removeSuffix
    343. 

  343.   <li><a class="reference" href="#removeSuffix%2Cstring%2Cchar" title="removeSuffix(s: var string; c: char)">removeSuffix(s: var string; c: char)</a></li>
    344. 

  344. <li><a class="reference" href="#removeSuffix%2Cstring%2Cset%5Bchar%5D" title="removeSuffix(s: var string; chars: set[char] = Newlines)">removeSuffix(s: var string; chars: set[char] = Newlines)</a></li>
    345. 

  345. <li><a class="reference" href="#removeSuffix%2Cstring%2Cstring" title="removeSuffix(s: var string; suffix: string)">removeSuffix(s: var string; suffix: string)</a></li>
    346. 

  346. 

  347. </ul>
    348. 

  348. <ul class="simple nested-toc-section">repeat
    349. 

  349.   <li><a class="reference" href="#repeat%2Cchar%2CNatural" title="repeat(c: char; count: Natural): string">repeat(c: char; count: Natural): string</a></li>
    350. 

  350. <li><a class="reference" href="#repeat%2Cstring%2CNatural" title="repeat(s: string; n: Natural): string">repeat(s: string; n: Natural): string</a></li>
    351. 

  351. 

  352. </ul>
    353. 

  353. <ul class="simple nested-toc-section">replace
    354. 

  354.   <li><a class="reference" href="#replace%2Cstring%2Cstring%2Cstring" title="replace(s, sub: string; by = &quot;&quot;): string">replace(s, sub: string; by = &quot;&quot;): string</a></li>
    355. 

  355. <li><a class="reference" href="#replace%2Cstring%2Cchar%2Cchar" title="replace(s: string; sub, by: char): string">replace(s: string; sub, by: char): string</a></li>
    356. 

  356. 

  357. </ul>
    358. 

  358. <ul class="simple nested-toc-section">replaceWord
    359. 

  359.   <li><a class="reference" href="#replaceWord%2Cstring%2Cstring%2Cstring" title="replaceWord(s, sub: string; by = &quot;&quot;): string">replaceWord(s, sub: string; by = &quot;&quot;): string</a></li>
    360. 

  360. 

  361. </ul>
    362. 

  362. <ul class="simple nested-toc-section">rfind
    363. 

  363.   <li><a class="reference" href="#rfind%2Cstring%2Cstring%2CNatural%2Cint" title="rfind(s, sub: string; start: Natural = 0; last = -1): int">rfind(s, sub: string; start: Natural = 0; last = -1): int</a></li>
    364. 

  364. <li><a class="reference" href="#rfind%2Cstring%2Cset%5Bchar%5D%2CNatural%2Cint" title="rfind(s: string; chars: set[char]; start: Natural = 0; last = -1): int">rfind(s: string; chars: set[char]; start: Natural = 0; last = -1): int</a></li>
    365. 

  365. <li><a class="reference" href="#rfind%2Cstring%2Cchar%2CNatural%2Cint" title="rfind(s: string; sub: char; start: Natural = 0; last = -1): int">rfind(s: string; sub: char; start: Natural = 0; last = -1): int</a></li>
    366. 

  366. 

  367. </ul>
    368. 

  368. <ul class="simple nested-toc-section">rsplit
    369. 

  369.   <li><a class="reference" href="#rsplit%2Cstring%2Cchar%2Cint" title="rsplit(s: string; sep: char; maxsplit: int = -1): seq[string]">rsplit(s: string; sep: char; maxsplit: int = -1): seq[string]</a></li>
    370. 

  370. <li><a class="reference" href="#rsplit%2Cstring%2Cstring%2Cint" title="rsplit(s: string; sep: string; maxsplit: int = -1): seq[string]">rsplit(s: string; sep: string; maxsplit: int = -1): seq[string]</a></li>
    371. 

  371. <li><a class="reference" href="#rsplit%2Cstring%2Cset%5Bchar%5D%2Cint" title="rsplit(s: string; seps: set[char] = Whitespace; maxsplit: int = -1): seq[string]">rsplit(s: string; seps: set[char] = Whitespace; maxsplit: int = -1): seq[string]</a></li>
    372. 

  372. 

  373. </ul>
    374. 

  374. <ul class="simple nested-toc-section">spaces
    375. 

  375.   <li><a class="reference" href="#spaces%2CNatural" title="spaces(n: Natural): string">spaces(n: Natural): string</a></li>
    376. 

  376. 

  377. </ul>
    378. 

  378. <ul class="simple nested-toc-section">split
    379. 

  379.   <li><a class="reference" href="#split%2Cstring%2Cchar%2Cint" title="split(s: string; sep: char; maxsplit: int = -1): seq[string]">split(s: string; sep: char; maxsplit: int = -1): seq[string]</a></li>
    380. 

  380. <li><a class="reference" href="#split%2Cstring%2Cstring%2Cint" title="split(s: string; sep: string; maxsplit: int = -1): seq[string]">split(s: string; sep: string; maxsplit: int = -1): seq[string]</a></li>
    381. 

  381. <li><a class="reference" href="#split%2Cstring%2Cset%5Bchar%5D%2Cint" title="split(s: string; seps: set[char] = Whitespace; maxsplit: int = -1): seq[string]">split(s: string; seps: set[char] = Whitespace; maxsplit: int = -1): seq[string]</a></li>
    382. 

  382. 

  383. </ul>
    384. 

  384. <ul class="simple nested-toc-section">splitLines
    385. 

  385.   <li><a class="reference" href="#splitLines%2Cstring" title="splitLines(s: string; keepEol = false): seq[string]">splitLines(s: string; keepEol = false): seq[string]</a></li>
    386. 

  386. 

  387. </ul>
    388. 

  388. <ul class="simple nested-toc-section">splitWhitespace
    389. 

  389.   <li><a class="reference" href="#splitWhitespace%2Cstring%2Cint" title="splitWhitespace(s: string; maxsplit: int = -1): seq[string]">splitWhitespace(s: string; maxsplit: int = -1): seq[string]</a></li>
    390. 

  390. 

  391. </ul>
    392. 

  392. <ul class="simple nested-toc-section">startsWith
    393. 

  393.   <li><a class="reference" href="#startsWith%2Cstring%2Cstring" title="startsWith(s, prefix: string): bool">startsWith(s, prefix: string): bool</a></li>
    394. 

  394. <li><a class="reference" href="#startsWith%2Cstring%2Cchar" title="startsWith(s: string; prefix: char): bool">startsWith(s: string; prefix: char): bool</a></li>
    395. 

  395. 

  396. </ul>
    397. 

  397. <ul class="simple nested-toc-section">strip
    398. 

  398.   <li><a class="reference" href="#strip%2Cstring%2Cset%5Bchar%5D" title="strip(s: string; leading = true; trailing = true; chars: set[char] = Whitespace): string">strip(s: string; leading = true; trailing = true; chars: set[char] = Whitespace): string</a></li>
    399. 

  399. 

  400. </ul>
    401. 

  401. <ul class="simple nested-toc-section">stripLineEnd
    402. 

  402.   <li><a class="reference" href="#stripLineEnd%2Cstring" title="stripLineEnd(s: var string)">stripLineEnd(s: var string)</a></li>
    403. 

  403. 

  404. </ul>
    405. 

  405. <ul class="simple nested-toc-section">toBin
    406. 

  406.   <li><a class="reference" href="#toBin%2CBiggestInt%2CPositive" title="toBin(x: BiggestInt; len: Positive): string">toBin(x: BiggestInt; len: Positive): string</a></li>
    407. 

  407. 

  408. </ul>
    409. 

  409. <ul class="simple nested-toc-section">toHex
    410. 

  410.   <li><a class="reference" href="#toHex%2Cstring" title="toHex(s: string): string">toHex(s: string): string</a></li>
    411. 

  411. <li><a class="reference" href="#toHex%2CT" title="toHex[T: SomeInteger](x: T): string">toHex[T: SomeInteger](x: T): string</a></li>
    412. 

  412. <li><a class="reference" href="#toHex%2CT%2CPositive" title="toHex[T: SomeInteger](x: T; len: Positive): string">toHex[T: SomeInteger](x: T; len: Positive): string</a></li>
    413. 

  413. 

  414. </ul>
    415. 

  415. <ul class="simple nested-toc-section">toLowerAscii
    416. 

  416.   <li><a class="reference" href="#toLowerAscii%2Cchar" title="toLowerAscii(c: char): char">toLowerAscii(c: char): char</a></li>
    417. 

  417. <li><a class="reference" href="#toLowerAscii%2Cstring" title="toLowerAscii(s: string): string">toLowerAscii(s: string): string</a></li>
    418. 

  418. 

  419. </ul>
    420. 

  420. <ul class="simple nested-toc-section">toOct
    421. 

  421.   <li><a class="reference" href="#toOct%2CBiggestInt%2CPositive" title="toOct(x: BiggestInt; len: Positive): string">toOct(x: BiggestInt; len: Positive): string</a></li>
    422. 

  422. 

  423. </ul>
    424. 

  424. <ul class="simple nested-toc-section">toOctal
    425. 

  425.   <li><a class="reference" href="#toOctal%2Cchar" title="toOctal(c: char): string">toOctal(c: char): string</a></li>
    426. 

  426. 

  427. </ul>
    428. 

  428. <ul class="simple nested-toc-section">toUpperAscii
    429. 

  429.   <li><a class="reference" href="#toUpperAscii%2Cchar" title="toUpperAscii(c: char): char">toUpperAscii(c: char): char</a></li>
    430. 

  430. <li><a class="reference" href="#toUpperAscii%2Cstring" title="toUpperAscii(s: string): string">toUpperAscii(s: string): string</a></li>
    431. 

  431. 

  432. </ul>
    433. 

  433. <ul class="simple nested-toc-section">trimZeros
    434. 

  434.   <li><a class="reference" href="#trimZeros%2Cstring%2Cchar" title="trimZeros(x: var string; decimalSep = '.')">trimZeros(x: var string; decimalSep = '.')</a></li>
    435. 

  435. 

  436. </ul>
    437. 

  437. <ul class="simple nested-toc-section">unescape
    438. 

  438.   <li><a class="reference" href="#unescape%2Cstring%2Cstring%2Cstring" title="unescape(s: string; prefix = &quot;\&quot;&quot;; suffix = &quot;\&quot;&quot;): string">unescape(s: string; prefix = &quot;\&quot;&quot;; suffix = &quot;\&quot;&quot;): string</a></li>
    439. 

  439. 

  440. </ul>
    441. 

  441. <ul class="simple nested-toc-section">unindent
    442. 

  442.   <li><a class="reference" href="#unindent%2Cstring%2CNatural%2Cstring" title="unindent(s: string; count: Natural = int.high; padding: string = &quot; &quot;): string">unindent(s: string; count: Natural = int.high; padding: string = &quot; &quot;): string</a></li>
    443. 

  443. 

  444. </ul>
    445. 

  445. <ul class="simple nested-toc-section">validIdentifier
    446. 

  446.   <li><a class="reference" href="#validIdentifier%2Cstring" title="validIdentifier(s: string): bool">validIdentifier(s: string): bool</a></li>
    447. 

  447. 

  448. </ul>
    449. 

  449. 

  450.     </ul>
    451. 

  451.   </details>
    452. 

  452. </li>
    453. 

  453. <li>
    454. 

  454.   <details open>
    455. 

  455.     <summary><a class="reference reference-toplevel" href="#15" id="65">Iterators</a></summary>
    456. 

  456.     <ul class="simple simple-toc-section">
    457. 

  457.       <ul class="simple nested-toc-section">rsplit
    458. 

  458.   <li><a class="reference" href="#rsplit.i%2Cstring%2Cchar%2Cint" title="rsplit(s: string; sep: char; maxsplit: int = -1): string">rsplit(s: string; sep: char; maxsplit: int = -1): string</a></li>
    459. 

  459. <li><a class="reference" href="#rsplit.i%2Cstring%2Cstring%2Cint%2Cbool" title="rsplit(s: string; sep: string; maxsplit: int = -1; keepSeparators: bool = false): string">rsplit(s: string; sep: string; maxsplit: int = -1; keepSeparators: bool = false): string</a></li>
    460. 

  460. <li><a class="reference" href="#rsplit.i%2Cstring%2Cset%5Bchar%5D%2Cint" title="rsplit(s: string; seps: set[char] = Whitespace; maxsplit: int = -1): string">rsplit(s: string; seps: set[char] = Whitespace; maxsplit: int = -1): string</a></li>
    461. 

  461. 

  462. </ul>
    463. 

  463. <ul class="simple nested-toc-section">split
    464. 

  464.   <li><a class="reference" href="#split.i%2Cstring%2Cchar%2Cint" title="split(s: string; sep: char; maxsplit: int = -1): string">split(s: string; sep: char; maxsplit: int = -1): string</a></li>
    465. 

  465. <li><a class="reference" href="#split.i%2Cstring%2Cstring%2Cint" title="split(s: string; sep: string; maxsplit: int = -1): string">split(s: string; sep: string; maxsplit: int = -1): string</a></li>
    466. 

  466. <li><a class="reference" href="#split.i%2Cstring%2Cset%5Bchar%5D%2Cint" title="split(s: string; seps: set[char] = Whitespace; maxsplit: int = -1): string">split(s: string; seps: set[char] = Whitespace; maxsplit: int = -1): string</a></li>
    467. 

  467. 

  468. </ul>
    469. 

  469. <ul class="simple nested-toc-section">splitLines
    470. 

  470.   <li><a class="reference" href="#splitLines.i%2Cstring" title="splitLines(s: string; keepEol = false): string">splitLines(s: string; keepEol = false): string</a></li>
    471. 

  471. 

  472. </ul>
    473. 

  473. <ul class="simple nested-toc-section">splitWhitespace
    474. 

  474.   <li><a class="reference" href="#splitWhitespace.i%2Cstring%2Cint" title="splitWhitespace(s: string; maxsplit: int = -1): string">splitWhitespace(s: string; maxsplit: int = -1): string</a></li>
    475. 

  475. 

  476. </ul>
    477. 

  477. <ul class="simple nested-toc-section">tokenize
    478. 

  478.   <li><a class="reference" href="#tokenize.i%2Cstring%2Cset%5Bchar%5D" title="tokenize(s: string; seps: set[char] = Whitespace): tuple[token: string,
    479. 

  479.     isSep: bool]">tokenize(s: string; seps: set[char] = Whitespace): tuple[token: string,
    480. 

  480.     isSep: bool]</a></li>
    481. 

  481. 

  482. </ul>
    483. 

  483. 

  484.     </ul>
    485. 

  485.   </details>
    486. 

  486. </li>
    487. 

  487. 

  488. </ul>
    489. 

  489. 

  490.   </div>
    491. 

  491.   <div class="nine columns" id="content">
    492. 

  492.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    493. 

  493. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    494. 

  494. 

  495.     <div id="tocRoot"></div>
    496. 

  496.     
    497. 

  497.     <p class="module-desc">The system module defines several common functions for working with strings, such as:<ul class="simple"><li><tt class="docutils literal"><span class="pre"><span class="Operator">$</span></span></tt> for converting other data-types to strings</li>
    498. 

  498. <li><tt class="docutils literal"><span class="pre"><span class="Operator">&amp;</span></span></tt> for string concatenation</li>
    499. 

  499. <li><tt class="docutils literal"><span class="pre"><span class="Identifier">add</span></span></tt> for adding a new character or a string to the existing one</li>
    500. 

  500. <li><tt class="docutils literal"><span class="pre"><span class="Keyword">in</span></span></tt> (alias for <tt class="docutils literal"><span class="pre"><span class="Identifier">contains</span></span></tt>) and <tt class="docutils literal"><span class="pre"><span class="Keyword">notin</span></span></tt> for checking if a character is in a string</li>
    501. 

  501. </ul>
    502. 

  502. <p>This module builds upon that, providing additional functionality in form of procedures, iterators and templates for strings.</p>
    503. 

  503. 

  504. <p><strong class="examples_text">Example:</strong></p>
    505. 

  505. <pre class="listing"><span class="Keyword">import</span> <span class="Identifier">std</span><span class="Operator">/</span><span class="Identifier">strutils</span>
    506. 

  506. <span class="Keyword">let</span>
    507. 

  507.   <span class="Identifier">numbers</span> <span class="Operator">=</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="DecNumber">867</span><span class="Punctuation">,</span> <span class="DecNumber">5309</span><span class="Punctuation">]</span>
    508. 

  508.   <span class="Identifier">multiLineString</span> <span class="Operator">=</span> <span class="StringLit">&quot;first line</span><span class="EscapeSequence">\n</span><span class="StringLit">second line</span><span class="EscapeSequence">\n</span><span class="StringLit">third line&quot;</span>
    509. 

  509. 

  510. <span class="Keyword">let</span> <span class="Identifier">jenny</span> <span class="Operator">=</span> <span class="Identifier">numbers</span><span class="Operator">.</span><span class="Identifier">join</span><span class="Punctuation">(</span><span class="StringLit">&quot;-&quot;</span><span class="Punctuation">)</span>
    511. 

  511. <span class="Identifier">assert</span> <span class="Identifier">jenny</span> <span class="Operator">==</span> <span class="StringLit">&quot;867-5309&quot;</span>
    512. 

  512. 

  513. <span class="Identifier">assert</span> <span class="Identifier">splitLines</span><span class="Punctuation">(</span><span class="Identifier">multiLineString</span><span class="Punctuation">)</span> <span class="Operator">==</span>
    514. 

  514.        <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;first line&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;second line&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;third line&quot;</span><span class="Punctuation">]</span>
    515. 

  515. <span class="Identifier">assert</span> <span class="Identifier">split</span><span class="Punctuation">(</span><span class="Identifier">multiLineString</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;first&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;line&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;second&quot;</span><span class="Punctuation">,</span>
    516. 

  516.                                    <span class="StringLit">&quot;line&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;third&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;line&quot;</span><span class="Punctuation">]</span>
    517. 

  517. <span class="Identifier">assert</span> <span class="Identifier">indent</span><span class="Punctuation">(</span><span class="Identifier">multiLineString</span><span class="Punctuation">,</span> <span class="DecNumber">4</span><span class="Punctuation">)</span> <span class="Operator">==</span>
    518. 

  518.        <span class="StringLit">&quot;    first line</span><span class="EscapeSequence">\n</span><span class="StringLit">    second line</span><span class="EscapeSequence">\n</span><span class="StringLit">    third line&quot;</span>
    519. 

  519. <span class="Identifier">assert</span> <span class="CharLit">'z'</span><span class="Operator">.</span><span class="Identifier">repeat</span><span class="Punctuation">(</span><span class="DecNumber">5</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;zzzzz&quot;</span></pre>The chaining of functions is possible thanks to the <a class="reference external" href="manual.html#procedures-method-call-syntax">method call syntax</a>:
    520. 

  520. <p><strong class="examples_text">Example:</strong></p>
    521. 

  521. <pre class="listing"><span class="Keyword">import</span> <span class="Identifier">std</span><span class="Operator">/</span><span class="Identifier">strutils</span>
    522. 

  522. <span class="Keyword">from</span> <span class="Identifier">std</span><span class="Operator">/</span><span class="Identifier">sequtils</span> <span class="Keyword">import</span> <span class="Identifier">map</span>
    523. 

  523. 

  524. <span class="Keyword">let</span> <span class="Identifier">jenny</span> <span class="Operator">=</span> <span class="StringLit">&quot;867-5309&quot;</span>
    525. 

  525. <span class="Identifier">assert</span> <span class="Identifier">jenny</span><span class="Operator">.</span><span class="Identifier">split</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Operator">-</span><span class="CharLit">').map(parseInt) == @[867, 5309]</span>
    526. 

  526. 

  527. <span class="Identifier">assert</span> <span class="StringLit">&quot;Beetlejuice&quot;</span><span class="Operator">.</span><span class="Identifier">indent</span><span class="Punctuation">(</span><span class="DecNumber">1</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">repeat</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">strip</span> <span class="Operator">==</span>
    528. 

  528.        <span class="StringLit">&quot;Beetlejuice Beetlejuice Beetlejuice&quot;</span></pre>This module is available for the <a class="reference external" href="backends.html#backends-the-javascript-target">JavaScript target</a>.<hr />
    529. 

  529. <p><strong>See also:</strong></p>
    530. 

  530. <ul class="simple"><li><a class="reference external" href="strformat.html">strformat module</a> for string interpolation and formatting</li>
    531. 

  531. <li><a class="reference external" href="unicode.html">unicode module</a> for Unicode UTF-8 handling</li>
    532. 

  532. <li><a class="reference external" href="sequtils.html">sequtils module</a> for operations on container types (including strings)</li>
    533. 

  533. <li><a class="reference external" href="parsecsv.html">parsecsv module</a> for a high-performance CSV parser</li>
    534. 

  534. <li><a class="reference external" href="parseutils.html">parseutils module</a> for lower-level parsing of tokens, numbers, identifiers, etc.</li>
    535. 

  535. <li><a class="reference external" href="parseopt.html">parseopt module</a> for command-line parsing</li>
    536. 

  536. <li><a class="reference external" href="pegs.html">pegs module</a> for PEG (Parsing Expression Grammar) support</li>
    537. 

  537. <li><a class="reference external" href="strtabs.html">strtabs module</a> for efficient hash tables (dictionaries, in some programming languages) mapping from strings to strings</li>
    538. 

  538. <li><a class="reference external" href="ropes.html">ropes module</a> for rope data type, which can represent very long strings efficiently</li>
    539. 

  539. <li><a class="reference external" href="re.html">re module</a> for regular expression (regex) support</li>
    540. 

  540. <li><a class="reference external" href="strscans.html">strscans</a> for <tt class="docutils literal"><span class="pre"><span class="Identifier">scanf</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">scanp</span></span></tt> macros, which offer easier substring extraction than regular expressions</li>
    541. 

  541. </ul>
    542. 

  542. </p>
    543. 

  543.     <div class="section" id="6">
    544. 

  544.   <h1><a class="toc-backref" href="#6">Imports</a></h1>
    545. 

  545.   <dl class="item">
    546. 

  546.     <a class="reference external" href="parseutils.html">parseutils</a>, <a class="reference external" href="math.html">math</a>, <a class="reference external" href="algorithm.html">algorithm</a>, <a class="reference external" href="enumutils.html">enumutils</a>, <a class="reference external" href="unicode.html">unicode</a>, <a class="reference external" href="since.html">since</a>, <a class="reference external" href="jsutils.html">jsutils</a>, <a class="reference external" href="strimpl.html">strimpl</a>, <a class="reference external" href="assertions.html">assertions</a>
    547. 

  547.   </dl>
    548. 

  548. </div>
    549. 

  549. <div class="section" id="7">
    550. 

  550.   <h1><a class="toc-backref" href="#7">Types</a></h1>
    551. 

  551.   <dl class="item">
    552. 

  552.     <div id="BinaryPrefixMode">
    553. 

  553.   <dt><pre><a href="strutils.html#BinaryPrefixMode"><span class="Identifier">BinaryPrefixMode</span></a> <span class="Other">=</span> <span class="Keyword">enum</span>
    554. 

  554.   <span class="Identifier">bpIEC</span><span class="Other">,</span> <span class="Identifier">bpColloquial</span></pre></dt>
    555. 

  555.   <dd>
    556. 

  556.     
    557. 

  557.     The different names for binary prefixes.
    558. 

  558.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2588" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    559. 

  559. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2588" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    560. 

  560. 

  561.   </dd>
    562. 

  562. </div>
    563. 

  563. <div id="FloatFormatMode">
    564. 

  564.   <dt><pre><a href="strutils.html#FloatFormatMode"><span class="Identifier">FloatFormatMode</span></a> <span class="Other">=</span> <span class="Keyword">enum</span>
    565. 

  565.   <span class="Identifier">ffDefault</span><span class="Other">,</span>                <span class="Comment">## use the shorter floating point notation</span>
    566. 

  566.   <span class="Identifier">ffDecimal</span><span class="Other">,</span>                <span class="Comment">## use decimal floating point notation</span>
    567. 

  567.   <span class="Identifier">ffScientific</span>               <span class="Comment">## use scientific notation (using `e` character)</span></pre></dt>
    568. 

  568.   <dd>
    569. 

  569.     
    570. 

  570.     The different modes of floating point formatting.
    571. 

  571.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2464" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    572. 

  572. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2464" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    573. 

  573. 

  574.   </dd>
    575. 

  575. </div>
    576. 

  576. <div id="SkipTable">
    577. 

  577.   <dt><pre><a href="strutils.html#SkipTable"><span class="Identifier">SkipTable</span></a> <span class="Other">=</span> <a href="system.html#array"><span class="Identifier">array</span></a><span class="Other">[</span><span class="Identifier">char</span><span class="Other">,</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">]</span></pre></dt>
    578. 

  578.   <dd>
    579. 

  579.     
    580. 

  580.     Character table for efficient substring search.
    581. 

  581.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1894" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    582. 

  582. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1894" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    583. 

  583. 

  584.   </dd>
    585. 

  585. </div>
    586. 

  586. 

  587.   </dl>
    588. 

  588. </div>
    589. 

  589. <div class="section" id="10">
    590. 

  590.   <h1><a class="toc-backref" href="#10">Consts</a></h1>
    591. 

  591.   <dl class="item">
    592. 

  592.     <div id="AllChars">
    593. 

  593.   <dt><pre><a href="strutils.html#AllChars"><span class="Identifier">AllChars</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="CharLit">'\x00'</span><span class="Other">..</span><span class="CharLit">'\xFF'</span><span class="Other">}</span></pre></dt>
    594. 

  594.   <dd>
    595. 

  595.     
    596. 

  596.     <p>A set with all the possible characters.</p>
    597. 

  597. <p>Not very useful by its own, you can use it to create <em>inverted</em> sets to make the <a class="reference external" href="#find,string,set[char],Natural,int">find func</a> find <strong>invalid</strong> characters in strings. Example:</p>
    598. 

  598. <p><pre class="listing"><span class="Keyword">let</span> <span class="Identifier">invalid</span> <span class="Operator">=</span> <span class="Identifier">AllChars</span> <span class="Operator">-</span> <span class="Identifier">Digits</span>
    599. 

  599. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;01234&quot;</span><span class="Operator">.</span><span class="Identifier">find</span><span class="Punctuation">(</span><span class="Identifier">invalid</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">1</span>
    600. 

  600. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;01A34&quot;</span><span class="Operator">.</span><span class="Identifier">find</span><span class="Punctuation">(</span><span class="Identifier">invalid</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">2</span></pre></p>
    601. 

  601. 

  602.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L126" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    603. 

  603. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L126" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    604. 

  604. 

  605.   </dd>
    606. 

  606. </div>
    607. 

  607. <div id="Digits">
    608. 

  608.   <dt><pre><a href="strutils.html#Digits"><span class="Identifier">Digits</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="CharLit">'0'</span><span class="Other">..</span><span class="CharLit">'9'</span><span class="Other">}</span></pre></dt>
    609. 

  609.   <dd>
    610. 

  610.     
    611. 

  611.     The set of digits.
    612. 

  612.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L107" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    613. 

  613. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L107" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    614. 

  614. 

  615.   </dd>
    616. 

  616. </div>
    617. 

  617. <div id="HexDigits">
    618. 

  618.   <dt><pre><a href="strutils.html#HexDigits"><span class="Identifier">HexDigits</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="CharLit">'0'</span><span class="Other">..</span><span class="CharLit">'9'</span><span class="Other">,</span> <span class="CharLit">'A'</span><span class="Other">..</span><span class="CharLit">'F'</span><span class="Other">,</span> <span class="CharLit">'a'</span><span class="Other">..</span><span class="CharLit">'f'</span><span class="Other">}</span></pre></dt>
    619. 

  619.   <dd>
    620. 

  620.     
    621. 

  621.     The set of hexadecimal digits.
    622. 

  622.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L110" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    623. 

  623. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L110" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    624. 

  624. 

  625.   </dd>
    626. 

  626. </div>
    627. 

  627. <div id="IdentChars">
    628. 

  628.   <dt><pre><a href="strutils.html#IdentChars"><span class="Identifier">IdentChars</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="CharLit">'a'</span><span class="Other">..</span><span class="CharLit">'z'</span><span class="Other">,</span> <span class="CharLit">'A'</span><span class="Other">..</span><span class="CharLit">'Z'</span><span class="Other">,</span> <span class="CharLit">'0'</span><span class="Other">..</span><span class="CharLit">'9'</span><span class="Other">,</span> <span class="CharLit">'_'</span><span class="Other">}</span></pre></dt>
    629. 

  629.   <dd>
    630. 

  630.     
    631. 

  631.     The set of characters an identifier can consist of.
    632. 

  632.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L113" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    633. 

  633. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L113" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    634. 

  634. 

  635.   </dd>
    636. 

  636. </div>
    637. 

  637. <div id="IdentStartChars">
    638. 

  638.   <dt><pre><a href="strutils.html#IdentStartChars"><span class="Identifier">IdentStartChars</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="CharLit">'a'</span><span class="Other">..</span><span class="CharLit">'z'</span><span class="Other">,</span> <span class="CharLit">'A'</span><span class="Other">..</span><span class="CharLit">'Z'</span><span class="Other">,</span> <span class="CharLit">'_'</span><span class="Other">}</span></pre></dt>
    639. 

  639.   <dd>
    640. 

  640.     
    641. 

  641.     The set of characters an identifier can start with.
    642. 

  642.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L116" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    643. 

  643. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L116" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    644. 

  644. 

  645.   </dd>
    646. 

  646. </div>
    647. 

  647. <div id="Letters">
    648. 

  648.   <dt><pre><a href="strutils.html#Letters"><span class="Identifier">Letters</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="CharLit">'A'</span><span class="Other">..</span><span class="CharLit">'Z'</span><span class="Other">,</span> <span class="CharLit">'a'</span><span class="Other">..</span><span class="CharLit">'z'</span><span class="Other">}</span></pre></dt>
    649. 

  649.   <dd>
    650. 

  650.     
    651. 

  651.     The set of letters.
    652. 

  652.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L95" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    653. 

  653. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L95" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    654. 

  654. 

  655.   </dd>
    656. 

  656. </div>
    657. 

  657. <div id="LowercaseLetters">
    658. 

  658.   <dt><pre><a href="strutils.html#LowercaseLetters"><span class="Identifier">LowercaseLetters</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="CharLit">'a'</span><span class="Other">..</span><span class="CharLit">'z'</span><span class="Other">}</span></pre></dt>
    659. 

  659.   <dd>
    660. 

  660.     
    661. 

  661.     The set of lowercase ASCII letters.
    662. 

  662.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L101" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    663. 

  663. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L101" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    664. 

  664. 

  665.   </dd>
    666. 

  666. </div>
    667. 

  667. <div id="Newlines">
    668. 

  668.   <dt><pre><a href="strutils.html#Newlines"><span class="Identifier">Newlines</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="CharLit">'\r'</span><span class="Other">,</span> <span class="CharLit">'\n'</span><span class="Other">}</span></pre></dt>
    669. 

  669.   <dd>
    670. 

  670.     
    671. 

  671.     The set of characters a newline terminator can start with (carriage return, line feed).
    672. 

  672.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L119" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    673. 

  673. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L119" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    674. 

  674. 

  675.   </dd>
    676. 

  676. </div>
    677. 

  677. <div id="PrintableChars">
    678. 

  678.   <dt><pre><a href="strutils.html#PrintableChars"><span class="Identifier">PrintableChars</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="CharLit">'\t'</span><span class="Other">..</span><span class="CharLit">'\r'</span><span class="Other">,</span> <span class="CharLit">' '</span><span class="Other">..</span><span class="CharLit">'~'</span><span class="Other">}</span></pre></dt>
    679. 

  679.   <dd>
    680. 

  680.     
    681. 

  681.     The set of all printable ASCII characters (letters, digits, whitespace, and punctuation characters).
    682. 

  682.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L123" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    683. 

  683. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L123" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    684. 

  684. 

  685.   </dd>
    686. 

  686. </div>
    687. 

  687. <div id="PunctuationChars">
    688. 

  688.   <dt><pre><a href="strutils.html#PunctuationChars"><span class="Identifier">PunctuationChars</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="CharLit">'!'</span><span class="Other">..</span><span class="CharLit">'/'</span><span class="Other">,</span> <span class="CharLit">':'</span><span class="Other">..</span><span class="CharLit">'@'</span><span class="Other">,</span> <span class="CharLit">'['</span><span class="Other">..</span><span class="CharLit">'`'</span><span class="Other">,</span> <span class="CharLit">'{'</span><span class="Other">..</span><span class="CharLit">'~'</span><span class="Other">}</span></pre></dt>
    689. 

  689.   <dd>
    690. 

  690.     
    691. 

  691.     The set of all ASCII punctuation characters.
    692. 

  692.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L104" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    693. 

  693. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L104" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    694. 

  694. 

  695.   </dd>
    696. 

  696. </div>
    697. 

  697. <div id="UppercaseLetters">
    698. 

  698.   <dt><pre><a href="strutils.html#UppercaseLetters"><span class="Identifier">UppercaseLetters</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="CharLit">'A'</span><span class="Other">..</span><span class="CharLit">'Z'</span><span class="Other">}</span></pre></dt>
    699. 

  699.   <dd>
    700. 

  700.     
    701. 

  701.     The set of uppercase ASCII letters.
    702. 

  702.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L98" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    703. 

  703. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L98" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    704. 

  704. 

  705.   </dd>
    706. 

  706. </div>
    707. 

  707. <div id="Whitespace">
    708. 

  708.   <dt><pre><a href="strutils.html#Whitespace"><span class="Identifier">Whitespace</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="CharLit">' '</span><span class="Other">,</span> <span class="CharLit">'\t'</span><span class="Other">,</span> <span class="CharLit">'\v'</span><span class="Other">,</span> <span class="CharLit">'\r'</span><span class="Other">,</span> <span class="CharLit">'\n'</span><span class="Other">,</span> <span class="CharLit">'\f'</span><span class="Other">}</span></pre></dt>
    709. 

  709.   <dd>
    710. 

  710.     
    711. 

  711.     All the characters that count as whitespace (space, tab, vertical tab, carriage return, new line, form feed).
    712. 

  712.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L91" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    713. 

  713. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L91" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    714. 

  714. 

  715.   </dd>
    716. 

  716. </div>
    717. 

  717. 

  718.   </dl>
    719. 

  719. </div>
    720. 

  720. <div class="section" id="12">
    721. 

  721.   <h1><a class="toc-backref" href="#12">Procs</a></h1>
    722. 

  722.   <dl class="item">
    723. 

  723.     <div id="%-procs-all">
    724. 

  724.   <div id="%,string,string">
    725. 

  725.   <dt><pre><span class="Keyword">func</span> <a href="#%25%2Cstring%2Cstring"><span class="Identifier">`%`</span></a><span class="Other">(</span><span class="Identifier">formatstr</span><span class="Other">,</span> <span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuFormatSingleElem&quot;</span><span class="Other">,</span>
    726. 

  726.     <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    727. 

  727.   <dd>
    728. 

  728.     
    729. 

  729.     This is the same as <tt class="docutils literal"><span class="pre"><span class="Identifier">formatstr</span> <span class="Operator">%</span> <span class="Punctuation">[</span><span class="Identifier">a</span><span class="Punctuation">]</span></span></tt> (see <a class="reference external" href="#%25,string,openArray[string]">% func</a>).
    730. 

  730.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2915" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    731. 

  731. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2915" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    732. 

  732. 

  733.   </dd>
    734. 

  734. </div>
    735. 

  735. <div id="%,string,openArray[string]">
    736. 

  736.   <dt><pre><span class="Keyword">func</span> <a href="#%25%2Cstring%2CopenArray%5Bstring%5D"><span class="Identifier">`%`</span></a><span class="Other">(</span><span class="Identifier">formatstr</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#openArray"><span class="Identifier">openArray</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    737. 

  737.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuFormatOpenArray&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    738. 

  738.   <dd>
    739. 

  739.     
    740. 

  740.     <p>Interpolates a format string with the values from <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt>.</p>
    741. 

  741. <p>The <span id="substitution_1">substitution</span> operator performs string substitutions in <tt class="docutils literal"><span class="pre"><span class="Identifier">formatstr</span></span></tt> and returns a modified <tt class="docutils literal"><span class="pre"><span class="Identifier">formatstr</span></span></tt>. This is often called <span id="string-interpolation_1">string interpolation</span>.</p>
    742. 

  742. <p>This is best explained by an example:</p>
    743. 

  743. <p><pre class="listing"><span class="StringLit">&quot;$1 eats $2.&quot;</span> <span class="Operator">%</span> <span class="Punctuation">[</span><span class="StringLit">&quot;The cat&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;fish&quot;</span><span class="Punctuation">]</span></pre></p>
    744. 

  744. <p>Results in:</p>
    745. 

  745. <p><pre class="listing"><span class="StringLit">&quot;The cat eats fish.&quot;</span></pre></p>
    746. 

  746. <p>The substitution variables (the thing after the <tt class="docutils literal"><span class="pre"><span class="Operator">$</span></span></tt>) are enumerated from 1 to <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">len</span></span></tt>. To produce a verbatim <tt class="docutils literal"><span class="pre"><span class="Operator">$</span></span></tt>, use <tt class="docutils literal"><span class="pre"><span class="Operator">$$</span></span></tt>. The notation <tt class="docutils literal"><span class="pre"><span class="Operator">$</span><span class="Comment">#</span></span></tt> can be used to refer to the next substitution variable:</p>
    747. 

  747. <p><pre class="listing"><span class="StringLit">&quot;$# eats $#.&quot;</span> <span class="Operator">%</span> <span class="Punctuation">[</span><span class="StringLit">&quot;The cat&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;fish&quot;</span><span class="Punctuation">]</span></pre></p>
    748. 

  748. <p>Substitution variables can also be words (that is <tt class="docutils literal"><span class="pre"><span class="Punctuation">[</span><span class="Identifier">A</span><span class="Operator">-</span><span class="Identifier">Za</span><span class="Operator">-</span><span class="Identifier">z_</span><span class="Punctuation">]</span><span class="Operator">+</span><span class="Punctuation">[</span><span class="Identifier">A</span><span class="Operator">-</span><span class="Identifier">Za</span><span class="Operator">-</span><span class="Identifier">z0</span><span class="Operator">-</span><span class="DecNumber">9_</span><span class="Punctuation">]</span><span class="Operator">*</span></span></tt>) in which case the arguments in <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt> with even indices are keys and with odd indices are the corresponding values. An example:</p>
    749. 

  749. <p><pre class="listing"><span class="StringLit">&quot;$animal eats $food.&quot;</span> <span class="Operator">%</span> <span class="Punctuation">[</span><span class="StringLit">&quot;animal&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;The cat&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;food&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;fish&quot;</span><span class="Punctuation">]</span></pre></p>
    750. 

  750. <p>Results in:</p>
    751. 

  751. <p><pre class="listing"><span class="StringLit">&quot;The cat eats fish.&quot;</span></pre></p>
    752. 

  752. <p>The variables are compared with <tt class="docutils literal"><span class="pre"><span class="Identifier">cmpIgnoreStyle</span></span></tt>. <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> is raised if an ill-formed format string has been passed to the <tt class="docutils literal"><span class="pre"><span class="Operator">%</span></span></tt> operator.</p>
    753. 

  753. <p>See also:</p>
    754. 

  754. <ul class="simple"><li><a class="reference external" href="strformat.html">strformat module</a> for string interpolation and formatting</li>
    755. 

  755. </ul>
    756. 

  756. 

  757.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2862" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    758. 

  758. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2862" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    759. 

  759. 

  760.   </dd>
    761. 

  761. </div>
    762. 

  762. 

  763. </div>
    764. 

  764. <div id="abbrev-procs-all">
    765. 

  765.   <div id="abbrev,string,openArray[string]">
    766. 

  766.   <dt><pre><span class="Keyword">func</span> <a href="#abbrev%2Cstring%2CopenArray%5Bstring%5D"><span class="Identifier">abbrev</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">possibilities</span><span class="Other">:</span> <a href="system.html#openArray"><span class="Identifier">openArray</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    767. 

  767.     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    768. 

  768.   <dd>
    769. 

  769.     
    770. 

  770.     <p>Returns the index of the first item in <tt class="docutils literal"><span class="pre"><span class="Identifier">possibilities</span></span></tt> which starts with <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>, if not ambiguous.</p>
    771. 

  771. <p>Returns -1 if no item has been found and -2 if multiple items match.</p>
    772. 

  772. 

  773. <p><strong class="examples_text">Example:</strong></p>
    774. 

  774. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">abbrev</span><span class="Punctuation">(</span><span class="StringLit">&quot;fac&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">[</span><span class="StringLit">&quot;college&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;faculty&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;industry&quot;</span><span class="Punctuation">]</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">1</span>
    775. 

  775. <span class="Identifier">doAssert</span> <span class="Identifier">abbrev</span><span class="Punctuation">(</span><span class="StringLit">&quot;foo&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">[</span><span class="StringLit">&quot;college&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;faculty&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;industry&quot;</span><span class="Punctuation">]</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">1</span> <span class="Comment"># Not found</span>
    776. 

  776. <span class="Identifier">doAssert</span> <span class="Identifier">abbrev</span><span class="Punctuation">(</span><span class="StringLit">&quot;fac&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">[</span><span class="StringLit">&quot;college&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;faculty&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;faculties&quot;</span><span class="Punctuation">]</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">2</span> <span class="Comment"># Ambiguous</span>
    777. 

  777. <span class="Identifier">doAssert</span> <span class="Identifier">abbrev</span><span class="Punctuation">(</span><span class="StringLit">&quot;college&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">[</span><span class="StringLit">&quot;college&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;colleges&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;industry&quot;</span><span class="Punctuation">]</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">0</span></pre>
    778. 

  778.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1842" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    779. 

  779. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1842" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    780. 

  780. 

  781.   </dd>
    782. 

  782. </div>
    783. 

  783. 

  784. </div>
    785. 

  785. <div id="addf-procs-all">
    786. 

  786.   <div id="addf,string,string,varargs[string,]">
    787. 

  787.   <dt><pre><span class="Keyword">func</span> <a href="#addf%2Cstring%2Cstring%2Cvarargs%5Bstring%2C%5D"><span class="Identifier">addf</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">formatstr</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#varargs"><span class="Identifier">varargs</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">,</span> <span class="Other">`</span><span class="Operator">$</span><span class="Other">`</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    788. 

  788.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuAddf&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    789. 

  789.   <dd>
    790. 

  790.     
    791. 

  791.     The same as <tt class="docutils literal"><span class="pre"><span class="Identifier">add</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">,</span> <span class="Identifier">formatstr</span> <span class="Operator">%</span> <span class="Identifier">a</span><span class="Punctuation">)</span></span></tt>, but more efficient.
    792. 

  792.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2799" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    793. 

  793. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2799" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    794. 

  794. 

  795.   </dd>
    796. 

  796. </div>
    797. 

  797. 

  798. </div>
    799. 

  799. <div id="addSep-procs-all">
    800. 

  800.   <div id="addSep,string,string,Natural">
    801. 

  801.   <dt><pre><span class="Keyword">func</span> <a href="#addSep%2Cstring%2Cstring%2CNatural"><span class="Identifier">addSep</span></a><span class="Other">(</span><span class="Identifier">dest</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sep</span> <span class="Other">=</span> <span class="StringLit">&quot;, &quot;</span><span class="Other">;</span> <span class="Identifier">startLen</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">)</span> {.<span class="Identifier">inline</span><span class="Other">,</span>
    802. 

  802.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    803. 

  803.   <dd>
    804. 

  804.     
    805. 

  805.     <p>Adds a separator to <tt class="docutils literal"><span class="pre"><span class="Identifier">dest</span></span></tt> only if its length is bigger than <tt class="docutils literal"><span class="pre"><span class="Identifier">startLen</span></span></tt>.</p>
    806. 

  806. <p>A shorthand for:</p>
    807. 

  807. <p><pre class="listing"><span class="Keyword">if</span> <span class="Identifier">dest</span><span class="Operator">.</span><span class="Identifier">len</span> <span class="Operator">&gt;</span> <span class="Identifier">startLen</span><span class="Punctuation">:</span> <span class="Identifier">add</span><span class="Punctuation">(</span><span class="Identifier">dest</span><span class="Punctuation">,</span> <span class="Identifier">sep</span><span class="Punctuation">)</span></pre></p>
    808. 

  808. <p>This is often useful for generating some code where the items need to be <em>separated</em> by <tt class="docutils literal"><span class="pre"><span class="Identifier">sep</span></span></tt>. <tt class="docutils literal"><span class="pre"><span class="Identifier">sep</span></span></tt> is only added if <tt class="docutils literal"><span class="pre"><span class="Identifier">dest</span></span></tt> is longer than <tt class="docutils literal"><span class="pre"><span class="Identifier">startLen</span></span></tt>. The following example creates a string describing an array of integers.</p>
    809. 

  809. 

  810. <p><strong class="examples_text">Example:</strong></p>
    811. 

  811. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">arr</span> <span class="Operator">=</span> <span class="StringLit">&quot;[&quot;</span>
    812. 

  812. <span class="Keyword">for</span> <span class="Identifier">x</span> <span class="Keyword">in</span> <span class="Identifier">items</span><span class="Punctuation">(</span><span class="Punctuation">[</span><span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="DecNumber">3</span><span class="Punctuation">,</span> <span class="DecNumber">5</span><span class="Punctuation">,</span> <span class="DecNumber">7</span><span class="Punctuation">,</span> <span class="DecNumber">11</span><span class="Punctuation">]</span><span class="Punctuation">)</span><span class="Punctuation">:</span>
    813. 

  813.   <span class="Identifier">addSep</span><span class="Punctuation">(</span><span class="Identifier">arr</span><span class="Punctuation">,</span> <span class="Identifier">startLen</span> <span class="Operator">=</span> <span class="Identifier">len</span><span class="Punctuation">(</span><span class="StringLit">&quot;[&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    814. 

  814.   <span class="Identifier">add</span><span class="Punctuation">(</span><span class="Identifier">arr</span><span class="Punctuation">,</span> <span class="Operator">$</span><span class="Identifier">x</span><span class="Punctuation">)</span>
    815. 

  815. <span class="Identifier">add</span><span class="Punctuation">(</span><span class="Identifier">arr</span><span class="Punctuation">,</span> <span class="StringLit">&quot;]&quot;</span><span class="Punctuation">)</span>
    816. 

  816. <span class="Identifier">doAssert</span> <span class="Identifier">arr</span> <span class="Operator">==</span> <span class="StringLit">&quot;[2, 3, 5, 7, 11]&quot;</span></pre>
    817. 

  817.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1809" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    818. 

  818. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1809" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    819. 

  819. 

  820.   </dd>
    821. 

  821. </div>
    822. 

  822. 

  823. </div>
    824. 

  824. <div id="align-procs-all">
    825. 

  825.   <div id="align,string,Natural,char">
    826. 

  826.   <dt><pre><span class="Keyword">func</span> <a href="#align%2Cstring%2CNatural%2Cchar"><span class="Identifier">align</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">count</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a><span class="Other">;</span> <span class="Identifier">padding</span> <span class="Other">=</span> <span class="CharLit">' '</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    827. 

  827.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuAlignString&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    828. 

  828.   <dd>
    829. 

  829.     
    830. 

  830.     <p>Aligns a string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> with <tt class="docutils literal"><span class="pre"><span class="Identifier">padding</span></span></tt>, so that it is of length <tt class="docutils literal"><span class="pre"><span class="Identifier">count</span></span></tt>.</p>
    831. 

  831. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">padding</span></span></tt> characters (by default spaces) are added before <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> resulting in right alignment. If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">len</span> <span class="Operator">&gt;=</span> <span class="Identifier">count</span></span></tt>, no spaces are added and <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is returned unchanged. If you need to left align a string use the <a class="reference external" href="#alignLeft,string,Natural,char">alignLeft func</a>.</p>
    832. 

  832. <p>See also:</p>
    833. 

  833. <ul class="simple"><li><a class="reference external" href="#alignLeft,string,Natural,char">alignLeft func</a></li>
    834. 

  834. <li><a class="reference external" href="#spaces,Natural">spaces func</a></li>
    835. 

  835. <li><a class="reference external" href="#indent,string,Natural,string">indent func</a></li>
    836. 

  836. <li><a class="reference external" href="#center,string,int,char">center func</a></li>
    837. 

  837. </ul>
    838. 

  838. 

  839. <p><strong class="examples_text">Example:</strong></p>
    840. 

  840. <pre class="listing"><span class="Identifier">assert</span> <span class="Identifier">align</span><span class="Punctuation">(</span><span class="StringLit">&quot;abc&quot;</span><span class="Punctuation">,</span> <span class="DecNumber">4</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot; abc&quot;</span>
    841. 

  841. <span class="Identifier">assert</span> <span class="Identifier">align</span><span class="Punctuation">(</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;a&quot;</span>
    842. 

  842. <span class="Identifier">assert</span> <span class="Identifier">align</span><span class="Punctuation">(</span><span class="StringLit">&quot;1232&quot;</span><span class="Punctuation">,</span> <span class="DecNumber">6</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;  1232&quot;</span>
    843. 

  843. <span class="Identifier">assert</span> <span class="Identifier">align</span><span class="Punctuation">(</span><span class="StringLit">&quot;1232&quot;</span><span class="Punctuation">,</span> <span class="DecNumber">6</span><span class="Punctuation">,</span> <span class="CharLit">'#'</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;##1232&quot;</span></pre>
    844. 

  844.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1381" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    845. 

  845. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1381" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    846. 

  846. 

  847.   </dd>
    848. 

  848. </div>
    849. 

  849. 

  850. </div>
    851. 

  851. <div id="alignLeft-procs-all">
    852. 

  852.   <div id="alignLeft,string,Natural,char">
    853. 

  853.   <dt><pre><span class="Keyword">func</span> <a href="#alignLeft%2Cstring%2CNatural%2Cchar"><span class="Identifier">alignLeft</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">count</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a><span class="Other">;</span> <span class="Identifier">padding</span> <span class="Other">=</span> <span class="CharLit">' '</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    854. 

  854.     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    855. 

  855.   <dd>
    856. 

  856.     
    857. 

  857.     <p>Left-Aligns a string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> with <tt class="docutils literal"><span class="pre"><span class="Identifier">padding</span></span></tt>, so that it is of length <tt class="docutils literal"><span class="pre"><span class="Identifier">count</span></span></tt>.</p>
    858. 

  858. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">padding</span></span></tt> characters (by default spaces) are added after <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> resulting in left alignment. If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">len</span> <span class="Operator">&gt;=</span> <span class="Identifier">count</span></span></tt>, no spaces are added and <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is returned unchanged. If you need to right align a string use the <a class="reference external" href="#align,string,Natural,char">align func</a>.</p>
    859. 

  859. <p>See also:</p>
    860. 

  860. <ul class="simple"><li><a class="reference external" href="#align,string,Natural,char">align func</a></li>
    861. 

  861. <li><a class="reference external" href="#spaces,Natural">spaces func</a></li>
    862. 

  862. <li><a class="reference external" href="#indent,string,Natural,string">indent func</a></li>
    863. 

  863. <li><a class="reference external" href="#center,string,int,char">center func</a></li>
    864. 

  864. </ul>
    865. 

  865. 

  866. <p><strong class="examples_text">Example:</strong></p>
    867. 

  867. <pre class="listing"><span class="Identifier">assert</span> <span class="Identifier">alignLeft</span><span class="Punctuation">(</span><span class="StringLit">&quot;abc&quot;</span><span class="Punctuation">,</span> <span class="DecNumber">4</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;abc &quot;</span>
    868. 

  868. <span class="Identifier">assert</span> <span class="Identifier">alignLeft</span><span class="Punctuation">(</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;a&quot;</span>
    869. 

  869. <span class="Identifier">assert</span> <span class="Identifier">alignLeft</span><span class="Punctuation">(</span><span class="StringLit">&quot;1232&quot;</span><span class="Punctuation">,</span> <span class="DecNumber">6</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;1232  &quot;</span>
    870. 

  870. <span class="Identifier">assert</span> <span class="Identifier">alignLeft</span><span class="Punctuation">(</span><span class="StringLit">&quot;1232&quot;</span><span class="Punctuation">,</span> <span class="DecNumber">6</span><span class="Punctuation">,</span> <span class="CharLit">'#'</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;1232##&quot;</span></pre>
    871. 

  871.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1408" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    872. 

  872. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1408" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    873. 

  873. 

  874.   </dd>
    875. 

  875. </div>
    876. 

  876. 

  877. </div>
    878. 

  878. <div id="allCharsInSet-procs-all">
    879. 

  879.   <div id="allCharsInSet,string,set[char]">
    880. 

  880.   <dt><pre><span class="Keyword">func</span> <a href="#allCharsInSet%2Cstring%2Cset%5Bchar%5D"><span class="Identifier">allCharsInSet</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">theSet</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    881. 

  881.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    882. 

  882.   <dd>
    883. 

  883.     
    884. 

  884.     Returns true if every character of <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is in the set <tt class="docutils literal"><span class="pre"><span class="Identifier">theSet</span></span></tt>.
    885. 

  885. <p><strong class="examples_text">Example:</strong></p>
    886. 

  886. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">allCharsInSet</span><span class="Punctuation">(</span><span class="StringLit">&quot;aeea&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">{</span><span class="Punctuation">'</span><span class="Identifier">a</span><span class="CharLit">', '</span><span class="Identifier">e</span><span class="CharLit">'}) == true</span>
    887. 

  887. <span class="Identifier">doAssert</span> <span class="Identifier">allCharsInSet</span><span class="Punctuation">(</span><span class="StringLit">&quot;&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">{</span><span class="Punctuation">'</span><span class="Identifier">a</span><span class="CharLit">', '</span><span class="Identifier">e</span><span class="CharLit">'}) == true</span></pre>
    888. 

  888.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1832" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    889. 

  889. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1832" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    890. 

  890. 

  891.   </dd>
    892. 

  892. </div>
    893. 

  893. 

  894. </div>
    895. 

  895. <div id="capitalizeAscii-procs-all">
    896. 

  896.   <div id="capitalizeAscii,string">
    897. 

  897.   <dt><pre><span class="Keyword">func</span> <a href="#capitalizeAscii%2Cstring"><span class="Identifier">capitalizeAscii</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuCapitalizeAscii&quot;</span><span class="Other">,</span>
    898. 

  898.     <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    899. 

  899.   <dd>
    900. 

  900.     
    901. 

  901.     <p>Converts the first character of string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> into upper case.</p>
    902. 

  902. <p>This works only for the letters <tt class="docutils literal"><span class="pre"><span class="Identifier">A</span><span class="Operator">-</span><span class="Identifier">Z</span></span></tt>. Use <a class="reference external" href="unicode.html">Unicode module</a> for UTF-8 support.</p>
    903. 

  903. <p>See also:</p>
    904. 

  904. <ul class="simple"><li><a class="reference external" href="#toUpperAscii,char">toUpperAscii func</a></li>
    905. 

  905. </ul>
    906. 

  906. 

  907. <p><strong class="examples_text">Example:</strong></p>
    908. 

  908. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">capitalizeAscii</span><span class="Punctuation">(</span><span class="StringLit">&quot;foo&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;Foo&quot;</span>
    909. 

  909. <span class="Identifier">doAssert</span> <span class="Identifier">capitalizeAscii</span><span class="Punctuation">(</span><span class="StringLit">&quot;-bar&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;-bar&quot;</span></pre>
    910. 

  910.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L272" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    911. 

  911. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L272" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    912. 

  912. 

  913.   </dd>
    914. 

  914. </div>
    915. 

  915. 

  916. </div>
    917. 

  917. <div id="center-procs-all">
    918. 

  918.   <div id="center,string,int,char">
    919. 

  919.   <dt><pre><span class="Keyword">func</span> <a href="#center%2Cstring%2Cint%2Cchar"><span class="Identifier">center</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">width</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">;</span> <span class="Identifier">fillChar</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a> <span class="Other">=</span> <span class="CharLit">' '</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    920. 

  920.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuCenterString&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    921. 

  921.   <dd>
    922. 

  922.     
    923. 

  923.     <p>Return the contents of <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> centered in a string <tt class="docutils literal"><span class="pre"><span class="Identifier">width</span></span></tt> long using <tt class="docutils literal"><span class="pre"><span class="Identifier">fillChar</span></span></tt> (default: space) as padding.</p>
    924. 

  924. <p>The original string is returned if <tt class="docutils literal"><span class="pre"><span class="Identifier">width</span></span></tt> is less than or equal to <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">len</span></span></tt>.</p>
    925. 

  925. <p>See also:</p>
    926. 

  926. <ul class="simple"><li><a class="reference external" href="#align,string,Natural,char">align func</a></li>
    927. 

  927. <li><a class="reference external" href="#alignLeft,string,Natural,char">alignLeft func</a></li>
    928. 

  928. <li><a class="reference external" href="#spaces,Natural">spaces func</a></li>
    929. 

  929. <li><a class="reference external" href="#indent,string,Natural,string">indent func</a></li>
    930. 

  930. </ul>
    931. 

  931. 

  932. <p><strong class="examples_text">Example:</strong></p>
    933. 

  933. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="StringLit">&quot;foo&quot;</span>
    934. 

  934. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">center</span><span class="Punctuation">(</span><span class="DecNumber">2</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;foo&quot;</span>
    935. 

  935. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">center</span><span class="Punctuation">(</span><span class="DecNumber">5</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot; foo &quot;</span>
    936. 

  936. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">center</span><span class="Punctuation">(</span><span class="DecNumber">6</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot; foo  &quot;</span></pre>
    937. 

  937.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1435" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    938. 

  938. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1435" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    939. 

  939. 

  940.   </dd>
    941. 

  941. </div>
    942. 

  942. 

  943. </div>
    944. 

  944. <div id="cmpIgnoreCase-procs-all">
    945. 

  945.   <div id="cmpIgnoreCase,string,string">
    946. 

  946.   <dt><pre><span class="Keyword">func</span> <a href="#cmpIgnoreCase%2Cstring%2Cstring"><span class="Identifier">cmpIgnoreCase</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuCmpIgnoreCase&quot;</span><span class="Other">,</span>
    947. 

  947.                                         <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    948. 

  948.   <dd>
    949. 

  949.     
    950. 

  950.     Compares two strings in a case insensitive manner. Returns:<p><tt class="docutils literal"><span class="pre"><span class="DecNumber">0</span></span></tt> if a == b<br/><tt class="docutils literal"><span class="pre"><span class="Operator">&lt;</span> <span class="DecNumber">0</span></span></tt> if a &lt; b<br/><tt class="docutils literal"><span class="pre"><span class="Operator">&gt;</span> <span class="DecNumber">0</span></span></tt> if a &gt; b<br/></p>
    951. 

  951. <p><strong class="examples_text">Example:</strong></p>
    952. 

  952. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">cmpIgnoreCase</span><span class="Punctuation">(</span><span class="StringLit">&quot;FooBar&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;foobar&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">0</span>
    953. 

  953. <span class="Identifier">doAssert</span> <span class="Identifier">cmpIgnoreCase</span><span class="Punctuation">(</span><span class="StringLit">&quot;bar&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;Foo&quot;</span><span class="Punctuation">)</span> <span class="Operator">&lt;</span> <span class="DecNumber">0</span>
    954. 

  954. <span class="Identifier">doAssert</span> <span class="Identifier">cmpIgnoreCase</span><span class="Punctuation">(</span><span class="StringLit">&quot;Foo5&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;foo4&quot;</span><span class="Punctuation">)</span> <span class="Operator">&gt;</span> <span class="DecNumber">0</span></pre>
    955. 

  955.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L334" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    956. 

  956. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L334" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    957. 

  957. 

  958.   </dd>
    959. 

  959. </div>
    960. 

  960. 

  961. </div>
    962. 

  962. <div id="cmpIgnoreStyle-procs-all">
    963. 

  963.   <div id="cmpIgnoreStyle,string,string">
    964. 

  964.   <dt><pre><span class="Keyword">func</span> <a href="#cmpIgnoreStyle%2Cstring%2Cstring"><span class="Identifier">cmpIgnoreStyle</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuCmpIgnoreStyle&quot;</span><span class="Other">,</span>
    965. 

  965.     <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    966. 

  966.   <dd>
    967. 

  967.     
    968. 

  968.     <p>Semantically the same as <tt class="docutils literal"><span class="pre"><span class="Identifier">cmp</span><span class="Punctuation">(</span><span class="Identifier">normalize</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">normalize</span><span class="Punctuation">(</span><span class="Identifier">b</span><span class="Punctuation">)</span><span class="Punctuation">)</span></span></tt>. It is just optimized to not allocate temporary strings. This should NOT be used to compare Nim identifier names. Use <a class="reference external" href="macros.html#eqIdent,string,string">macros.eqIdent</a> for that.</p>
    969. 

  969. <p>Returns:</p>
    970. 

  970. <p><tt class="docutils literal"><span class="pre"><span class="DecNumber">0</span></span></tt> if a == b<br/><tt class="docutils literal"><span class="pre"><span class="Operator">&lt;</span> <span class="DecNumber">0</span></span></tt> if a &lt; b<br/><tt class="docutils literal"><span class="pre"><span class="Operator">&gt;</span> <span class="DecNumber">0</span></span></tt> if a &gt; b<br/></p>
    971. 

  971. <p><strong class="examples_text">Example:</strong></p>
    972. 

  972. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">cmpIgnoreStyle</span><span class="Punctuation">(</span><span class="StringLit">&quot;foo_bar&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;FooBar&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">0</span>
    973. 

  973. <span class="Identifier">doAssert</span> <span class="Identifier">cmpIgnoreStyle</span><span class="Punctuation">(</span><span class="StringLit">&quot;foo_bar_5&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;FooBar4&quot;</span><span class="Punctuation">)</span> <span class="Operator">&gt;</span> <span class="DecNumber">0</span></pre>
    974. 

  974.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L349" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    975. 

  975. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L349" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    976. 

  976. 

  977.   </dd>
    978. 

  978. </div>
    979. 

  979. 

  980. </div>
    981. 

  981. <div id="contains-procs-all">
    982. 

  982.   <div id="contains,string,string">
    983. 

  983.   <dt><pre><span class="Keyword">func</span> <a href="#contains%2Cstring%2Cstring"><span class="Identifier">contains</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">,</span> <span class="Identifier">sub</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    984. 

  984.   <dd>
    985. 

  985.     
    986. 

  986.     <p>Same as <tt class="docutils literal"><span class="pre"><span class="Identifier">find</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">,</span> <span class="Identifier">sub</span><span class="Punctuation">)</span> <span class="Operator">&gt;=</span> <span class="DecNumber">0</span></span></tt>.</p>
    987. 

  987. <p>See also:</p>
    988. 

  988. <ul class="simple"><li><a class="reference external" href="#find,string,string,Natural,int">find func</a></li>
    989. 

  989. </ul>
    990. 

  990. 

  991.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2182" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    992. 

  992. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2182" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    993. 

  993. 

  994.   </dd>
    995. 

  995. </div>
    996. 

  996. <div id="contains,string,set[char]">
    997. 

  997.   <dt><pre><span class="Keyword">func</span> <a href="#contains%2Cstring%2Cset%5Bchar%5D"><span class="Identifier">contains</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">chars</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    998. 

  998.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    999. 

  999.   <dd>
    1000. 

  1000.     
    1001. 

  1001.     <p>Same as <tt class="docutils literal"><span class="pre"><span class="Identifier">find</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">,</span> <span class="Identifier">chars</span><span class="Punctuation">)</span> <span class="Operator">&gt;=</span> <span class="DecNumber">0</span></span></tt>.</p>
    1002. 

  1002. <p>See also:</p>
    1003. 

  1003. <ul class="simple"><li><a class="reference external" href="#find,string,set[char],Natural,int">find func</a></li>
    1004. 

  1004. </ul>
    1005. 

  1005. 

  1006.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2189" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1007. 

  1007. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2189" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1008. 

  1008. 

  1009.   </dd>
    1010. 

  1010. </div>
    1011. 

  1011. 

  1012. </div>
    1013. 

  1013. <div id="continuesWith-procs-all">
    1014. 

  1014.   <div id="continuesWith,string,string,Natural">
    1015. 

  1015.   <dt><pre><span class="Keyword">func</span> <a href="#continuesWith%2Cstring%2Cstring%2CNatural"><span class="Identifier">continuesWith</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">,</span> <span class="Identifier">substr</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">start</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1016. 

  1016.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuContinuesWith&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1017. 

  1017.   <dd>
    1018. 

  1018.     
    1019. 

  1019.     <p>Returns true if <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> continues with <tt class="docutils literal"><span class="pre"><span class="Identifier">substr</span></span></tt> at position <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>.</p>
    1020. 

  1020. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">substr</span> <span class="Operator">==</span> <span class="StringLit">&quot;&quot;</span></span></tt> true is returned.</p>
    1021. 

  1021. <p>See also:</p>
    1022. 

  1022. <ul class="simple"><li><a class="reference external" href="#startsWith,string,string">startsWith func</a></li>
    1023. 

  1023. <li><a class="reference external" href="#endsWith,string,string">endsWith func</a></li>
    1024. 

  1024. </ul>
    1025. 

  1025. 

  1026. <p><strong class="examples_text">Example:</strong></p>
    1027. 

  1027. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="StringLit">&quot;abracadabra&quot;</span>
    1028. 

  1028. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">continuesWith</span><span class="Punctuation">(</span><span class="StringLit">&quot;ca&quot;</span><span class="Punctuation">,</span> <span class="DecNumber">4</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">true</span>
    1029. 

  1029. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">continuesWith</span><span class="Punctuation">(</span><span class="StringLit">&quot;ca&quot;</span><span class="Punctuation">,</span> <span class="DecNumber">5</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">false</span>
    1030. 

  1030. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">continuesWith</span><span class="Punctuation">(</span><span class="StringLit">&quot;dab&quot;</span><span class="Punctuation">,</span> <span class="DecNumber">6</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">true</span></pre>
    1031. 

  1031.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1678" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1032. 

  1032. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1678" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1033. 

  1033. 

  1034.   </dd>
    1035. 

  1035. </div>
    1036. 

  1036. 

  1037. </div>
    1038. 

  1038. <div id="count-procs-all">
    1039. 

  1039.   <div id="count,string,char">
    1040. 

  1040.   <dt><pre><span class="Keyword">func</span> <a href="#count%2Cstring%2Cchar"><span class="Identifier">count</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sub</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuCountChar&quot;</span><span class="Other">,</span>
    1041. 

  1041.                                         <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1042. 

  1042.   <dd>
    1043. 

  1043.     
    1044. 

  1044.     <p>Counts the occurrences of the character <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> in the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    1045. 

  1045. <p>See also:</p>
    1046. 

  1046. <ul class="simple"><li><a class="reference external" href="#countLines,string">countLines func</a></li>
    1047. 

  1047. </ul>
    1048. 

  1048. 

  1049.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2117" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1050. 

  1050. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2117" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1051. 

  1051. 

  1052.   </dd>
    1053. 

  1053. </div>
    1054. 

  1054. <div id="count,string,string,bool">
    1055. 

  1055.   <dt><pre><span class="Keyword">func</span> <a href="#count%2Cstring%2Cstring%2Cbool"><span class="Identifier">count</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sub</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">overlapping</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> <span class="Other">=</span> <span class="Identifier">false</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1056. 

  1056.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuCountString&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1057. 

  1057.   <dd>
    1058. 

  1058.     
    1059. 

  1059.     <p>Counts the occurrences of a substring <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> in the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>. Overlapping occurrences of <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> only count when <tt class="docutils literal"><span class="pre"><span class="Identifier">overlapping</span></span></tt> is set to true (default: false).</p>
    1060. 

  1060. <p>See also:</p>
    1061. 

  1061. <ul class="simple"><li><a class="reference external" href="#countLines,string">countLines func</a></li>
    1062. 

  1062. </ul>
    1063. 

  1063. 

  1064.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2137" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1065. 

  1065. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2137" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1066. 

  1066. 

  1067.   </dd>
    1068. 

  1068. </div>
    1069. 

  1069. <div id="count,string,set[char]">
    1070. 

  1070.   <dt><pre><span class="Keyword">func</span> <a href="#count%2Cstring%2Cset%5Bchar%5D"><span class="Identifier">count</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">subs</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuCountCharSet&quot;</span><span class="Other">,</span>
    1071. 

  1071.     <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1072. 

  1072.   <dd>
    1073. 

  1073.     
    1074. 

  1074.     <p>Counts the occurrences of the group of character <tt class="docutils literal"><span class="pre"><span class="Identifier">subs</span></span></tt> in the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    1075. 

  1075. <p>See also:</p>
    1076. 

  1076. <ul class="simple"><li><a class="reference external" href="#countLines,string">countLines func</a></li>
    1077. 

  1077. </ul>
    1078. 

  1078. 

  1079.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2126" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1080. 

  1080. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2126" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1081. 

  1081. 

  1082.   </dd>
    1083. 

  1083. </div>
    1084. 

  1084. 

  1085. </div>
    1086. 

  1086. <div id="countLines-procs-all">
    1087. 

  1087.   <div id="countLines,string">
    1088. 

  1088.   <dt><pre><span class="Keyword">func</span> <a href="#countLines%2Cstring"><span class="Identifier">countLines</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuCountLines&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1089. 

  1089.                                   <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1090. 

  1090.   <dd>
    1091. 

  1091.     
    1092. 

  1092.     <p>Returns the number of lines in the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    1093. 

  1093. <p>This is the same as <tt class="docutils literal"><span class="pre"><span class="Identifier">len</span><span class="Punctuation">(</span><span class="Identifier">splitLines</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">)</span><span class="Punctuation">)</span></span></tt>, but much more efficient because it doesn't modify the string creating temporary objects. Every <a class="reference external" href="manual.html#lexical-analysis-character-literals">character literal</a> newline combination (CR, LF, CR-LF) is supported.</p>
    1094. 

  1094. <p>In this context, a line is any string separated by a newline combination. A line can be an empty string.</p>
    1095. 

  1095. <p>See also:</p>
    1096. 

  1096. <ul class="simple"><li><a class="reference external" href="#splitLines,string">splitLines func</a></li>
    1097. 

  1097. </ul>
    1098. 

  1098. 

  1099. <p><strong class="examples_text">Example:</strong></p>
    1100. 

  1100. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">countLines</span><span class="Punctuation">(</span><span class="StringLit">&quot;First line</span><span class="EscapeSequence">\l</span><span class="StringLit"> and second line.&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">2</span></pre>
    1101. 

  1101.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2155" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1102. 

  1102. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2155" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1103. 

  1103. 

  1104.   </dd>
    1105. 

  1105. </div>
    1106. 

  1106. 

  1107. </div>
    1108. 

  1108. <div id="dedent-procs-all">
    1109. 

  1109.   <div id="dedent,string,Natural">
    1110. 

  1110.   <dt><pre><span class="Keyword">func</span> <a href="#dedent%2Cstring%2CNatural"><span class="Identifier">dedent</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">count</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a> <span class="Other">=</span> <span class="Identifier">indentation</span><span class="Other">(</span><span class="Identifier">s</span><span class="Other">)</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1111. 

  1111.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuDedent&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1112. 

  1112.   <dd>
    1113. 

  1113.     
    1114. 

  1114.     <p>Unindents each line in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> by <tt class="docutils literal"><span class="pre"><span class="Identifier">count</span></span></tt> amount of <tt class="docutils literal"><span class="pre"><span class="Identifier">padding</span></span></tt>. The only difference between this and the <a class="reference external" href="#unindent,string,Natural,string">unindent func</a> is that this by default only cuts off the amount of indentation that all lines of <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> share as opposed to all indentation. It only supports spaces as padding.</p>
    1115. 

  1115. <p><strong>Note:</strong> This does not preserve the new line characters used in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    1116. 

  1116. <p>See also:</p>
    1117. 

  1117. <ul class="simple"><li><a class="reference external" href="#unindent,string,Natural,string">unindent func</a></li>
    1118. 

  1118. <li><a class="reference external" href="#align,string,Natural,char">align func</a></li>
    1119. 

  1119. <li><a class="reference external" href="#alignLeft,string,Natural,char">alignLeft func</a></li>
    1120. 

  1120. <li><a class="reference external" href="#spaces,Natural">spaces func</a></li>
    1121. 

  1121. <li><a class="reference external" href="#indent,string,Natural,string">indent func</a></li>
    1122. 

  1122. </ul>
    1123. 

  1123. 

  1124. <p><strong class="examples_text">Example:</strong></p>
    1125. 

  1125. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">x</span> <span class="Operator">=</span> <span class="LongStringLit">&quot;&quot;&quot;
    1126. 

  1126.       Hello
    1127. 

  1127.         There
    1128. 

  1128.     &quot;&quot;&quot;</span><span class="Operator">.</span><span class="Identifier">dedent</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    1129. 

  1129. 

  1130. <span class="Identifier">doAssert</span> <span class="Identifier">x</span> <span class="Operator">==</span> <span class="StringLit">&quot;Hello</span><span class="EscapeSequence">\n</span><span class="StringLit">  There</span><span class="EscapeSequence">\n</span><span class="StringLit">&quot;</span></pre>
    1131. 

  1131.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1541" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1132. 

  1132. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1541" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1133. 

  1133. 

  1134.   </dd>
    1135. 

  1135. </div>
    1136. 

  1136. 

  1137. </div>
    1138. 

  1138. <div id="delete-procs-all">
    1139. 

  1139.   <div id="delete,string,int,int">
    1140. 

  1140.   <dt><pre><span class="Keyword">func</span> <a href="#delete%2Cstring%2Cint%2Cint"><span class="Identifier">delete</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">first</span><span class="Other">,</span> <span class="Identifier">last</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuDelete&quot;</span><span class="Other">,</span>
    1141. 

  1141.     <span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;use `delete(s, first..last)`&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1142. 

  1142.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1143. 

  1143.   <dd>
    1144. 

  1144.     <div class="deprecation-message">
    1145. 

  1145.   <b>Deprecated:</b> use `delete(s, first..last)`
    1146. 

  1146. </div>
    1147. 

  1147. 

  1148.     Deletes in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> the characters at positions <tt class="docutils literal"><span class="pre"><span class="Identifier">first</span> <span class="Operator">..</span> <span class="Identifier">last</span></span></tt> (both ends included).
    1149. 

  1149. <p><strong class="examples_text">Example: cmd: --warning:deprecated:off</strong></p>
    1150. 

  1150. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="StringLit">&quot;abracadabra&quot;</span>
    1151. 

  1151. 

  1152. <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">delete</span><span class="Punctuation">(</span><span class="DecNumber">4</span><span class="Punctuation">,</span> <span class="DecNumber">5</span><span class="Punctuation">)</span>
    1153. 

  1153. <span class="Identifier">doAssert</span> <span class="Identifier">a</span> <span class="Operator">==</span> <span class="StringLit">&quot;abradabra&quot;</span>
    1154. 

  1154. 

  1155. <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">delete</span><span class="Punctuation">(</span><span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="DecNumber">6</span><span class="Punctuation">)</span>
    1156. 

  1156. <span class="Identifier">doAssert</span> <span class="Identifier">a</span> <span class="Operator">==</span> <span class="StringLit">&quot;ara&quot;</span>
    1157. 

  1157. 

  1158. <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">delete</span><span class="Punctuation">(</span><span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="DecNumber">999</span><span class="Punctuation">)</span>
    1159. 

  1159. <span class="Identifier">doAssert</span> <span class="Identifier">a</span> <span class="Operator">==</span> <span class="StringLit">&quot;ar&quot;</span></pre>
    1160. 

  1160.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1596" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1161. 

  1161. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1596" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1162. 

  1162. 

  1163.   </dd>
    1164. 

  1164. </div>
    1165. 

  1165. <div id="delete,string,Slice[int]">
    1166. 

  1166.   <dt><pre><span class="Keyword">func</span> <a href="#delete%2Cstring%2CSlice%5Bint%5D"><span class="Identifier">delete</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">slice</span><span class="Other">:</span> <a href="system.html#Slice"><span class="Identifier">Slice</span></a><span class="Other">[</span><a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1167. 

  1167.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1168. 

  1168.   <dd>
    1169. 

  1169.     
    1170. 

  1170.     <p>Deletes the items <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Punctuation">[</span><span class="Identifier">slice</span><span class="Punctuation">]</span></span></tt>, raising <tt class="docutils literal"><span class="pre"><span class="Identifier">IndexDefect</span></span></tt> if the slice contains elements out of range.</p>
    1171. 

  1171. <p>This operation moves all elements after <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Punctuation">[</span><span class="Identifier">slice</span><span class="Punctuation">]</span></span></tt> in linear time, and is the string analog to <tt class="docutils literal"><span class="pre"><span class="Identifier">sequtils</span><span class="Operator">.</span><span class="Identifier">delete</span></span></tt>.</p>
    1172. 

  1172. 

  1173. <p><strong class="examples_text">Example:</strong></p>
    1174. 

  1174. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="StringLit">&quot;abcde&quot;</span>
    1175. 

  1175. <span class="Identifier">doAssertRaises</span><span class="Punctuation">(</span><span class="Identifier">IndexDefect</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">delete</span><span class="Punctuation">(</span><span class="FloatNumber">4.</span><span class="Operator">.</span><span class="DecNumber">5</span><span class="Punctuation">)</span>
    1176. 

  1176. <span class="Identifier">assert</span> <span class="Identifier">a</span> <span class="Operator">==</span> <span class="StringLit">&quot;abcde&quot;</span>
    1177. 

  1177. <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">delete</span><span class="Punctuation">(</span><span class="FloatNumber">4.</span><span class="Operator">.</span><span class="DecNumber">4</span><span class="Punctuation">)</span>
    1178. 

  1178. <span class="Identifier">assert</span> <span class="Identifier">a</span> <span class="Operator">==</span> <span class="StringLit">&quot;abcd&quot;</span>
    1179. 

  1179. <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">delete</span><span class="Punctuation">(</span><span class="FloatNumber">1.</span><span class="Operator">.</span><span class="DecNumber">2</span><span class="Punctuation">)</span>
    1180. 

  1180. <span class="Identifier">assert</span> <span class="Identifier">a</span> <span class="Operator">==</span> <span class="StringLit">&quot;ad&quot;</span>
    1181. 

  1181. <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">delete</span><span class="Punctuation">(</span><span class="FloatNumber">1.</span><span class="Operator">.&lt;</span><span class="DecNumber">1</span><span class="Punctuation">)</span> <span class="Comment"># empty slice</span>
    1182. 

  1182. <span class="Identifier">assert</span> <span class="Identifier">a</span> <span class="Operator">==</span> <span class="StringLit">&quot;ad&quot;</span></pre>
    1183. 

  1183.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1566" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1184. 

  1184. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1566" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1185. 

  1185. 

  1186.   </dd>
    1187. 

  1187. </div>
    1188. 

  1188. 

  1189. </div>
    1190. 

  1190. <div id="endsWith-procs-all">
    1191. 

  1191.   <div id="endsWith,string,string">
    1192. 

  1192.   <dt><pre><span class="Keyword">func</span> <a href="#endsWith%2Cstring%2Cstring"><span class="Identifier">endsWith</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">,</span> <span class="Identifier">suffix</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuEndsWith&quot;</span><span class="Other">,</span>
    1193. 

  1193.     <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1194. 

  1194.   <dd>
    1195. 

  1195.     
    1196. 

  1196.     <p>Returns true if <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> ends with <tt class="docutils literal"><span class="pre"><span class="Identifier">suffix</span></span></tt>.</p>
    1197. 

  1197. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">suffix</span> <span class="Operator">==</span> <span class="StringLit">&quot;&quot;</span></span></tt> true is returned.</p>
    1198. 

  1198. <p>See also:</p>
    1199. 

  1199. <ul class="simple"><li><a class="reference external" href="#startsWith,string,string">startsWith func</a></li>
    1200. 

  1200. <li><a class="reference external" href="#continuesWith,string,string,Natural">continuesWith func</a></li>
    1201. 

  1201. <li><a class="reference external" href="#removeSuffix,string,string">removeSuffix func</a></li>
    1202. 

  1202. </ul>
    1203. 

  1203. 

  1204. <p><strong class="examples_text">Example:</strong></p>
    1205. 

  1205. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="StringLit">&quot;abracadabra&quot;</span>
    1206. 

  1206. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">endsWith</span><span class="Punctuation">(</span><span class="StringLit">&quot;abra&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">true</span>
    1207. 

  1207. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">endsWith</span><span class="Punctuation">(</span><span class="StringLit">&quot;dab&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">false</span></pre>
    1208. 

  1208.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1662" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1209. 

  1209. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1662" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1210. 

  1210. 

  1211.   </dd>
    1212. 

  1212. </div>
    1213. 

  1213. <div id="endsWith,string,char">
    1214. 

  1214.   <dt><pre><span class="Keyword">func</span> <a href="#endsWith%2Cstring%2Cchar"><span class="Identifier">endsWith</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">suffix</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1215. 

  1215.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1216. 

  1216.   <dd>
    1217. 

  1217.     
    1218. 

  1218.     <p>Returns true if <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> ends with <tt class="docutils literal"><span class="pre"><span class="Identifier">suffix</span></span></tt>.</p>
    1219. 

  1219. <p>See also:</p>
    1220. 

  1220. <ul class="simple"><li><a class="reference external" href="#startsWith,string,char">startsWith func</a></li>
    1221. 

  1221. <li><a class="reference external" href="#continuesWith,string,string,Natural">continuesWith func</a></li>
    1222. 

  1222. <li><a class="reference external" href="#removeSuffix,string,char">removeSuffix func</a></li>
    1223. 

  1223. </ul>
    1224. 

  1224. 

  1225. <p><strong class="examples_text">Example:</strong></p>
    1226. 

  1226. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="StringLit">&quot;abracadabra&quot;</span>
    1227. 

  1227. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">endsWith</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">a</span><span class="CharLit">') == true</span>
    1228. 

  1228. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">endsWith</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">b</span><span class="CharLit">') == false</span></pre>
    1229. 

  1229.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1649" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1230. 

  1230. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1649" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1231. 

  1231. 

  1232.   </dd>
    1233. 

  1233. </div>
    1234. 

  1234. 

  1235. </div>
    1236. 

  1236. <div id="escape-procs-all">
    1237. 

  1237.   <div id="escape,string,string,string">
    1238. 

  1238.   <dt><pre><span class="Keyword">func</span> <a href="#escape%2Cstring%2Cstring%2Cstring"><span class="Identifier">escape</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">prefix</span> <span class="Other">=</span> <span class="StringLit">&quot;\&quot;&quot;</span><span class="Other">;</span> <span class="Identifier">suffix</span> <span class="Other">=</span> <span class="StringLit">&quot;\&quot;&quot;</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1239. 

  1239.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuEscape&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1240. 

  1240.   <dd>
    1241. 

  1241.     
    1242. 

  1242.     Escapes a string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.<div class="admonition admonition-info"><span class="admonition-info-text"><b>Note:</b></span>
    1243. 

  1243. The escaping scheme is different from <tt class="docutils literal"><span class="pre"><span class="Identifier">system</span><span class="Operator">.</span><span class="Identifier">addEscapedChar</span></span></tt>.</div>
    1244. 

  1244. <ul class="simple"><li>replaces <tt class="docutils literal"><span class="pre"><span class="CharLit">'\0'</span><span class="Operator">..</span><span class="CharLit">'\31'</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="CharLit">'\127'</span><span class="Operator">..</span><span class="CharLit">'\255'</span></span></tt> by <tt class="docutils literal"><span class="pre"><span class="Operator">\</span><span class="Identifier">xHH</span></span></tt> where <tt class="docutils literal"><span class="pre"><span class="Identifier">HH</span></span></tt> is its hexadecimal value</li>
    1245. 

  1245. <li>replaces <tt class="docutils literal"><span class="pre">\</span></tt> by <tt class="docutils literal"><span class="pre"><span class="Operator">\\</span></span></tt></li>
    1246. 

  1246. <li>replaces <tt class="docutils literal"><span class="pre"><span class="CharLit">'</span></span></tt> by <tt class="docutils literal"><span class="pre"><span class="Operator">\</span><span class="CharLit">'</span></span></tt></li>
    1247. 

  1247. <li>replaces <tt class="docutils literal"><span class="pre"><span class="StringLit">&quot;</span></span></tt> by <tt class="docutils literal"><span class="pre"><span class="Operator">\</span><span class="StringLit">&quot;</span></span></tt></li>
    1248. 

  1248. </ul>
    1249. 

  1249. <p>The resulting string is prefixed with <tt class="docutils literal"><span class="pre"><span class="Identifier">prefix</span></span></tt> and suffixed with <tt class="docutils literal"><span class="pre"><span class="Identifier">suffix</span></span></tt>. Both may be empty strings.</p>
    1250. 

  1250. <p>See also:</p>
    1251. 

  1251. <ul class="simple"><li><a class="reference external" href="system.html#addEscapedChar,string,char">addEscapedChar proc</a></li>
    1252. 

  1252. <li><a class="reference external" href="#unescape,string,string,string">unescape func</a> for the opposite operation</li>
    1253. 

  1253. </ul>
    1254. 

  1254. 

  1255.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2369" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1256. 

  1256. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2369" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1257. 

  1257. 

  1258.   </dd>
    1259. 

  1259. </div>
    1260. 

  1260. 

  1261. </div>
    1262. 

  1262. <div id="find-procs-all">
    1263. 

  1263.   <div id="find,SkipTable,string,string,Natural,int">
    1264. 

  1264.   <dt><pre><span class="Keyword">func</span> <a href="#find%2CSkipTable%2Cstring%2Cstring%2CNatural%2Cint"><span class="Identifier">find</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="strutils.html#SkipTable"><span class="Identifier">SkipTable</span></a><span class="Other">;</span> <span class="Identifier">s</span><span class="Other">,</span> <span class="Identifier">sub</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">start</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">last</span> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.
    1265. 

  1265.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuFindStrA&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1266. 

  1266.   <dd>
    1267. 

  1267.     
    1268. 

  1268.     <p>Searches for <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> inside range <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span><span class="Operator">..</span><span class="Identifier">last</span></span></tt> using preprocessed table <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt>. If <tt class="docutils literal"><span class="pre"><span class="Identifier">last</span></span></tt> is unspecified, it defaults to <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">high</span></span></tt> (the last element).</p>
    1269. 

  1269. <p>Searching is case-sensitive. If <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> is not in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>, -1 is returned.</p>
    1270. 

  1270. <p>See also:</p>
    1271. 

  1271. <ul class="simple"><li><a class="reference external" href="#initSkipTable,string">initSkipTable func</a></li>
    1272. 

  1272. <li><a class="reference external" href="#initSkipTable,SkipTable,string">initSkipTable func</a></li>
    1273. 

  1273. </ul>
    1274. 

  1274. 

  1275.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1919" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1276. 

  1276. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1919" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1277. 

  1277. 

  1278.   </dd>
    1279. 

  1279. </div>
    1280. 

  1280. <div id="find,string,string,Natural,int">
    1281. 

  1281.   <dt><pre><span class="Keyword">func</span> <a href="#find%2Cstring%2Cstring%2CNatural%2Cint"><span class="Identifier">find</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">,</span> <span class="Identifier">sub</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">start</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">last</span> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1282. 

  1282.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuFindStr&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1283. 

  1283.   <dd>
    1284. 

  1284.     
    1285. 

  1285.     <p>Searches for <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> inside range <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span><span class="Operator">..</span><span class="Identifier">last</span></span></tt> (both ends included). If <tt class="docutils literal"><span class="pre"><span class="Identifier">last</span></span></tt> is unspecified or negative, it defaults to <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">high</span></span></tt> (the last element).</p>
    1286. 

  1286. <p>Searching is case-sensitive. If <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> is not in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>, -1 is returned. Otherwise the index returned is relative to <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Punctuation">[</span><span class="DecNumber">0</span><span class="Punctuation">]</span></span></tt>, not <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>. Subtract <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt> from the result for a <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>-origin index.</p>
    1287. 

  1287. <p>See also:</p>
    1288. 

  1288. <ul class="simple"><li><a class="reference external" href="#rfind,string,string,Natural,int">rfind func</a></li>
    1289. 

  1289. <li><a class="reference external" href="#replace,string,string,string">replace func</a></li>
    1290. 

  1290. </ul>
    1291. 

  1291. 

  1292.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2017" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1293. 

  1293. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2017" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1294. 

  1294. 

  1295.   </dd>
    1296. 

  1296. </div>
    1297. 

  1297. <div id="find,string,set[char],Natural,int">
    1298. 

  1298.   <dt><pre><span class="Keyword">func</span> <a href="#find%2Cstring%2Cset%5Bchar%5D%2CNatural%2Cint"><span class="Identifier">find</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">chars</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">start</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">last</span> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.
    1299. 

  1299.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuFindCharSet&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1300. 

  1300.   <dd>
    1301. 

  1301.     
    1302. 

  1302.     <p>Searches for <tt class="docutils literal"><span class="pre"><span class="Identifier">chars</span></span></tt> in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> inside range <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span><span class="Operator">..</span><span class="Identifier">last</span></span></tt> (both ends included). If <tt class="docutils literal"><span class="pre"><span class="Identifier">last</span></span></tt> is unspecified or negative, it defaults to <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">high</span></span></tt> (the last element).</p>
    1303. 

  1303. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> contains none of the characters in <tt class="docutils literal"><span class="pre"><span class="Identifier">chars</span></span></tt>, -1 is returned. Otherwise the index returned is relative to <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Punctuation">[</span><span class="DecNumber">0</span><span class="Punctuation">]</span></span></tt>, not <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>. Subtract <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt> from the result for a <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>-origin index.</p>
    1304. 

  1304. <p>See also:</p>
    1305. 

  1305. <ul class="simple"><li><a class="reference external" href="#rfind,string,set[char],Natural,int">rfind func</a></li>
    1306. 

  1306. <li><a class="reference external" href="#multiReplace,string,varargs[]">multiReplace func</a></li>
    1307. 

  1307. </ul>
    1308. 

  1308. 

  1309.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1991" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1310. 

  1310. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1991" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1311. 

  1311. 

  1312.   </dd>
    1313. 

  1313. </div>
    1314. 

  1314. <div id="find,string,char,Natural,int">
    1315. 

  1315.   <dt><pre><span class="Keyword">func</span> <a href="#find%2Cstring%2Cchar%2CNatural%2Cint"><span class="Identifier">find</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sub</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">;</span> <span class="Identifier">start</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">last</span> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1316. 

  1316.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuFindChar&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1317. 

  1317.   <dd>
    1318. 

  1318.     
    1319. 

  1319.     <p>Searches for <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> inside range <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span><span class="Operator">..</span><span class="Identifier">last</span></span></tt> (both ends included). If <tt class="docutils literal"><span class="pre"><span class="Identifier">last</span></span></tt> is unspecified or negative, it defaults to <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">high</span></span></tt> (the last element).</p>
    1320. 

  1320. <p>Searching is case-sensitive. If <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> is not in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>, -1 is returned. Otherwise the index returned is relative to <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Punctuation">[</span><span class="DecNumber">0</span><span class="Punctuation">]</span></span></tt>, not <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>. Subtract <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt> from the result for a <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>-origin index.</p>
    1321. 

  1321. <p>See also:</p>
    1322. 

  1322. <ul class="simple"><li><a class="reference external" href="#rfind,string,char,Natural,int">rfind func</a></li>
    1323. 

  1323. <li><a class="reference external" href="#replace,string,char,char">replace func</a></li>
    1324. 

  1324. </ul>
    1325. 

  1325. 

  1326.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1959" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1327. 

  1327. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1959" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1328. 

  1328. 

  1329.   </dd>
    1330. 

  1330. </div>
    1331. 

  1331. 

  1332. </div>
    1333. 

  1333. <div id="format-procs-all">
    1334. 

  1334.   <div id="format,string,varargs[string,]">
    1335. 

  1335.   <dt><pre><span class="Keyword">func</span> <a href="#format%2Cstring%2Cvarargs%5Bstring%2C%5D"><span class="Identifier">format</span></a><span class="Other">(</span><span class="Identifier">formatstr</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#varargs"><span class="Identifier">varargs</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">,</span> <span class="Other">`</span><span class="Operator">$</span><span class="Other">`</span><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1336. 

  1336.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuFormatVarargs&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1337. 

  1337.   <dd>
    1338. 

  1338.     
    1339. 

  1339.     <p>This is the same as <tt class="docutils literal"><span class="pre"><span class="Identifier">formatstr</span> <span class="Operator">%</span> <span class="Identifier">a</span></span></tt> (see <a class="reference external" href="#%25,string,openArray[string]">% func</a>) except that it supports auto stringification.</p>
    1340. 

  1340. <p>See also:</p>
    1341. 

  1341. <ul class="simple"><li><a class="reference external" href="strformat.html">strformat module</a> for string interpolation and formatting</li>
    1342. 

  1342. </ul>
    1343. 

  1343. 

  1344.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2922" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1345. 

  1345. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2922" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1346. 

  1346. 

  1347.   </dd>
    1348. 

  1348. </div>
    1349. 

  1349. 

  1350. </div>
    1351. 

  1351. <div id="formatBiggestFloat-procs-all">
    1352. 

  1352.   <div id="formatBiggestFloat,BiggestFloat,FloatFormatMode,range[],char">
    1353. 

  1353.   <dt><pre><span class="Keyword">func</span> <a href="#formatBiggestFloat%2CBiggestFloat%2CFloatFormatMode%2Crange%5B%5D%2Cchar"><span class="Identifier">formatBiggestFloat</span></a><span class="Other">(</span><span class="Identifier">f</span><span class="Other">:</span> <a href="ctypes.html#BiggestFloat"><span class="Identifier">BiggestFloat</span></a><span class="Other">;</span> <span class="Identifier">format</span><span class="Other">:</span> <a href="strutils.html#FloatFormatMode"><span class="Identifier">FloatFormatMode</span></a> <span class="Other">=</span> <span class="Identifier">ffDefault</span><span class="Other">;</span>
    1354. 

  1354.                         <span class="Identifier">precision</span><span class="Other">:</span> <a href="system.html#range"><span class="Identifier">range</span></a><span class="Other">[</span><span class="DecNumber">-1</span> <span class="Operator">..</span> <span class="DecNumber">32</span><span class="Other">]</span> <span class="Other">=</span> <span class="DecNumber">16</span><span class="Other">;</span> <span class="Identifier">decimalSep</span> <span class="Other">=</span> <span class="CharLit">'.'</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.
    1355. 

  1355.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsu$1&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1356. 

  1356.   <dd>
    1357. 

  1357.     
    1358. 

  1358.     <p>Converts a floating point value <tt class="docutils literal"><span class="pre"><span class="Identifier">f</span></span></tt> to a string.</p>
    1359. 

  1359. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">format</span> <span class="Operator">==</span> <span class="Identifier">ffDecimal</span></span></tt> then precision is the number of digits to be printed after the decimal point. If <tt class="docutils literal"><span class="pre"><span class="Identifier">format</span> <span class="Operator">==</span> <span class="Identifier">ffScientific</span></span></tt> then precision is the maximum number of significant digits to be printed. <tt class="docutils literal"><span class="pre"><span class="Identifier">precision</span></span></tt>'s default value is the maximum number of meaningful digits after the decimal point for Nim's <tt class="docutils literal"><span class="pre"><span class="Identifier">biggestFloat</span></span></tt> type.</p>
    1360. 

  1360. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">precision</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">1</span></span></tt>, it tries to format it nicely.</p>
    1361. 

  1361. 

  1362. <p><strong class="examples_text">Example:</strong></p>
    1363. 

  1363. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">x</span> <span class="Operator">=</span> <span class="FloatNumber">123.456</span>
    1364. 

  1364. <span class="Identifier">doAssert</span> <span class="Identifier">x</span><span class="Operator">.</span><span class="Identifier">formatBiggestFloat</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;123.4560000000000&quot;</span>
    1365. 

  1365. <span class="Identifier">doAssert</span> <span class="Identifier">x</span><span class="Operator">.</span><span class="Identifier">formatBiggestFloat</span><span class="Punctuation">(</span><span class="Identifier">ffDecimal</span><span class="Punctuation">,</span> <span class="DecNumber">4</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;123.4560&quot;</span>
    1366. 

  1366. <span class="Identifier">doAssert</span> <span class="Identifier">x</span><span class="Operator">.</span><span class="Identifier">formatBiggestFloat</span><span class="Punctuation">(</span><span class="Identifier">ffScientific</span><span class="Punctuation">,</span> <span class="DecNumber">2</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;1.23e+02&quot;</span></pre>
    1367. 

  1367.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2470" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1368. 

  1368. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2470" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1369. 

  1369. 

  1370.   </dd>
    1371. 

  1371. </div>
    1372. 

  1372. 

  1373. </div>
    1374. 

  1374. <div id="formatEng-procs-all">
    1375. 

  1375.   <div id="formatEng,BiggestFloat,range[],bool,bool,string,char">
    1376. 

  1376.   <dt><pre><span class="Keyword">func</span> <a href="#formatEng%2CBiggestFloat%2Crange%5B%5D%2Cbool%2Cbool%2Cstring%2Cchar"><span class="Identifier">formatEng</span></a><span class="Other">(</span><span class="Identifier">f</span><span class="Other">:</span> <a href="ctypes.html#BiggestFloat"><span class="Identifier">BiggestFloat</span></a><span class="Other">;</span> <span class="Identifier">precision</span><span class="Other">:</span> <a href="system.html#range"><span class="Identifier">range</span></a><span class="Other">[</span><span class="DecNumber">0</span> <span class="Operator">..</span> <span class="DecNumber">32</span><span class="Other">]</span> <span class="Other">=</span> <span class="DecNumber">10</span><span class="Other">;</span>
    1377. 

  1377.                <span class="Identifier">trim</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> <span class="Other">=</span> <span class="Identifier">true</span><span class="Other">;</span> <span class="Identifier">siPrefix</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> <span class="Other">=</span> <span class="Identifier">false</span><span class="Other">;</span> <span class="Identifier">unit</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> <span class="Other">=</span> <span class="StringLit">&quot;&quot;</span><span class="Other">;</span>
    1378. 

  1378.                <span class="Identifier">decimalSep</span> <span class="Other">=</span> <span class="CharLit">'.'</span><span class="Other">;</span> <span class="Identifier">useUnitSpace</span> <span class="Other">=</span> <span class="Identifier">false</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1379. 

  1379.     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1380. 

  1380.   <dd>
    1381. 

  1381.     
    1382. 

  1382.     <p>Converts a floating point value <tt class="docutils literal"><span class="pre"><span class="Identifier">f</span></span></tt> to a string using engineering notation.</p>
    1383. 

  1383. <p>Numbers in of the range -1000.0&lt;f&lt;1000.0 will be formatted without an exponent. Numbers outside of this range will be formatted as a significand in the range -1000.0&lt;f&lt;1000.0 and an exponent that will always be an integer multiple of 3, corresponding with the SI prefix scale k, M, G, T etc for numbers with an absolute value greater than 1 and m, μ, n, p etc for numbers with an absolute value less than 1.</p>
    1384. 

  1384. <p>The default configuration (<tt class="docutils literal"><span class="pre"><span class="Identifier">trim</span><span class="Operator">=</span><span class="Identifier">true</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">precision</span><span class="Operator">=</span><span class="DecNumber">10</span></span></tt>) shows the <strong>shortest</strong> form that precisely (up to a maximum of 10 decimal places) displays the value. For example, 4.100000 will be displayed as 4.1 (which is mathematically identical) whereas 4.1000003 will be displayed as 4.1000003.</p>
    1385. 

  1385. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">trim</span></span></tt> is set to true, trailing zeros will be removed; if false, the number of digits specified by <tt class="docutils literal"><span class="pre"><span class="Identifier">precision</span></span></tt> will always be shown.</p>
    1386. 

  1386. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">precision</span></span></tt> can be used to set the number of digits to be shown after the decimal point or (if <tt class="docutils literal"><span class="pre"><span class="Identifier">trim</span></span></tt> is true) the maximum number of digits to be shown.</p>
    1387. 

  1387. <p><pre class="listing"> <span class="Identifier">formatEng</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="Identifier">trim</span><span class="Operator">=</span><span class="Identifier">false</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;0.00&quot;</span>
    1388. 

  1388.  <span class="Identifier">formatEng</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="DecNumber">2</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;0&quot;</span>
    1389. 

  1389.  <span class="Identifier">formatEng</span><span class="Punctuation">(</span><span class="FloatNumber">0.053</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;53e-3&quot;</span>
    1390. 

  1390.  <span class="Identifier">formatEng</span><span class="Punctuation">(</span><span class="DecNumber">52731234</span><span class="Punctuation">,</span> <span class="DecNumber">2</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;52.73e6&quot;</span>
    1391. 

  1391.  <span class="Identifier">formatEng</span><span class="Punctuation">(</span><span class="Operator">-</span><span class="DecNumber">52731234</span><span class="Punctuation">,</span> <span class="DecNumber">2</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;-52.73e6&quot;</span></pre></p>
    1392. 

  1392. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">siPrefix</span></span></tt> is set to true, the number will be displayed with the SI prefix corresponding to the exponent. For example 4100 will be displayed as &quot;4.1 k&quot; instead of &quot;4.1e3&quot;. Note that <tt class="docutils literal"><span class="pre"><span class="Identifier">u</span></span></tt> is used for micro- in place of the greek letter mu (μ) as per ISO 2955. Numbers with an absolute value outside of the range 1e-18&lt;f&lt;1000e18 (1a&lt;f&lt;1000E) will be displayed with an exponent rather than an SI prefix, regardless of whether <tt class="docutils literal"><span class="pre"><span class="Identifier">siPrefix</span></span></tt> is true.</p>
    1393. 

  1393. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">useUnitSpace</span></span></tt> is true, the provided unit will be appended to the string (with a space as required by the SI standard). This behaviour is slightly different to appending the unit to the result as the location of the space is altered depending on whether there is an exponent.</p>
    1394. 

  1394. <p><pre class="listing"> <span class="Identifier">formatEng</span><span class="Punctuation">(</span><span class="DecNumber">4100</span><span class="Punctuation">,</span> <span class="Identifier">siPrefix</span><span class="Operator">=</span><span class="Identifier">true</span><span class="Punctuation">,</span> <span class="Identifier">unit</span><span class="Operator">=</span><span class="StringLit">&quot;V&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;4.1 kV&quot;</span>
    1395. 

  1395.  <span class="Identifier">formatEng</span><span class="Punctuation">(</span><span class="FloatNumber">4.1</span><span class="Punctuation">,</span> <span class="Identifier">siPrefix</span><span class="Operator">=</span><span class="Identifier">true</span><span class="Punctuation">,</span> <span class="Identifier">unit</span><span class="Operator">=</span><span class="StringLit">&quot;V&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;4.1 V&quot;</span>
    1396. 

  1396.  <span class="Identifier">formatEng</span><span class="Punctuation">(</span><span class="FloatNumber">4.1</span><span class="Punctuation">,</span> <span class="Identifier">siPrefix</span><span class="Operator">=</span><span class="Identifier">true</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;4.1&quot;</span> <span class="Comment"># Note lack of space</span>
    1397. 

  1397.  <span class="Identifier">formatEng</span><span class="Punctuation">(</span><span class="DecNumber">4100</span><span class="Punctuation">,</span> <span class="Identifier">siPrefix</span><span class="Operator">=</span><span class="Identifier">true</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;4.1 k&quot;</span>
    1398. 

  1398.  <span class="Identifier">formatEng</span><span class="Punctuation">(</span><span class="FloatNumber">4.1</span><span class="Punctuation">,</span> <span class="Identifier">siPrefix</span><span class="Operator">=</span><span class="Identifier">true</span><span class="Punctuation">,</span> <span class="Identifier">unit</span><span class="Operator">=</span><span class="StringLit">&quot;&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;4.1 &quot;</span> <span class="Comment"># Space with unit=&quot;&quot;</span>
    1399. 

  1399.  <span class="Identifier">formatEng</span><span class="Punctuation">(</span><span class="DecNumber">4100</span><span class="Punctuation">,</span> <span class="Identifier">siPrefix</span><span class="Operator">=</span><span class="Identifier">true</span><span class="Punctuation">,</span> <span class="Identifier">unit</span><span class="Operator">=</span><span class="StringLit">&quot;&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;4.1 k&quot;</span>
    1400. 

  1400.  <span class="Identifier">formatEng</span><span class="Punctuation">(</span><span class="DecNumber">4100</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;4.1e3&quot;</span>
    1401. 

  1401.  <span class="Identifier">formatEng</span><span class="Punctuation">(</span><span class="DecNumber">4100</span><span class="Punctuation">,</span> <span class="Identifier">unit</span><span class="Operator">=</span><span class="StringLit">&quot;V&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;4.1e3 V&quot;</span>
    1402. 

  1402.  <span class="Identifier">formatEng</span><span class="Punctuation">(</span><span class="DecNumber">4100</span><span class="Punctuation">,</span> <span class="Identifier">unit</span><span class="Operator">=</span><span class="StringLit">&quot;&quot;</span><span class="Punctuation">,</span> <span class="Identifier">useUnitSpace</span><span class="Operator">=</span><span class="Identifier">true</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;4.1e3 &quot;</span> <span class="Comment"># Space with useUnitSpace=true</span></pre></p>
    1403. 

  1403. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">decimalSep</span></span></tt> is used as the decimal separator.</p>
    1404. 

  1404. <p>See also:</p>
    1405. 

  1405. <ul class="simple"><li><a class="reference external" href="strformat.html">strformat module</a> for string interpolation and formatting</li>
    1406. 

  1406. </ul>
    1407. 

  1407. 

  1408.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2648" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1409. 

  1409. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2648" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1410. 

  1410. 

  1411.   </dd>
    1412. 

  1412. </div>
    1413. 

  1413. 

  1414. </div>
    1415. 

  1415. <div id="formatFloat-procs-all">
    1416. 

  1416.   <div id="formatFloat,float,FloatFormatMode,range[],char">
    1417. 

  1417.   <dt><pre><span class="Keyword">func</span> <a href="#formatFloat%2Cfloat%2CFloatFormatMode%2Crange%5B%5D%2Cchar"><span class="Identifier">formatFloat</span></a><span class="Other">(</span><span class="Identifier">f</span><span class="Other">:</span> <a href="system.html#float"><span class="Identifier">float</span></a><span class="Other">;</span> <span class="Identifier">format</span><span class="Other">:</span> <a href="strutils.html#FloatFormatMode"><span class="Identifier">FloatFormatMode</span></a> <span class="Other">=</span> <span class="Identifier">ffDefault</span><span class="Other">;</span>
    1418. 

  1418.                  <span class="Identifier">precision</span><span class="Other">:</span> <a href="system.html#range"><span class="Identifier">range</span></a><span class="Other">[</span><span class="DecNumber">-1</span> <span class="Operator">..</span> <span class="DecNumber">32</span><span class="Other">]</span> <span class="Other">=</span> <span class="DecNumber">16</span><span class="Other">;</span> <span class="Identifier">decimalSep</span> <span class="Other">=</span> <span class="CharLit">'.'</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.
    1419. 

  1419.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsu$1&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1420. 

  1420.   <dd>
    1421. 

  1421.     
    1422. 

  1422.     <p>Converts a floating point value <tt class="docutils literal"><span class="pre"><span class="Identifier">f</span></span></tt> to a string.</p>
    1423. 

  1423. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">format</span> <span class="Operator">==</span> <span class="Identifier">ffDecimal</span></span></tt> then precision is the number of digits to be printed after the decimal point. If <tt class="docutils literal"><span class="pre"><span class="Identifier">format</span> <span class="Operator">==</span> <span class="Identifier">ffScientific</span></span></tt> then precision is the maximum number of significant digits to be printed. <tt class="docutils literal"><span class="pre"><span class="Identifier">precision</span></span></tt>'s default value is the maximum number of meaningful digits after the decimal point for Nim's <tt class="docutils literal"><span class="pre"><span class="Identifier">float</span></span></tt> type.</p>
    1424. 

  1424. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">precision</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">1</span></span></tt>, it tries to format it nicely.</p>
    1425. 

  1425. 

  1426. <p><strong class="examples_text">Example:</strong></p>
    1427. 

  1427. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">x</span> <span class="Operator">=</span> <span class="FloatNumber">123.456</span>
    1428. 

  1428. <span class="Identifier">doAssert</span> <span class="Identifier">x</span><span class="Operator">.</span><span class="Identifier">formatFloat</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;123.4560000000000&quot;</span>
    1429. 

  1429. <span class="Identifier">doAssert</span> <span class="Identifier">x</span><span class="Operator">.</span><span class="Identifier">formatFloat</span><span class="Punctuation">(</span><span class="Identifier">ffDecimal</span><span class="Punctuation">,</span> <span class="DecNumber">4</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;123.4560&quot;</span>
    1430. 

  1430. <span class="Identifier">doAssert</span> <span class="Identifier">x</span><span class="Operator">.</span><span class="Identifier">formatFloat</span><span class="Punctuation">(</span><span class="Identifier">ffScientific</span><span class="Punctuation">,</span> <span class="DecNumber">2</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;1.23e+02&quot;</span></pre>
    1431. 

  1431.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2546" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1432. 

  1432. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2546" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1433. 

  1433. 

  1434.   </dd>
    1435. 

  1435. </div>
    1436. 

  1436. 

  1437. </div>
    1438. 

  1438. <div id="formatSize-procs-all">
    1439. 

  1439.   <div id="formatSize,int64,char">
    1440. 

  1440.   <dt><pre><span class="Keyword">func</span> <a href="#formatSize%2Cint64%2Cchar"><span class="Identifier">formatSize</span></a><span class="Other">(</span><span class="Identifier">bytes</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a><span class="Other">;</span> <span class="Identifier">decimalSep</span> <span class="Other">=</span> <span class="CharLit">'.'</span><span class="Other">;</span> <span class="Identifier">prefix</span> <span class="Other">=</span> <span class="Identifier">bpIEC</span><span class="Other">;</span>
    1441. 

  1441.                 <span class="Identifier">includeSpace</span> <span class="Other">=</span> <span class="Identifier">false</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1442. 

  1442.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1443. 

  1443.   <dd>
    1444. 

  1444.     
    1445. 

  1445.     <p>Rounds and formats <tt class="docutils literal"><span class="pre"><span class="Identifier">bytes</span></span></tt>.</p>
    1446. 

  1446. <p>By default, uses the IEC/ISO standard binary prefixes, so 1024 will be formatted as 1KiB.  Set prefix to <tt class="docutils literal"><span class="pre"><span class="Identifier">bpColloquial</span></span></tt> to use the colloquial names from the SI standard (e.g. k for 1000 being reused as 1024).</p>
    1447. 

  1447. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">includeSpace</span></span></tt> can be set to true to include the (SI preferred) space between the number and the unit (e.g. 1 KiB).</p>
    1448. 

  1448. <p>See also:</p>
    1449. 

  1449. <ul class="simple"><li><a class="reference external" href="strformat.html">strformat module</a> for string interpolation and formatting</li>
    1450. 

  1450. </ul>
    1451. 

  1451. 

  1452. <p><strong class="examples_text">Example:</strong></p>
    1453. 

  1453. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">formatSize</span><span class="Punctuation">(</span><span class="Punctuation">(</span><span class="DecNumber">1'i64</span> <span class="Keyword">shl</span> <span class="DecNumber">31</span><span class="Punctuation">)</span> <span class="Operator">+</span> <span class="Punctuation">(</span><span class="DecNumber">300'i64</span> <span class="Keyword">shl</span> <span class="DecNumber">20</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;2.293GiB&quot;</span>
    1454. 

  1454. <span class="Identifier">doAssert</span> <span class="Identifier">formatSize</span><span class="Punctuation">(</span><span class="Punctuation">(</span><span class="FloatNumber">2.234</span><span class="Operator">*</span><span class="DecNumber">1024</span><span class="Operator">*</span><span class="DecNumber">1024</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">int</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;2.234MiB&quot;</span>
    1455. 

  1455. <span class="Identifier">doAssert</span> <span class="Identifier">formatSize</span><span class="Punctuation">(</span><span class="DecNumber">4096</span><span class="Punctuation">,</span> <span class="Identifier">includeSpace</span> <span class="Operator">=</span> <span class="Identifier">true</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;4 KiB&quot;</span>
    1456. 

  1456. <span class="Identifier">doAssert</span> <span class="Identifier">formatSize</span><span class="Punctuation">(</span><span class="DecNumber">4096</span><span class="Punctuation">,</span> <span class="Identifier">prefix</span> <span class="Operator">=</span> <span class="Identifier">bpColloquial</span><span class="Punctuation">,</span> <span class="Identifier">includeSpace</span> <span class="Operator">=</span> <span class="Identifier">true</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;4 kB&quot;</span>
    1457. 

  1457. <span class="Identifier">doAssert</span> <span class="Identifier">formatSize</span><span class="Punctuation">(</span><span class="DecNumber">4096</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;4KiB&quot;</span>
    1458. 

  1458. <span class="Identifier">doAssert</span> <span class="Identifier">formatSize</span><span class="Punctuation">(</span><span class="DecNumber">5_378_934</span><span class="Punctuation">,</span> <span class="Identifier">prefix</span> <span class="Operator">=</span> <span class="Identifier">bpColloquial</span><span class="Punctuation">,</span> <span class="Identifier">decimalSep</span> <span class="Operator">=</span> <span class="CharLit">','</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;5,13MB&quot;</span></pre>
    1459. 

  1459.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2592" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1460. 

  1460. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2592" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1461. 

  1461. 

  1462.   </dd>
    1463. 

  1463. </div>
    1464. 

  1464. 

  1465. </div>
    1466. 

  1466. <div id="fromBin-procs-all">
    1467. 

  1467.   <div id="fromBin,string">
    1468. 

  1468.   <dt><pre><span class="Keyword">func</span> <a href="#fromBin%2Cstring"><span class="Identifier">fromBin</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">:</span> <a href="system.html#SomeInteger"><span class="Identifier">SomeInteger</span></a><span class="Other">]</span><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">T</span></pre></dt>
    1469. 

  1469.   <dd>
    1470. 

  1470.     
    1471. 

  1471.     <p>Parses a binary integer value from a string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    1472. 

  1472. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is not a valid binary integer, <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> is raised. <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> can have one of the following optional prefixes: <tt class="docutils literal"><span class="pre"><span class="BinNumber">0b</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="BinNumber">0B</span></span></tt>. Underscores within <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> are ignored.</p>
    1473. 

  1473. <p>Does not check for overflow. If the value represented by <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is too big to fit into a return type, only the value of the rightmost binary digits of <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is returned without producing an error.</p>
    1474. 

  1474. 

  1475. <p><strong class="examples_text">Example:</strong></p>
    1476. 

  1476. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">s</span> <span class="Operator">=</span> <span class="StringLit">&quot;0b_0100_1000_1000_1000_1110_1110_1001_1001&quot;</span>
    1477. 

  1477. <span class="Identifier">doAssert</span> <span class="Identifier">fromBin</span><span class="Punctuation">[</span><span class="Identifier">int</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">1216933529</span>
    1478. 

  1478. <span class="Identifier">doAssert</span> <span class="Identifier">fromBin</span><span class="Punctuation">[</span><span class="Identifier">int8</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="BinNumber">0b1001_1001'i8</span>
    1479. 

  1479. <span class="Identifier">doAssert</span> <span class="Identifier">fromBin</span><span class="Punctuation">[</span><span class="Identifier">int8</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">103'i8</span>
    1480. 

  1480. <span class="Identifier">doAssert</span> <span class="Identifier">fromBin</span><span class="Punctuation">[</span><span class="Identifier">uint8</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">153</span>
    1481. 

  1481. <span class="Identifier">doAssert</span> <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">fromBin</span><span class="Punctuation">[</span><span class="Punctuation">:</span><span class="Identifier">int16</span><span class="Punctuation">]</span> <span class="Operator">==</span> <span class="BinNumber">0b1110_1110_1001_1001'i16</span>
    1482. 

  1482. <span class="Identifier">doAssert</span> <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">fromBin</span><span class="Punctuation">[</span><span class="Punctuation">:</span><span class="Identifier">uint64</span><span class="Punctuation">]</span> <span class="Operator">==</span> <span class="DecNumber">1216933529'</span><span class="Identifier">u64</span></pre>
    1483. 

  1483.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1066" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1484. 

  1484. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1066" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1485. 

  1485. 

  1486.   </dd>
    1487. 

  1487. </div>
    1488. 

  1488. 

  1489. </div>
    1490. 

  1490. <div id="fromHex-procs-all">
    1491. 

  1491.   <div id="fromHex,string">
    1492. 

  1492.   <dt><pre><span class="Keyword">func</span> <a href="#fromHex%2Cstring"><span class="Identifier">fromHex</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">:</span> <a href="system.html#SomeInteger"><span class="Identifier">SomeInteger</span></a><span class="Other">]</span><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">T</span></pre></dt>
    1493. 

  1493.   <dd>
    1494. 

  1494.     
    1495. 

  1495.     <p>Parses a hex integer value from a string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    1496. 

  1496. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is not a valid hex integer, <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> is raised. <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> can have one of the following optional prefixes: <tt class="docutils literal"><span class="pre"><span class="HexNumber">0x</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="HexNumber">0X</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="Comment">#</span></span></tt>. Underscores within <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> are ignored.</p>
    1497. 

  1497. <p>Does not check for overflow. If the value represented by <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is too big to fit into a return type, only the value of the rightmost hex digits of <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is returned without producing an error.</p>
    1498. 

  1498. 

  1499. <p><strong class="examples_text">Example:</strong></p>
    1500. 

  1500. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">s</span> <span class="Operator">=</span> <span class="StringLit">&quot;0x_1235_8df6&quot;</span>
    1501. 

  1501. <span class="Identifier">doAssert</span> <span class="Identifier">fromHex</span><span class="Punctuation">[</span><span class="Identifier">int</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">305499638</span>
    1502. 

  1502. <span class="Identifier">doAssert</span> <span class="Identifier">fromHex</span><span class="Punctuation">[</span><span class="Identifier">int8</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="HexNumber">0xf6'i8</span>
    1503. 

  1503. <span class="Identifier">doAssert</span> <span class="Identifier">fromHex</span><span class="Punctuation">[</span><span class="Identifier">int8</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">10'i8</span>
    1504. 

  1504. <span class="Identifier">doAssert</span> <span class="Identifier">fromHex</span><span class="Punctuation">[</span><span class="Identifier">uint8</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">246'</span><span class="Identifier">u8</span>
    1505. 

  1505. <span class="Identifier">doAssert</span> <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">fromHex</span><span class="Punctuation">[</span><span class="Punctuation">:</span><span class="Identifier">int16</span><span class="Punctuation">]</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">29194'i16</span>
    1506. 

  1506. <span class="Identifier">doAssert</span> <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">fromHex</span><span class="Punctuation">[</span><span class="Punctuation">:</span><span class="Identifier">uint64</span><span class="Punctuation">]</span> <span class="Operator">==</span> <span class="DecNumber">305499638'</span><span class="Identifier">u64</span></pre>
    1507. 

  1507.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1112" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1508. 

  1508. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1112" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1509. 

  1509. 

  1510.   </dd>
    1511. 

  1511. </div>
    1512. 

  1512. 

  1513. </div>
    1514. 

  1514. <div id="fromOct-procs-all">
    1515. 

  1515.   <div id="fromOct,string">
    1516. 

  1516.   <dt><pre><span class="Keyword">func</span> <a href="#fromOct%2Cstring"><span class="Identifier">fromOct</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">:</span> <a href="system.html#SomeInteger"><span class="Identifier">SomeInteger</span></a><span class="Other">]</span><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">T</span></pre></dt>
    1517. 

  1517.   <dd>
    1518. 

  1518.     
    1519. 

  1519.     <p>Parses an octal integer value from a string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    1520. 

  1520. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is not a valid octal integer, <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> is raised. <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> can have one of the following optional prefixes: <tt class="docutils literal"><span class="pre"><span class="OctNumber">0o</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="OctNumber">0O</span></span></tt>. Underscores within <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> are ignored.</p>
    1521. 

  1521. <p>Does not check for overflow. If the value represented by <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is too big to fit into a return type, only the value of the rightmost octal digits of <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is returned without producing an error.</p>
    1522. 

  1522. 

  1523. <p><strong class="examples_text">Example:</strong></p>
    1524. 

  1524. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">s</span> <span class="Operator">=</span> <span class="StringLit">&quot;0o_123_456_777&quot;</span>
    1525. 

  1525. <span class="Identifier">doAssert</span> <span class="Identifier">fromOct</span><span class="Punctuation">[</span><span class="Identifier">int</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">21913087</span>
    1526. 

  1526. <span class="Identifier">doAssert</span> <span class="Identifier">fromOct</span><span class="Punctuation">[</span><span class="Identifier">int8</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="OctNumber">0o377'i8</span>
    1527. 

  1527. <span class="Identifier">doAssert</span> <span class="Identifier">fromOct</span><span class="Punctuation">[</span><span class="Identifier">int8</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">1'i8</span>
    1528. 

  1528. <span class="Identifier">doAssert</span> <span class="Identifier">fromOct</span><span class="Punctuation">[</span><span class="Identifier">uint8</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">s</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">255'</span><span class="Identifier">u8</span>
    1529. 

  1529. <span class="Identifier">doAssert</span> <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">fromOct</span><span class="Punctuation">[</span><span class="Punctuation">:</span><span class="Identifier">int16</span><span class="Punctuation">]</span> <span class="Operator">==</span> <span class="DecNumber">24063'i16</span>
    1530. 

  1530. <span class="Identifier">doAssert</span> <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">fromOct</span><span class="Punctuation">[</span><span class="Punctuation">:</span><span class="Identifier">uint64</span><span class="Punctuation">]</span> <span class="Operator">==</span> <span class="DecNumber">21913087'</span><span class="Identifier">u64</span></pre>
    1531. 

  1531.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1089" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1532. 

  1532. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1089" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1533. 

  1533. 

  1534.   </dd>
    1535. 

  1535. </div>
    1536. 

  1536. 

  1537. </div>
    1538. 

  1538. <div id="indent-procs-all">
    1539. 

  1539.   <div id="indent,string,Natural,string">
    1540. 

  1540.   <dt><pre><span class="Keyword">func</span> <a href="#indent%2Cstring%2CNatural%2Cstring"><span class="Identifier">indent</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">count</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a><span class="Other">;</span> <span class="Identifier">padding</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> <span class="Other">=</span> <span class="StringLit">&quot; &quot;</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1541. 

  1541.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuIndent&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1542. 

  1542.   <dd>
    1543. 

  1543.     
    1544. 

  1544.     <p>Indents each line in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> by <tt class="docutils literal"><span class="pre"><span class="Identifier">count</span></span></tt> amount of <tt class="docutils literal"><span class="pre"><span class="Identifier">padding</span></span></tt>.</p>
    1545. 

  1545. <p><strong>Note:</strong> This does not preserve the new line characters used in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    1546. 

  1546. <p>See also:</p>
    1547. 

  1547. <ul class="simple"><li><a class="reference external" href="#align,string,Natural,char">align func</a></li>
    1548. 

  1548. <li><a class="reference external" href="#alignLeft,string,Natural,char">alignLeft func</a></li>
    1549. 

  1549. <li><a class="reference external" href="#spaces,Natural">spaces func</a></li>
    1550. 

  1550. <li><a class="reference external" href="#unindent,string,Natural,string">unindent func</a></li>
    1551. 

  1551. <li><a class="reference external" href="#dedent,string,Natural">dedent func</a></li>
    1552. 

  1552. </ul>
    1553. 

  1553. 

  1554. <p><strong class="examples_text">Example:</strong></p>
    1555. 

  1555. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">indent</span><span class="Punctuation">(</span><span class="StringLit">&quot;First line</span><span class="EscapeSequence">\c</span><span class="EscapeSequence">\l</span><span class="StringLit"> and second line.&quot;</span><span class="Punctuation">,</span> <span class="DecNumber">2</span><span class="Punctuation">)</span> <span class="Operator">==</span>
    1556. 

  1556.          <span class="StringLit">&quot;  First line</span><span class="EscapeSequence">\l</span><span class="StringLit">   and second line.&quot;</span></pre>
    1557. 

  1557.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1470" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1558. 

  1558. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1470" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1559. 

  1559. 

  1560.   </dd>
    1561. 

  1561. </div>
    1562. 

  1562. 

  1563. </div>
    1564. 

  1564. <div id="indentation-procs-all">
    1565. 

  1565.   <div id="indentation,string">
    1566. 

  1566.   <dt><pre><span class="Keyword">func</span> <a href="#indentation%2Cstring"><span class="Identifier">indentation</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1567. 

  1567.   <dd>
    1568. 

  1568.     
    1569. 

  1569.     Returns the amount of indentation all lines of <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> have in common, ignoring lines that consist only of whitespace.
    1570. 

  1570.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1528" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1571. 

  1571. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1528" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1572. 

  1572. 

  1573.   </dd>
    1574. 

  1574. </div>
    1575. 

  1575. 

  1576. </div>
    1577. 

  1577. <div id="initSkipTable-procs-all">
    1578. 

  1578.   <div id="initSkipTable,SkipTable,string">
    1579. 

  1579.   <dt><pre><span class="Keyword">func</span> <a href="#initSkipTable%2CSkipTable%2Cstring"><span class="Identifier">initSkipTable</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="strutils.html#SkipTable"><span class="Identifier">SkipTable</span></a><span class="Other">;</span> <span class="Identifier">sub</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1580. 

  1580.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuInitSkipTable&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1581. 

  1581.   <dd>
    1582. 

  1582.     
    1583. 

  1583.     <p>Initializes table <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt> for efficient search of substring <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt>.</p>
    1584. 

  1584. <p>See also:</p>
    1585. 

  1585. <ul class="simple"><li><a class="reference external" href="#initSkipTable,string">initSkipTable func</a></li>
    1586. 

  1586. <li><a class="reference external" href="#find,SkipTable,string,string,Natural,int">find func</a></li>
    1587. 

  1587. </ul>
    1588. 

  1588. 

  1589.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1896" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1590. 

  1590. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1896" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1591. 

  1591. 

  1592.   </dd>
    1593. 

  1593. </div>
    1594. 

  1594. <div id="initSkipTable,string">
    1595. 

  1595.   <dt><pre><span class="Keyword">func</span> <a href="#initSkipTable%2Cstring"><span class="Identifier">initSkipTable</span></a><span class="Other">(</span><span class="Identifier">sub</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="strutils.html#SkipTable"><span class="Identifier">SkipTable</span></a> {.<span class="Identifier">noinit</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1596. 

  1596.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuInitNewSkipTable&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1597. 

  1597.   <dd>
    1598. 

  1598.     
    1599. 

  1599.     <p>Returns a new table initialized for <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt>.</p>
    1600. 

  1600. <p>See also:</p>
    1601. 

  1601. <ul class="simple"><li><a class="reference external" href="#initSkipTable,SkipTable,string">initSkipTable func</a></li>
    1602. 

  1602. <li><a class="reference external" href="#find,SkipTable,string,string,Natural,int">find func</a></li>
    1603. 

  1603. </ul>
    1604. 

  1604. 

  1605.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1910" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1606. 

  1606. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1910" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1607. 

  1607. 

  1608.   </dd>
    1609. 

  1609. </div>
    1610. 

  1610. 

  1611. </div>
    1612. 

  1612. <div id="insertSep-procs-all">
    1613. 

  1613.   <div id="insertSep,string,char,int">
    1614. 

  1614.   <dt><pre><span class="Keyword">func</span> <a href="#insertSep%2Cstring%2Cchar%2Cint"><span class="Identifier">insertSep</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sep</span> <span class="Other">=</span> <span class="CharLit">'_'</span><span class="Other">;</span> <span class="Identifier">digits</span> <span class="Other">=</span> <span class="DecNumber">3</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1615. 

  1615.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuInsertSep&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1616. 

  1616.   <dd>
    1617. 

  1617.     
    1618. 

  1618.     <p>Inserts the separator <tt class="docutils literal"><span class="pre"><span class="Identifier">sep</span></span></tt> after <tt class="docutils literal"><span class="pre"><span class="Identifier">digits</span></span></tt> characters (default: 3) from right to left.</p>
    1619. 

  1619. <p>Even though the algorithm works with any string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>, it is only useful if <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> contains a number.</p>
    1620. 

  1620. 

  1621. <p><strong class="examples_text">Example:</strong></p>
    1622. 

  1622. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">insertSep</span><span class="Punctuation">(</span><span class="StringLit">&quot;1000000&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;1_000_000&quot;</span></pre>
    1623. 

  1623.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2335" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1624. 

  1624. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2335" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1625. 

  1625. 

  1626.   </dd>
    1627. 

  1627. </div>
    1628. 

  1628. 

  1629. </div>
    1630. 

  1630. <div id="intToStr-procs-all">
    1631. 

  1631.   <div id="intToStr,int,Positive">
    1632. 

  1632.   <dt><pre><span class="Keyword">func</span> <a href="#intToStr%2Cint%2CPositive"><span class="Identifier">intToStr</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">;</span> <span class="Identifier">minchars</span><span class="Other">:</span> <a href="system.html#Positive"><span class="Identifier">Positive</span></a> <span class="Other">=</span> <span class="DecNumber">1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1633. 

  1633.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuIntToStr&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1634. 

  1634.   <dd>
    1635. 

  1635.     
    1636. 

  1636.     <p>Converts <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt> to its decimal representation.</p>
    1637. 

  1637. <p>The resulting string will be minimally <tt class="docutils literal"><span class="pre"><span class="Identifier">minchars</span></span></tt> characters long. This is achieved by adding leading zeros.</p>
    1638. 

  1638. 

  1639. <p><strong class="examples_text">Example:</strong></p>
    1640. 

  1640. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">intToStr</span><span class="Punctuation">(</span><span class="DecNumber">1984</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;1984&quot;</span>
    1641. 

  1641. <span class="Identifier">doAssert</span> <span class="Identifier">intToStr</span><span class="Punctuation">(</span><span class="DecNumber">1984</span><span class="Punctuation">,</span> <span class="DecNumber">6</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;001984&quot;</span></pre>
    1642. 

  1642.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1135" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1643. 

  1643. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1135" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1644. 

  1644. 

  1645.   </dd>
    1646. 

  1646. </div>
    1647. 

  1647. 

  1648. </div>
    1649. 

  1649. <div id="isAlphaAscii-procs-all">
    1650. 

  1650.   <div id="isAlphaAscii,char">
    1651. 

  1651.   <dt><pre><span class="Keyword">func</span> <a href="#isAlphaAscii%2Cchar"><span class="Identifier">isAlphaAscii</span></a><span class="Other">(</span><span class="Identifier">c</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuIsAlphaAsciiChar&quot;</span><span class="Other">,</span>
    1652. 

  1652.                                    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1653. 

  1653.   <dd>
    1654. 

  1654.     
    1655. 

  1655.     <p>Checks whether or not character <tt class="docutils literal"><span class="pre"><span class="Identifier">c</span></span></tt> is alphabetical.</p>
    1656. 

  1656. <p>This checks a-z, A-Z ASCII characters only. Use <a class="reference external" href="unicode.html">Unicode module</a> for UTF-8 support.</p>
    1657. 

  1657. 

  1658. <p><strong class="examples_text">Example:</strong></p>
    1659. 

  1659. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">isAlphaAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">e</span><span class="CharLit">') == true</span>
    1660. 

  1660. <span class="Identifier">doAssert</span> <span class="Identifier">isAlphaAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">E</span><span class="CharLit">') == true</span>
    1661. 

  1661. <span class="Identifier">doAssert</span> <span class="Identifier">isAlphaAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="DecNumber">8'</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">false</span></pre>
    1662. 

  1662.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L138" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1663. 

  1663. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L138" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1664. 

  1664. 

  1665.   </dd>
    1666. 

  1666. </div>
    1667. 

  1667. 

  1668. </div>
    1669. 

  1669. <div id="isAlphaNumeric-procs-all">
    1670. 

  1670.   <div id="isAlphaNumeric,char">
    1671. 

  1671.   <dt><pre><span class="Keyword">func</span> <a href="#isAlphaNumeric%2Cchar"><span class="Identifier">isAlphaNumeric</span></a><span class="Other">(</span><span class="Identifier">c</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuIsAlphaNumericChar&quot;</span><span class="Other">,</span>
    1672. 

  1672.                                      <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1673. 

  1673.   <dd>
    1674. 

  1674.     
    1675. 

  1675.     <p>Checks whether or not <tt class="docutils literal"><span class="pre"><span class="Identifier">c</span></span></tt> is alphanumeric.</p>
    1676. 

  1676. <p>This checks a-z, A-Z, 0-9 ASCII characters only.</p>
    1677. 

  1677. 

  1678. <p><strong class="examples_text">Example:</strong></p>
    1679. 

  1679. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">isAlphaNumeric</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">n</span><span class="CharLit">') == true</span>
    1680. 

  1680. <span class="Identifier">doAssert</span> <span class="Identifier">isAlphaNumeric</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="DecNumber">8'</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">true</span>
    1681. 

  1681. <span class="Identifier">doAssert</span> <span class="Identifier">isAlphaNumeric</span><span class="Punctuation">(</span><span class="Punctuation">'</span> <span class="CharLit">') == false</span></pre>
    1682. 

  1682.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L149" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1683. 

  1683. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L149" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1684. 

  1684. 

  1685.   </dd>
    1686. 

  1686. </div>
    1687. 

  1687. 

  1688. </div>
    1689. 

  1689. <div id="isDigit-procs-all">
    1690. 

  1690.   <div id="isDigit,char">
    1691. 

  1691.   <dt><pre><span class="Keyword">func</span> <a href="#isDigit%2Cchar"><span class="Identifier">isDigit</span></a><span class="Other">(</span><span class="Identifier">c</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuIsDigitChar&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1692. 

  1692.                               <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1693. 

  1693.   <dd>
    1694. 

  1694.     
    1695. 

  1695.     <p>Checks whether or not <tt class="docutils literal"><span class="pre"><span class="Identifier">c</span></span></tt> is a number.</p>
    1696. 

  1696. <p>This checks 0-9 ASCII characters only.</p>
    1697. 

  1697. 

  1698. <p><strong class="examples_text">Example:</strong></p>
    1699. 

  1699. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">isDigit</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">n</span><span class="CharLit">') == false</span>
    1700. 

  1700. <span class="Identifier">doAssert</span> <span class="Identifier">isDigit</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="DecNumber">8'</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">true</span></pre>
    1701. 

  1701.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L159" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1702. 

  1702. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L159" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1703. 

  1703. 

  1704.   </dd>
    1705. 

  1705. </div>
    1706. 

  1706. 

  1707. </div>
    1708. 

  1708. <div id="isEmptyOrWhitespace-procs-all">
    1709. 

  1709.   <div id="isEmptyOrWhitespace,string">
    1710. 

  1710.   <dt><pre><span class="Keyword">func</span> <a href="#isEmptyOrWhitespace%2Cstring"><span class="Identifier">isEmptyOrWhitespace</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1711. 

  1711.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuIsEmptyOrWhitespace&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1712. 

  1712.   <dd>
    1713. 

  1713.     
    1714. 

  1714.     Checks if <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is empty or consists entirely of whitespace characters.
    1715. 

  1715.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L3032" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1716. 

  1716. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L3032" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1717. 

  1717. 

  1718.   </dd>
    1719. 

  1719. </div>
    1720. 

  1720. 

  1721. </div>
    1722. 

  1722. <div id="isLowerAscii-procs-all">
    1723. 

  1723.   <div id="isLowerAscii,char">
    1724. 

  1724.   <dt><pre><span class="Keyword">func</span> <a href="#isLowerAscii%2Cchar"><span class="Identifier">isLowerAscii</span></a><span class="Other">(</span><span class="Identifier">c</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuIsLowerAsciiChar&quot;</span><span class="Other">,</span>
    1725. 

  1725.                                    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1726. 

  1726.   <dd>
    1727. 

  1727.     
    1728. 

  1728.     <p>Checks whether or not <tt class="docutils literal"><span class="pre"><span class="Identifier">c</span></span></tt> is a lower case character.</p>
    1729. 

  1729. <p>This checks ASCII characters only. Use <a class="reference external" href="unicode.html">Unicode module</a> for UTF-8 support.</p>
    1730. 

  1730. <p>See also:</p>
    1731. 

  1731. <ul class="simple"><li><a class="reference external" href="#toLowerAscii,char">toLowerAscii func</a></li>
    1732. 

  1732. </ul>
    1733. 

  1733. 

  1734. <p><strong class="examples_text">Example:</strong></p>
    1735. 

  1735. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">isLowerAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">e</span><span class="CharLit">') == true</span>
    1736. 

  1736. <span class="Identifier">doAssert</span> <span class="Identifier">isLowerAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">E</span><span class="CharLit">') == false</span>
    1737. 

  1737. <span class="Identifier">doAssert</span> <span class="Identifier">isLowerAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="DecNumber">7'</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">false</span></pre>
    1738. 

  1738.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L176" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1739. 

  1739. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L176" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1740. 

  1740. 

  1741.   </dd>
    1742. 

  1742. </div>
    1743. 

  1743. 

  1744. </div>
    1745. 

  1745. <div id="isSpaceAscii-procs-all">
    1746. 

  1746.   <div id="isSpaceAscii,char">
    1747. 

  1747.   <dt><pre><span class="Keyword">func</span> <a href="#isSpaceAscii%2Cchar"><span class="Identifier">isSpaceAscii</span></a><span class="Other">(</span><span class="Identifier">c</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuIsSpaceAsciiChar&quot;</span><span class="Other">,</span>
    1748. 

  1748.                                    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1749. 

  1749.   <dd>
    1750. 

  1750.     
    1751. 

  1751.     Checks whether or not <tt class="docutils literal"><span class="pre"><span class="Identifier">c</span></span></tt> is a whitespace character.
    1752. 

  1752. <p><strong class="examples_text">Example:</strong></p>
    1753. 

  1753. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">isSpaceAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">n</span><span class="CharLit">') == false</span>
    1754. 

  1754. <span class="Identifier">doAssert</span> <span class="Identifier">isSpaceAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span> <span class="CharLit">') == true</span>
    1755. 

  1755. <span class="Identifier">doAssert</span> <span class="Identifier">isSpaceAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Operator">\</span><span class="Identifier">t</span><span class="CharLit">') == true</span></pre>
    1756. 

  1756.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L168" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1757. 

  1757. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L168" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1758. 

  1758. 

  1759.   </dd>
    1760. 

  1760. </div>
    1761. 

  1761. 

  1762. </div>
    1763. 

  1763. <div id="isUpperAscii-procs-all">
    1764. 

  1764.   <div id="isUpperAscii,char">
    1765. 

  1765.   <dt><pre><span class="Keyword">func</span> <a href="#isUpperAscii%2Cchar"><span class="Identifier">isUpperAscii</span></a><span class="Other">(</span><span class="Identifier">c</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuIsUpperAsciiChar&quot;</span><span class="Other">,</span>
    1766. 

  1766.                                    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1767. 

  1767.   <dd>
    1768. 

  1768.     
    1769. 

  1769.     <p>Checks whether or not <tt class="docutils literal"><span class="pre"><span class="Identifier">c</span></span></tt> is an upper case character.</p>
    1770. 

  1770. <p>This checks ASCII characters only. Use <a class="reference external" href="unicode.html">Unicode module</a> for UTF-8 support.</p>
    1771. 

  1771. <p>See also:</p>
    1772. 

  1772. <ul class="simple"><li><a class="reference external" href="#toUpperAscii,char">toUpperAscii func</a></li>
    1773. 

  1773. </ul>
    1774. 

  1774. 

  1775. <p><strong class="examples_text">Example:</strong></p>
    1776. 

  1776. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">isUpperAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">e</span><span class="CharLit">') == false</span>
    1777. 

  1777. <span class="Identifier">doAssert</span> <span class="Identifier">isUpperAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">E</span><span class="CharLit">') == true</span>
    1778. 

  1778. <span class="Identifier">doAssert</span> <span class="Identifier">isUpperAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="DecNumber">7'</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">false</span></pre>
    1779. 

  1779.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L190" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1780. 

  1780. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L190" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1781. 

  1781. 

  1782.   </dd>
    1783. 

  1783. </div>
    1784. 

  1784. 

  1785. </div>
    1786. 

  1786. <div id="join-procs-all">
    1787. 

  1787.   <div id="join,openArray[string],string">
    1788. 

  1788.   <dt><pre><span class="Keyword">func</span> <a href="#join%2CopenArray%5Bstring%5D%2Cstring"><span class="Identifier">join</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#openArray"><span class="Identifier">openArray</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">sep</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> <span class="Other">=</span> <span class="StringLit">&quot;&quot;</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1789. 

  1789.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuJoinSep&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1790. 

  1790.   <dd>
    1791. 

  1791.     
    1792. 

  1792.     Concatenates all strings in the container <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt>, separating them with <tt class="docutils literal"><span class="pre"><span class="Identifier">sep</span></span></tt>.
    1793. 

  1793. <p><strong class="examples_text">Example:</strong></p>
    1794. 

  1794. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">join</span><span class="Punctuation">(</span><span class="Punctuation">[</span><span class="StringLit">&quot;A&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;B&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;Conclusion&quot;</span><span class="Punctuation">]</span><span class="Punctuation">,</span> <span class="StringLit">&quot; -&gt; &quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;A -&gt; B -&gt; Conclusion&quot;</span></pre>
    1795. 

  1795.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1864" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1796. 

  1796. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1864" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1797. 

  1797. 

  1798.   </dd>
    1799. 

  1799. </div>
    1800. 

  1800. <div id="join,openArray[T],string">
    1801. 

  1801.   <dt><pre><span class="Keyword">proc</span> <a href="#join%2CopenArray%5BT%5D%2Cstring"><span class="Identifier">join</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">:</span> <span class="Keyword">not</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#openArray"><span class="Identifier">openArray</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">sep</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> <span class="Other">=</span> <span class="StringLit">&quot;&quot;</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a></pre></dt>
    1802. 

  1802.   <dd>
    1803. 

  1803.     
    1804. 

  1804.     Converts all elements in the container <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt> to strings using <tt class="docutils literal"><span class="pre"><span class="Operator">$</span></span></tt>, and concatenates them with <tt class="docutils literal"><span class="pre"><span class="Identifier">sep</span></span></tt>.
    1805. 

  1805. <p><strong class="examples_text">Example:</strong></p>
    1806. 

  1806. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">join</span><span class="Punctuation">(</span><span class="Punctuation">[</span><span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="DecNumber">3</span><span class="Punctuation">]</span><span class="Punctuation">,</span> <span class="StringLit">&quot; -&gt; &quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;1 -&gt; 2 -&gt; 3&quot;</span></pre>
    1807. 

  1807.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1881" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1808. 

  1808. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1881" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1809. 

  1809. 

  1810.   </dd>
    1811. 

  1811. </div>
    1812. 

  1812. 

  1813. </div>
    1814. 

  1814. <div id="multiReplace-procs-all">
    1815. 

  1815.   <div id="multiReplace,string,varargs[]">
    1816. 

  1816.   <dt><pre><span class="Keyword">func</span> <a href="#multiReplace%2Cstring%2Cvarargs%5B%5D"><span class="Identifier">multiReplace</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">replacements</span><span class="Other">:</span> <a href="system.html#varargs"><span class="Identifier">varargs</span></a><span class="Other">[</span><span class="Other">(</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">,</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.
    1817. 

  1817.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1818. 

  1818.   <dd>
    1819. 

  1819.     
    1820. 

  1820.     <p>Same as <a class="reference external" href="#replace,string,string,string">replace</a>, but specialized for doing multiple replacements in a single pass through the input string.</p>
    1821. 

  1821. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">multiReplace</span></span></tt> scans the input string from left to right and replaces the matching substrings in the same order as passed in the argument list.</p>
    1822. 

  1822. <p>The implications of the order of scanning the string and matching the replacements:</p>
    1823. 

  1823. <ul class="simple"><li>In case of multiple matches at a given position, the earliest replacement is applied.</li>
    1824. 

  1824. <li>Overlaps are not handled. After performing a replacement, the scan continues from the character after the matched substring. If the resulting string then contains a possible match starting in a newly placed substring, the additional replacement is not performed.</li>
    1825. 

  1825. </ul>
    1826. 

  1826. <p>If the resulting string is not longer than the original input string, only a single memory allocation is required. </p>
    1827. 

  1827. 

  1828. <p><strong class="examples_text">Example:</strong></p>
    1829. 

  1829. <pre class="listing"><span class="Comment"># Swapping occurrences of 'a' and 'b':</span>
    1830. 

  1830. <span class="Identifier">doAssert</span> <span class="Identifier">multireplace</span><span class="Punctuation">(</span><span class="StringLit">&quot;abba&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">[</span><span class="Punctuation">(</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;b&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Punctuation">(</span><span class="StringLit">&quot;b&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;a&quot;</span><span class="Punctuation">)</span><span class="Punctuation">]</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;baab&quot;</span>
    1831. 

  1831. 

  1832. <span class="Comment"># The second replacement (&quot;ab&quot;) is matched and performed first, the scan then</span>
    1833. 

  1833. <span class="Comment"># continues from 'c', so the &quot;bc&quot; replacement is never matched and thus skipped.</span>
    1834. 

  1834. <span class="Identifier">doAssert</span> <span class="Identifier">multireplace</span><span class="Punctuation">(</span><span class="StringLit">&quot;abc&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">[</span><span class="Punctuation">(</span><span class="StringLit">&quot;bc&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;x&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Punctuation">(</span><span class="StringLit">&quot;ab&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;_b&quot;</span><span class="Punctuation">)</span><span class="Punctuation">]</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;_bc&quot;</span></pre>
    1835. 

  1835.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2286" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1836. 

  1836. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2286" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1837. 

  1837. 

  1838.   </dd>
    1839. 

  1839. </div>
    1840. 

  1840. 

  1841. </div>
    1842. 

  1842. <div id="nimIdentNormalize-procs-all">
    1843. 

  1843.   <div id="nimIdentNormalize,string">
    1844. 

  1844.   <dt><pre><span class="Keyword">func</span> <a href="#nimIdentNormalize%2Cstring"><span class="Identifier">nimIdentNormalize</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1845. 

  1845.   <dd>
    1846. 

  1846.     
    1847. 

  1847.     <p>Normalizes the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> as a Nim identifier.</p>
    1848. 

  1848. <p>That means to convert to lower case and remove any '_' on all characters except first one.</p>
    1849. 

  1849. <div class="admonition admonition-warning"><span class="admonition-warning-text"><b>Warning:</b></span>
    1850. 

  1850. Backticks (`) are not handled: they remain <em>as is</em> and spaces are preserved. See <a class="reference external" href="dochelpers.html#nimIdentBackticksNormalize,string">nimIdentBackticksNormalize</a> for an alternative approach.</div>
    1851. 

  1851. 

  1852. <p><strong class="examples_text">Example:</strong></p>
    1853. 

  1853. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">nimIdentNormalize</span><span class="Punctuation">(</span><span class="StringLit">&quot;Foo_bar&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;Foobar&quot;</span></pre>
    1854. 

  1854.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L286" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1855. 

  1855. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L286" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1856. 

  1856. 

  1857.   </dd>
    1858. 

  1858. </div>
    1859. 

  1859. 

  1860. </div>
    1861. 

  1861. <div id="normalize-procs-all">
    1862. 

  1862.   <div id="normalize,string">
    1863. 

  1863.   <dt><pre><span class="Keyword">func</span> <a href="#normalize%2Cstring"><span class="Identifier">normalize</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuNormalize&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1864. 

  1864.                                     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1865. 

  1865.   <dd>
    1866. 

  1866.     
    1867. 

  1867.     <p>Normalizes the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    1868. 

  1868. <p>That means to convert it to lower case and remove any '_'. This should NOT be used to normalize Nim identifier names.</p>
    1869. 

  1869. <p>See also:</p>
    1870. 

  1870. <ul class="simple"><li><a class="reference external" href="#toLowerAscii,string">toLowerAscii func</a></li>
    1871. 

  1871. </ul>
    1872. 

  1872. 

  1873. <p><strong class="examples_text">Example:</strong></p>
    1874. 

  1874. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">normalize</span><span class="Punctuation">(</span><span class="StringLit">&quot;Foo_bar&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;foobar&quot;</span>
    1875. 

  1875. <span class="Identifier">doAssert</span> <span class="Identifier">normalize</span><span class="Punctuation">(</span><span class="StringLit">&quot;Foo Bar&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;foo bar&quot;</span></pre>
    1876. 

  1876.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L312" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1877. 

  1877. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L312" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1878. 

  1878. 

  1879.   </dd>
    1880. 

  1880. </div>
    1881. 

  1881. 

  1882. </div>
    1883. 

  1883. <div id="parseBiggestInt-procs-all">
    1884. 

  1884.   <div id="parseBiggestInt,string">
    1885. 

  1885.   <dt><pre><span class="Keyword">func</span> <a href="#parseBiggestInt%2Cstring"><span class="Identifier">parseBiggestInt</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="ctypes.html#BiggestInt"><span class="Identifier">BiggestInt</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1886. 

  1886.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuParseBiggestInt&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1887. 

  1887.   <dd>
    1888. 

  1888.     
    1889. 

  1889.     <p>Parses a decimal integer value contained in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    1890. 

  1890. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is not a valid integer, <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> is raised.</p>
    1891. 

  1891. 

  1892.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1161" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1893. 

  1893. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1161" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1894. 

  1894. 

  1895.   </dd>
    1896. 

  1896. </div>
    1897. 

  1897. 

  1898. </div>
    1899. 

  1899. <div id="parseBiggestUInt-procs-all">
    1900. 

  1900.   <div id="parseBiggestUInt,string">
    1901. 

  1901.   <dt><pre><span class="Keyword">func</span> <a href="#parseBiggestUInt%2Cstring"><span class="Identifier">parseBiggestUInt</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="ctypes.html#BiggestUInt"><span class="Identifier">BiggestUInt</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1902. 

  1902.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuParseBiggestUInt&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1903. 

  1903.   <dd>
    1904. 

  1904.     
    1905. 

  1905.     <p>Parses a decimal unsigned integer value contained in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    1906. 

  1906. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is not a valid integer, <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> is raised.</p>
    1907. 

  1907. 

  1908.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1180" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1909. 

  1909. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1180" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1910. 

  1910. 

  1911.   </dd>
    1912. 

  1912. </div>
    1913. 

  1913. 

  1914. </div>
    1915. 

  1915. <div id="parseBinInt-procs-all">
    1916. 

  1916.   <div id="parseBinInt,string">
    1917. 

  1917.   <dt><pre><span class="Keyword">func</span> <a href="#parseBinInt%2Cstring"><span class="Identifier">parseBinInt</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuParseBinInt&quot;</span><span class="Other">,</span>
    1918. 

  1918.                                    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1919. 

  1919.   <dd>
    1920. 

  1920.     
    1921. 

  1921.     <p>Parses a binary integer value contained in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    1922. 

  1922. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is not a valid binary integer, <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> is raised. <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> can have one of the following optional prefixes: <tt class="docutils literal"><span class="pre"><span class="BinNumber">0b</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="BinNumber">0B</span></span></tt>. Underscores within <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> are ignored.</p>
    1923. 

  1923. 

  1924. <p><strong class="examples_text">Example:</strong></p>
    1925. 

  1925. <pre class="listing"><span class="Keyword">let</span>
    1926. 

  1926.   <span class="Identifier">a</span> <span class="Operator">=</span> <span class="StringLit">&quot;0b11_0101&quot;</span>
    1927. 

  1927.   <span class="Identifier">b</span> <span class="Operator">=</span> <span class="StringLit">&quot;111&quot;</span>
    1928. 

  1928. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">parseBinInt</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">53</span>
    1929. 

  1929. <span class="Identifier">doAssert</span> <span class="Identifier">b</span><span class="Operator">.</span><span class="Identifier">parseBinInt</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">7</span></pre>
    1930. 

  1930.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1203" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1931. 

  1931. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1203" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1932. 

  1932. 

  1933.   </dd>
    1934. 

  1934. </div>
    1935. 

  1935. 

  1936. </div>
    1937. 

  1937. <div id="parseBool-procs-all">
    1938. 

  1938.   <div id="parseBool,string">
    1939. 

  1939.   <dt><pre><span class="Keyword">func</span> <a href="#parseBool%2Cstring"><span class="Identifier">parseBool</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1940. 

  1940.   <dd>
    1941. 

  1941.     
    1942. 

  1942.     <p>Parses a value into a <tt class="docutils literal"><span class="pre"><span class="Identifier">bool</span></span></tt>.</p>
    1943. 

  1943. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is one of the following values: <tt class="docutils literal"><span class="pre"><span class="Identifier">y</span><span class="Punctuation">,</span> <span class="Identifier">yes</span><span class="Punctuation">,</span> <span class="Identifier">true</span><span class="Punctuation">,</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="Identifier">on</span></span></tt>, then returns <tt class="docutils literal"><span class="pre"><span class="Identifier">true</span></span></tt>. If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is one of the following values: <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span><span class="Punctuation">,</span> <span class="Identifier">no</span><span class="Punctuation">,</span> <span class="Identifier">false</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="Identifier">off</span></span></tt>, then returns <tt class="docutils literal"><span class="pre"><span class="Identifier">false</span></span></tt>.  If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is something else a <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> exception is raised.</p>
    1944. 

  1944. 

  1945. <p><strong class="examples_text">Example:</strong></p>
    1946. 

  1946. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="StringLit">&quot;n&quot;</span>
    1947. 

  1947. <span class="Identifier">doAssert</span> <span class="Identifier">parseBool</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">false</span></pre>
    1948. 

  1948.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1289" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1949. 

  1949. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1289" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1950. 

  1950. 

  1951.   </dd>
    1952. 

  1952. </div>
    1953. 

  1953. 

  1954. </div>
    1955. 

  1955. <div id="parseEnum-procs-all">
    1956. 

  1956.   <div id="parseEnum,string">
    1957. 

  1957.   <dt><pre><span class="Keyword">func</span> <a href="#parseEnum%2Cstring"><span class="Identifier">parseEnum</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">:</span> <span class="Keyword">enum</span><span class="Other">]</span><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">T</span></pre></dt>
    1958. 

  1958.   <dd>
    1959. 

  1959.     
    1960. 

  1960.     <p>Parses an enum <tt class="docutils literal"><span class="pre"><span class="Identifier">T</span></span></tt>. This errors at compile time, if the given enum type contains multiple fields with the same string value.</p>
    1961. 

  1961. <p>Raises <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> for an invalid value in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>. The comparison is done in a style insensitive way (first letter is still case-sensitive).</p>
    1962. 

  1962. 

  1963. <p><strong class="examples_text">Example:</strong></p>
    1964. 

  1964. <pre class="listing"><span class="Keyword">type</span>
    1965. 

  1965.   <span class="Identifier">MyEnum</span> <span class="Operator">=</span> <span class="Keyword">enum</span>
    1966. 

  1966.     <span class="Identifier">first</span> <span class="Operator">=</span> <span class="StringLit">&quot;1st&quot;</span><span class="Punctuation">,</span>
    1967. 

  1967.     <span class="Identifier">second</span><span class="Punctuation">,</span>
    1968. 

  1968.     <span class="Identifier">third</span> <span class="Operator">=</span> <span class="StringLit">&quot;3rd&quot;</span>
    1969. 

  1969. 

  1970. <span class="Identifier">doAssert</span> <span class="Identifier">parseEnum</span><span class="Punctuation">[</span><span class="Identifier">MyEnum</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="StringLit">&quot;1_st&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">first</span>
    1971. 

  1971. <span class="Identifier">doAssert</span> <span class="Identifier">parseEnum</span><span class="Punctuation">[</span><span class="Identifier">MyEnum</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="StringLit">&quot;second&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">second</span>
    1972. 

  1972. <span class="Identifier">doAssertRaises</span><span class="Punctuation">(</span><span class="Identifier">ValueError</span><span class="Punctuation">)</span><span class="Punctuation">:</span>
    1973. 

  1973.   <span class="Identifier">echo</span> <span class="Identifier">parseEnum</span><span class="Punctuation">[</span><span class="Identifier">MyEnum</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="StringLit">&quot;third&quot;</span><span class="Punctuation">)</span></pre>
    1974. 

  1974.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1305" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1975. 

  1975. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1305" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1976. 

  1976. 

  1977.   </dd>
    1978. 

  1978. </div>
    1979. 

  1979. <div id="parseEnum,string,T">
    1980. 

  1980.   <dt><pre><span class="Keyword">func</span> <a href="#parseEnum%2Cstring%2CT"><span class="Identifier">parseEnum</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">:</span> <span class="Keyword">enum</span><span class="Other">]</span><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">default</span><span class="Other">:</span> <span class="Identifier">T</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">T</span></pre></dt>
    1981. 

  1981.   <dd>
    1982. 

  1982.     
    1983. 

  1983.     <p>Parses an enum <tt class="docutils literal"><span class="pre"><span class="Identifier">T</span></span></tt>. This errors at compile time, if the given enum type contains multiple fields with the same string value.</p>
    1984. 

  1984. <p>Uses <tt class="docutils literal"><span class="pre"><span class="Identifier">default</span></span></tt> for an invalid value in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>. The comparison is done in a style insensitive way (first letter is still case-sensitive).</p>
    1985. 

  1985. 

  1986. <p><strong class="examples_text">Example:</strong></p>
    1987. 

  1987. <pre class="listing"><span class="Keyword">type</span>
    1988. 

  1988.   <span class="Identifier">MyEnum</span> <span class="Operator">=</span> <span class="Keyword">enum</span>
    1989. 

  1989.     <span class="Identifier">first</span> <span class="Operator">=</span> <span class="StringLit">&quot;1st&quot;</span><span class="Punctuation">,</span>
    1990. 

  1990.     <span class="Identifier">second</span><span class="Punctuation">,</span>
    1991. 

  1991.     <span class="Identifier">third</span> <span class="Operator">=</span> <span class="StringLit">&quot;3rd&quot;</span>
    1992. 

  1992. 

  1993. <span class="Identifier">doAssert</span> <span class="Identifier">parseEnum</span><span class="Punctuation">[</span><span class="Identifier">MyEnum</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="StringLit">&quot;1_st&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">first</span>
    1994. 

  1994. <span class="Identifier">doAssert</span> <span class="Identifier">parseEnum</span><span class="Punctuation">[</span><span class="Identifier">MyEnum</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="StringLit">&quot;second&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">second</span>
    1995. 

  1995. <span class="Identifier">doAssert</span> <span class="Identifier">parseEnum</span><span class="Punctuation">[</span><span class="Identifier">MyEnum</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="StringLit">&quot;last&quot;</span><span class="Punctuation">,</span> <span class="Identifier">third</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">third</span></pre>
    1996. 

  1996.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1325" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1997. 

  1997. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1325" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1998. 

  1998. 

  1999.   </dd>
    2000. 

  2000. </div>
    2001. 

  2001. 

  2002. </div>
    2003. 

  2003. <div id="parseFloat-procs-all">
    2004. 

  2004.   <div id="parseFloat,string">
    2005. 

  2005.   <dt><pre><span class="Keyword">func</span> <a href="#parseFloat%2Cstring"><span class="Identifier">parseFloat</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#float"><span class="Identifier">float</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuParseFloat&quot;</span><span class="Other">,</span>
    2006. 

  2006.                                     <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2007. 

  2007.   <dd>
    2008. 

  2008.     
    2009. 

  2009.     <p>Parses a decimal floating point value contained in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    2010. 

  2010. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is not a valid floating point number, <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> is raised. <tt class="docutils literal"><span class="pre"><span class="Identifier">NAN</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="Identifier">INF</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="Operator">-</span><span class="Identifier">INF</span></span></tt> are also supported (case insensitive comparison).</p>
    2011. 

  2011. 

  2012. <p><strong class="examples_text">Example:</strong></p>
    2013. 

  2013. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">parseFloat</span><span class="Punctuation">(</span><span class="StringLit">&quot;3.14&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="FloatNumber">3.14</span>
    2014. 

  2014. <span class="Identifier">doAssert</span> <span class="Identifier">parseFloat</span><span class="Punctuation">(</span><span class="StringLit">&quot;inf&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="FloatNumber">1.0</span><span class="Operator">/</span><span class="DecNumber">0</span></pre>
    2015. 

  2015.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1190" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2016. 

  2016. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1190" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2017. 

  2017. 

  2018.   </dd>
    2019. 

  2019. </div>
    2020. 

  2020. 

  2021. </div>
    2022. 

  2022. <div id="parseHexInt-procs-all">
    2023. 

  2023.   <div id="parseHexInt,string">
    2024. 

  2024.   <dt><pre><span class="Keyword">func</span> <a href="#parseHexInt%2Cstring"><span class="Identifier">parseHexInt</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuParseHexInt&quot;</span><span class="Other">,</span>
    2025. 

  2025.                                    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2026. 

  2026.   <dd>
    2027. 

  2027.     
    2028. 

  2028.     <p>Parses a hexadecimal integer value contained in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    2029. 

  2029. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is not a valid hex integer, <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> is raised. <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> can have one of the following optional prefixes: <tt class="docutils literal"><span class="pre"><span class="HexNumber">0x</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="HexNumber">0X</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="Comment">#</span></span></tt>.  Underscores within <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> are ignored.</p>
    2030. 

  2030. 

  2031.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1232" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2032. 

  2032. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1232" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2033. 

  2033. 

  2034.   </dd>
    2035. 

  2035. </div>
    2036. 

  2036. 

  2037. </div>
    2038. 

  2038. <div id="parseHexStr-procs-all">
    2039. 

  2039.   <div id="parseHexStr,string">
    2040. 

  2040.   <dt><pre><span class="Keyword">func</span> <a href="#parseHexStr%2Cstring"><span class="Identifier">parseHexStr</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuParseHexStr&quot;</span><span class="Other">,</span>
    2041. 

  2041.                                       <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2042. 

  2042.                                       <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2043. 

  2043.   <dd>
    2044. 

  2044.     
    2045. 

  2045.     <p>Converts hex-encoded string to byte string, e.g.:</p>
    2046. 

  2046. <p>Raises <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> for an invalid hex values. The comparison is case-insensitive.</p>
    2047. 

  2047. <p>See also:</p>
    2048. 

  2048. <ul class="simple"><li><a class="reference external" href="#toHex,string">toHex func</a> for the reverse operation</li>
    2049. 

  2049. </ul>
    2050. 

  2050. 

  2051. <p><strong class="examples_text">Example:</strong></p>
    2052. 

  2052. <pre class="listing"><span class="Keyword">let</span>
    2053. 

  2053.   <span class="Identifier">a</span> <span class="Operator">=</span> <span class="StringLit">&quot;41&quot;</span>
    2054. 

  2054.   <span class="Identifier">b</span> <span class="Operator">=</span> <span class="StringLit">&quot;3161&quot;</span>
    2055. 

  2055.   <span class="Identifier">c</span> <span class="Operator">=</span> <span class="StringLit">&quot;00ff&quot;</span>
    2056. 

  2056. <span class="Identifier">doAssert</span> <span class="Identifier">parseHexStr</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;A&quot;</span>
    2057. 

  2057. <span class="Identifier">doAssert</span> <span class="Identifier">parseHexStr</span><span class="Punctuation">(</span><span class="Identifier">b</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;1a&quot;</span>
    2058. 

  2058. <span class="Identifier">doAssert</span> <span class="Identifier">parseHexStr</span><span class="Punctuation">(</span><span class="Identifier">c</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;</span><span class="EscapeSequence">\0</span><span class="EscapeSequence">\255</span><span class="StringLit">&quot;</span></pre>
    2059. 

  2059.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1258" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2060. 

  2060. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1258" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2061. 

  2061. 

  2062.   </dd>
    2063. 

  2063. </div>
    2064. 

  2064. 

  2065. </div>
    2066. 

  2066. <div id="parseInt-procs-all">
    2067. 

  2067.   <div id="parseInt,string">
    2068. 

  2068.   <dt><pre><span class="Keyword">func</span> <a href="#parseInt%2Cstring"><span class="Identifier">parseInt</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuParseInt&quot;</span><span class="Other">,</span>
    2069. 

  2069.                                 <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2070. 

  2070.   <dd>
    2071. 

  2071.     
    2072. 

  2072.     <p>Parses a decimal integer value contained in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    2073. 

  2073. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is not a valid integer, <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> is raised.</p>
    2074. 

  2074. 

  2075. <p><strong class="examples_text">Example:</strong></p>
    2076. 

  2076. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">parseInt</span><span class="Punctuation">(</span><span class="StringLit">&quot;-0042&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">42</span></pre>
    2077. 

  2077.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1150" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2078. 

  2078. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1150" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2079. 

  2079. 

  2080.   </dd>
    2081. 

  2081. </div>
    2082. 

  2082. 

  2083. </div>
    2084. 

  2084. <div id="parseOctInt-procs-all">
    2085. 

  2085.   <div id="parseOctInt,string">
    2086. 

  2086.   <dt><pre><span class="Keyword">func</span> <a href="#parseOctInt%2Cstring"><span class="Identifier">parseOctInt</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuParseOctInt&quot;</span><span class="Other">,</span>
    2087. 

  2087.                                    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2088. 

  2088.   <dd>
    2089. 

  2089.     
    2090. 

  2090.     <p>Parses an octal integer value contained in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    2091. 

  2091. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is not a valid oct integer, <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> is raised. <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> can have one of the following optional prefixes: <tt class="docutils literal"><span class="pre"><span class="OctNumber">0o</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="OctNumber">0O</span></span></tt>.  Underscores within <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> are ignored.</p>
    2092. 

  2092. 

  2093.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1221" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2094. 

  2094. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1221" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2095. 

  2095. 

  2096.   </dd>
    2097. 

  2097. </div>
    2098. 

  2098. 

  2099. </div>
    2100. 

  2100. <div id="parseUInt-procs-all">
    2101. 

  2101.   <div id="parseUInt,string">
    2102. 

  2102.   <dt><pre><span class="Keyword">func</span> <a href="#parseUInt%2Cstring"><span class="Identifier">parseUInt</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#uint"><span class="Identifier">uint</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuParseUInt&quot;</span><span class="Other">,</span>
    2103. 

  2103.                                   <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2104. 

  2104.   <dd>
    2105. 

  2105.     
    2106. 

  2106.     <p>Parses a decimal unsigned integer value contained in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    2107. 

  2107. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is not a valid integer, <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> is raised.</p>
    2108. 

  2108. 

  2109.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1171" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2110. 

  2110. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1171" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2111. 

  2111. 

  2112.   </dd>
    2113. 

  2113. </div>
    2114. 

  2114. 

  2115. </div>
    2116. 

  2116. <div id="removePrefix-procs-all">
    2117. 

  2117.   <div id="removePrefix,string,char">
    2118. 

  2118.   <dt><pre><span class="Keyword">func</span> <a href="#removePrefix%2Cstring%2Cchar"><span class="Identifier">removePrefix</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">c</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2119. 

  2119.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuRemovePrefixChar&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2120. 

  2120.   <dd>
    2121. 

  2121.     
    2122. 

  2122.     <p>Removes all occurrences of a single character (in-place) from the start of a string.</p>
    2123. 

  2123. <p>See also:</p>
    2124. 

  2124. <ul class="simple"><li><a class="reference external" href="#removeSuffix,string,char">removeSuffix func</a></li>
    2125. 

  2125. <li><a class="reference external" href="#startsWith,string,char">startsWith func</a></li>
    2126. 

  2126. </ul>
    2127. 

  2127. 

  2128. <p><strong class="examples_text">Example:</strong></p>
    2129. 

  2129. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">ident</span> <span class="Operator">=</span> <span class="StringLit">&quot;pControl&quot;</span>
    2130. 

  2130. <span class="Identifier">ident</span><span class="Operator">.</span><span class="Identifier">removePrefix</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">p</span><span class="CharLit">')</span>
    2131. 

  2131. <span class="Identifier">doAssert</span> <span class="Identifier">ident</span> <span class="Operator">==</span> <span class="StringLit">&quot;Control&quot;</span></pre>
    2132. 

  2132.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1722" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2133. 

  2133. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1722" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2134. 

  2134. 

  2135.   </dd>
    2136. 

  2136. </div>
    2137. 

  2137. <div id="removePrefix,string,set[char]">
    2138. 

  2138.   <dt><pre><span class="Keyword">func</span> <a href="#removePrefix%2Cstring%2Cset%5Bchar%5D"><span class="Identifier">removePrefix</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">chars</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">]</span> <span class="Other">=</span> <span class="Identifier">Newlines</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2139. 

  2139.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuRemovePrefixCharSet&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2140. 

  2140.   <dd>
    2141. 

  2141.     
    2142. 

  2142.     <p>Removes all characters from <tt class="docutils literal"><span class="pre"><span class="Identifier">chars</span></span></tt> from the start of the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> (in-place).</p>
    2143. 

  2143. <p>See also:</p>
    2144. 

  2144. <ul class="simple"><li><a class="reference external" href="#removeSuffix,string,set[char]">removeSuffix func</a></li>
    2145. 

  2145. </ul>
    2146. 

  2146. 

  2147. <p><strong class="examples_text">Example:</strong></p>
    2148. 

  2148. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">userInput</span> <span class="Operator">=</span> <span class="StringLit">&quot;</span><span class="EscapeSequence">\r</span><span class="EscapeSequence">\n</span><span class="StringLit">*~Hello World!&quot;</span>
    2149. 

  2149. <span class="Identifier">userInput</span><span class="Operator">.</span><span class="Identifier">removePrefix</span>
    2150. 

  2150. <span class="Identifier">doAssert</span> <span class="Identifier">userInput</span> <span class="Operator">==</span> <span class="StringLit">&quot;*~Hello World!&quot;</span>
    2151. 

  2151. <span class="Identifier">userInput</span><span class="Operator">.</span><span class="Identifier">removePrefix</span><span class="Punctuation">(</span><span class="Punctuation">{</span><span class="Punctuation">'</span><span class="Operator">~</span><span class="CharLit">', '</span><span class="Operator">*</span><span class="CharLit">'})</span>
    2152. 

  2152. <span class="Identifier">doAssert</span> <span class="Identifier">userInput</span> <span class="Operator">==</span> <span class="StringLit">&quot;Hello World!&quot;</span>
    2153. 

  2153. 

  2154. <span class="Keyword">var</span> <span class="Identifier">otherInput</span> <span class="Operator">=</span> <span class="StringLit">&quot;?!?Hello!?!&quot;</span>
    2155. 

  2155. <span class="Identifier">otherInput</span><span class="Operator">.</span><span class="Identifier">removePrefix</span><span class="Punctuation">(</span><span class="Punctuation">{</span><span class="Punctuation">'</span><span class="Operator">!</span><span class="CharLit">', '</span><span class="Operator">?</span><span class="CharLit">'})</span>
    2156. 

  2156. <span class="Identifier">doAssert</span> <span class="Identifier">otherInput</span> <span class="Operator">==</span> <span class="StringLit">&quot;Hello!?!&quot;</span></pre>
    2157. 

  2157.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1700" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2158. 

  2158. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1700" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2159. 

  2159. 

  2160.   </dd>
    2161. 

  2161. </div>
    2162. 

  2162. <div id="removePrefix,string,string">
    2163. 

  2163.   <dt><pre><span class="Keyword">func</span> <a href="#removePrefix%2Cstring%2Cstring"><span class="Identifier">removePrefix</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">prefix</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2164. 

  2164.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuRemovePrefixString&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2165. 

  2165.   <dd>
    2166. 

  2166.     
    2167. 

  2167.     <p>Remove the first matching prefix (in-place) from a string.</p>
    2168. 

  2168. <p>See also:</p>
    2169. 

  2169. <ul class="simple"><li><a class="reference external" href="#removeSuffix,string,string">removeSuffix func</a></li>
    2170. 

  2170. <li><a class="reference external" href="#startsWith,string,string">startsWith func</a></li>
    2171. 

  2171. </ul>
    2172. 

  2172. 

  2173. <p><strong class="examples_text">Example:</strong></p>
    2174. 

  2174. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">answers</span> <span class="Operator">=</span> <span class="StringLit">&quot;yesyes&quot;</span>
    2175. 

  2175. <span class="Identifier">answers</span><span class="Operator">.</span><span class="Identifier">removePrefix</span><span class="Punctuation">(</span><span class="StringLit">&quot;yes&quot;</span><span class="Punctuation">)</span>
    2176. 

  2176. <span class="Identifier">doAssert</span> <span class="Identifier">answers</span> <span class="Operator">==</span> <span class="StringLit">&quot;yes&quot;</span></pre>
    2177. 

  2177.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1736" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2178. 

  2178. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1736" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2179. 

  2179. 

  2180.   </dd>
    2181. 

  2181. </div>
    2182. 

  2182. 

  2183. </div>
    2184. 

  2184. <div id="removeSuffix-procs-all">
    2185. 

  2185.   <div id="removeSuffix,string,char">
    2186. 

  2186.   <dt><pre><span class="Keyword">func</span> <a href="#removeSuffix%2Cstring%2Cchar"><span class="Identifier">removeSuffix</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">c</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2187. 

  2187.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuRemoveSuffixChar&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2188. 

  2188.   <dd>
    2189. 

  2189.     
    2190. 

  2190.     <p>Removes all occurrences of a single character (in-place) from the end of a string.</p>
    2191. 

  2191. <p>See also:</p>
    2192. 

  2192. <ul class="simple"><li><a class="reference external" href="#removePrefix,string,char">removePrefix func</a></li>
    2193. 

  2193. <li><a class="reference external" href="#endsWith,string,char">endsWith func</a></li>
    2194. 

  2194. </ul>
    2195. 

  2195. 

  2196. <p><strong class="examples_text">Example:</strong></p>
    2197. 

  2197. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">table</span> <span class="Operator">=</span> <span class="StringLit">&quot;users&quot;</span>
    2198. 

  2198. <span class="Identifier">table</span><span class="Operator">.</span><span class="Identifier">removeSuffix</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">s</span><span class="CharLit">')</span>
    2199. 

  2199. <span class="Identifier">doAssert</span> <span class="Identifier">table</span> <span class="Operator">==</span> <span class="StringLit">&quot;user&quot;</span>
    2200. 

  2200. 

  2201. <span class="Keyword">var</span> <span class="Identifier">dots</span> <span class="Operator">=</span> <span class="StringLit">&quot;Trailing dots.......&quot;</span>
    2202. 

  2202. <span class="Identifier">dots</span><span class="Operator">.</span><span class="Identifier">removeSuffix</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Operator">.</span><span class="CharLit">')</span>
    2203. 

  2203. <span class="Identifier">doAssert</span> <span class="Identifier">dots</span> <span class="Operator">==</span> <span class="StringLit">&quot;Trailing dots&quot;</span></pre>
    2204. 

  2204.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1773" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2205. 

  2205. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1773" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2206. 

  2206. 

  2207.   </dd>
    2208. 

  2208. </div>
    2209. 

  2209. <div id="removeSuffix,string,set[char]">
    2210. 

  2210.   <dt><pre><span class="Keyword">func</span> <a href="#removeSuffix%2Cstring%2Cset%5Bchar%5D"><span class="Identifier">removeSuffix</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">chars</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">]</span> <span class="Other">=</span> <span class="Identifier">Newlines</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2211. 

  2211.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuRemoveSuffixCharSet&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2212. 

  2212.   <dd>
    2213. 

  2213.     
    2214. 

  2214.     <p>Removes all characters from <tt class="docutils literal"><span class="pre"><span class="Identifier">chars</span></span></tt> from the end of the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> (in-place).</p>
    2215. 

  2215. <p>See also:</p>
    2216. 

  2216. <ul class="simple"><li><a class="reference external" href="#removePrefix,string,set[char]">removePrefix func</a></li>
    2217. 

  2217. </ul>
    2218. 

  2218. 

  2219. <p><strong class="examples_text">Example:</strong></p>
    2220. 

  2220. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">userInput</span> <span class="Operator">=</span> <span class="StringLit">&quot;Hello World!*~</span><span class="EscapeSequence">\r</span><span class="EscapeSequence">\n</span><span class="StringLit">&quot;</span>
    2221. 

  2221. <span class="Identifier">userInput</span><span class="Operator">.</span><span class="Identifier">removeSuffix</span>
    2222. 

  2222. <span class="Identifier">doAssert</span> <span class="Identifier">userInput</span> <span class="Operator">==</span> <span class="StringLit">&quot;Hello World!*~&quot;</span>
    2223. 

  2223. <span class="Identifier">userInput</span><span class="Operator">.</span><span class="Identifier">removeSuffix</span><span class="Punctuation">(</span><span class="Punctuation">{</span><span class="Punctuation">'</span><span class="Operator">~</span><span class="CharLit">', '</span><span class="Operator">*</span><span class="CharLit">'})</span>
    2224. 

  2224. <span class="Identifier">doAssert</span> <span class="Identifier">userInput</span> <span class="Operator">==</span> <span class="StringLit">&quot;Hello World!&quot;</span>
    2225. 

  2225. 

  2226. <span class="Keyword">var</span> <span class="Identifier">otherInput</span> <span class="Operator">=</span> <span class="StringLit">&quot;Hello!?!&quot;</span>
    2227. 

  2227. <span class="Identifier">otherInput</span><span class="Operator">.</span><span class="Identifier">removeSuffix</span><span class="Punctuation">(</span><span class="Punctuation">{</span><span class="Punctuation">'</span><span class="Operator">!</span><span class="CharLit">', '</span><span class="Operator">?</span><span class="CharLit">'})</span>
    2228. 

  2228. <span class="Identifier">doAssert</span> <span class="Identifier">otherInput</span> <span class="Operator">==</span> <span class="StringLit">&quot;Hello&quot;</span></pre>
    2229. 

  2229.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1750" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2230. 

  2230. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1750" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2231. 

  2231. 

  2232.   </dd>
    2233. 

  2233. </div>
    2234. 

  2234. <div id="removeSuffix,string,string">
    2235. 

  2235.   <dt><pre><span class="Keyword">func</span> <a href="#removeSuffix%2Cstring%2Cstring"><span class="Identifier">removeSuffix</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">suffix</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2236. 

  2236.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuRemoveSuffixString&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2237. 

  2237.   <dd>
    2238. 

  2238.     
    2239. 

  2239.     <p>Remove the first matching suffix (in-place) from a string.</p>
    2240. 

  2240. <p>See also:</p>
    2241. 

  2241. <ul class="simple"><li><a class="reference external" href="#removePrefix,string,string">removePrefix func</a></li>
    2242. 

  2242. <li><a class="reference external" href="#endsWith,string,string">endsWith func</a></li>
    2243. 

  2243. </ul>
    2244. 

  2244. 

  2245. <p><strong class="examples_text">Example:</strong></p>
    2246. 

  2246. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">answers</span> <span class="Operator">=</span> <span class="StringLit">&quot;yeses&quot;</span>
    2247. 

  2247. <span class="Identifier">answers</span><span class="Operator">.</span><span class="Identifier">removeSuffix</span><span class="Punctuation">(</span><span class="StringLit">&quot;es&quot;</span><span class="Punctuation">)</span>
    2248. 

  2248. <span class="Identifier">doAssert</span> <span class="Identifier">answers</span> <span class="Operator">==</span> <span class="StringLit">&quot;yes&quot;</span></pre>
    2249. 

  2249.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1792" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2250. 

  2250. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1792" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2251. 

  2251. 

  2252.   </dd>
    2253. 

  2253. </div>
    2254. 

  2254. 

  2255. </div>
    2256. 

  2256. <div id="repeat-procs-all">
    2257. 

  2257.   <div id="repeat,char,Natural">
    2258. 

  2258.   <dt><pre><span class="Keyword">func</span> <a href="#repeat%2Cchar%2CNatural"><span class="Identifier">repeat</span></a><span class="Other">(</span><span class="Identifier">c</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">;</span> <span class="Identifier">count</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuRepeatChar&quot;</span><span class="Other">,</span>
    2259. 

  2259.     <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2260. 

  2260.   <dd>
    2261. 

  2261.     
    2262. 

  2262.     Returns a string of length <tt class="docutils literal"><span class="pre"><span class="Identifier">count</span></span></tt> consisting only of the character <tt class="docutils literal"><span class="pre"><span class="Identifier">c</span></span></tt>.
    2263. 

  2263. <p><strong class="examples_text">Example:</strong></p>
    2264. 

  2264. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="CharLit">'z'</span>
    2265. 

  2265. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">repeat</span><span class="Punctuation">(</span><span class="DecNumber">5</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;zzzzz&quot;</span></pre>
    2266. 

  2266.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1344" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2267. 

  2267. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1344" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2268. 

  2268. 

  2269.   </dd>
    2270. 

  2270. </div>
    2271. 

  2271. <div id="repeat,string,Natural">
    2272. 

  2272.   <dt><pre><span class="Keyword">func</span> <a href="#repeat%2Cstring%2CNatural"><span class="Identifier">repeat</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuRepeatStr&quot;</span><span class="Other">,</span>
    2273. 

  2273.     <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2274. 

  2274.   <dd>
    2275. 

  2275.     
    2276. 

  2276.     Returns string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> concatenated <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> times.
    2277. 

  2277. <p><strong class="examples_text">Example:</strong></p>
    2278. 

  2278. <pre class="listing"><span class="Identifier">doAssert</span> <span class="StringLit">&quot;+ foo +&quot;</span><span class="Operator">.</span><span class="Identifier">repeat</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;+ foo ++ foo ++ foo +&quot;</span></pre>
    2279. 

  2279.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1353" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2280. 

  2280. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1353" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2281. 

  2281. 

  2282.   </dd>
    2283. 

  2283. </div>
    2284. 

  2284. 

  2285. </div>
    2286. 

  2286. <div id="replace-procs-all">
    2287. 

  2287.   <div id="replace,string,string,string">
    2288. 

  2288.   <dt><pre><span class="Keyword">func</span> <a href="#replace%2Cstring%2Cstring%2Cstring"><span class="Identifier">replace</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">,</span> <span class="Identifier">sub</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">by</span> <span class="Other">=</span> <span class="StringLit">&quot;&quot;</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuReplaceStr&quot;</span><span class="Other">,</span>
    2289. 

  2289.     <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2290. 

  2290.   <dd>
    2291. 

  2291.     
    2292. 

  2292.     <p>Replaces every occurrence of the string <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> with the string <tt class="docutils literal"><span class="pre"><span class="Identifier">by</span></span></tt>.</p>
    2293. 

  2293. <p>See also:</p>
    2294. 

  2294. <ul class="simple"><li><a class="reference external" href="#find,string,string,Natural,int">find func</a></li>
    2295. 

  2295. <li><a class="reference external" href="#replace,string,char,char">replace func</a> for replacing single characters</li>
    2296. 

  2296. <li><a class="reference external" href="#replaceWord,string,string,string">replaceWord func</a></li>
    2297. 

  2297. <li><a class="reference external" href="#multiReplace,string,varargs[]">multiReplace func</a></li>
    2298. 

  2298. </ul>
    2299. 

  2299. 

  2300.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2196" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2301. 

  2301. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2196" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2302. 

  2302. 

  2303.   </dd>
    2304. 

  2304. </div>
    2305. 

  2305. <div id="replace,string,char,char">
    2306. 

  2306.   <dt><pre><span class="Keyword">func</span> <a href="#replace%2Cstring%2Cchar%2Cchar"><span class="Identifier">replace</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sub</span><span class="Other">,</span> <span class="Identifier">by</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2307. 

  2307.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuReplaceChar&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2308. 

  2308.   <dd>
    2309. 

  2309.     
    2310. 

  2310.     <p>Replaces every occurrence of the character <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> with the character <tt class="docutils literal"><span class="pre"><span class="Identifier">by</span></span></tt>.</p>
    2311. 

  2311. <p>Optimized version of <a class="reference external" href="#replace,string,string,string">replace</a> for characters.</p>
    2312. 

  2312. <p>See also:</p>
    2313. 

  2313. <ul class="simple"><li><a class="reference external" href="#find,string,char,Natural,int">find func</a></li>
    2314. 

  2314. <li><a class="reference external" href="#replaceWord,string,string,string">replaceWord func</a></li>
    2315. 

  2315. <li><a class="reference external" href="#multiReplace,string,varargs[]">multiReplace func</a></li>
    2316. 

  2316. </ul>
    2317. 

  2317. 

  2318.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2237" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2319. 

  2319. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2237" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2320. 

  2320. 

  2321.   </dd>
    2322. 

  2322. </div>
    2323. 

  2323. 

  2324. </div>
    2325. 

  2325. <div id="replaceWord-procs-all">
    2326. 

  2326.   <div id="replaceWord,string,string,string">
    2327. 

  2327.   <dt><pre><span class="Keyword">func</span> <a href="#replaceWord%2Cstring%2Cstring%2Cstring"><span class="Identifier">replaceWord</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">,</span> <span class="Identifier">sub</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">by</span> <span class="Other">=</span> <span class="StringLit">&quot;&quot;</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2328. 

  2328.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuReplaceWord&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2329. 

  2329.   <dd>
    2330. 

  2330.     
    2331. 

  2331.     <p>Replaces every occurrence of the string <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> with the string <tt class="docutils literal"><span class="pre"><span class="Identifier">by</span></span></tt>.</p>
    2332. 

  2332. <p>Each occurrence of <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> has to be surrounded by word boundaries (comparable to <tt class="docutils literal"><span class="pre"><span class="Operator">\</span><span class="Identifier">b</span></span></tt> in regular expressions), otherwise it is not replaced.</p>
    2333. 

  2333. 

  2334.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2256" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2335. 

  2335. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2256" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2336. 

  2336. 

  2337.   </dd>
    2338. 

  2338. </div>
    2339. 

  2339. 

  2340. </div>
    2341. 

  2341. <div id="rfind-procs-all">
    2342. 

  2342.   <div id="rfind,string,string,Natural,int">
    2343. 

  2343.   <dt><pre><span class="Keyword">func</span> <a href="#rfind%2Cstring%2Cstring%2CNatural%2Cint"><span class="Identifier">rfind</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">,</span> <span class="Identifier">sub</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">start</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">last</span> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2344. 

  2344.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuRFindStr&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2345. 

  2345.   <dd>
    2346. 

  2346.     
    2347. 

  2347.     <p>Searches for <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> inside range <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span><span class="Operator">..</span><span class="Identifier">last</span></span></tt> (both ends included) included) in reverse -- starting at high indexes and moving lower to the first character or <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>. If <tt class="docutils literal"><span class="pre"><span class="Identifier">last</span></span></tt> is unspecified, it defaults to <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">high</span></span></tt> (the last element).</p>
    2348. 

  2348. <p>Searching is case-sensitive. If <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> is not in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>, -1 is returned. Otherwise the index returned is relative to <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Punctuation">[</span><span class="DecNumber">0</span><span class="Punctuation">]</span></span></tt>, not <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>. Subtract <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt> from the result for a <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>-origin index.</p>
    2349. 

  2349. <p>See also:</p>
    2350. 

  2350. <ul class="simple"><li><a class="reference external" href="#find,string,string,Natural,int">find func</a></li>
    2351. 

  2351. </ul>
    2352. 

  2352. 

  2353.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2087" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2354. 

  2354. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2087" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2355. 

  2355. 

  2356.   </dd>
    2357. 

  2357. </div>
    2358. 

  2358. <div id="rfind,string,set[char],Natural,int">
    2359. 

  2359.   <dt><pre><span class="Keyword">func</span> <a href="#rfind%2Cstring%2Cset%5Bchar%5D%2CNatural%2Cint"><span class="Identifier">rfind</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">chars</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">start</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">last</span> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.
    2360. 

  2360.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuRFindCharSet&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2361. 

  2361.   <dd>
    2362. 

  2362.     
    2363. 

  2363.     <p>Searches for <tt class="docutils literal"><span class="pre"><span class="Identifier">chars</span></span></tt> in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> inside range <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span><span class="Operator">..</span><span class="Identifier">last</span></span></tt> (both ends included) in reverse -- starting at high indexes and moving lower to the first character or <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>. If <tt class="docutils literal"><span class="pre"><span class="Identifier">last</span></span></tt> is unspecified, it defaults to <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">high</span></span></tt> (the last element).</p>
    2364. 

  2364. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> contains none of the characters in <tt class="docutils literal"><span class="pre"><span class="Identifier">chars</span></span></tt>, -1 is returned. Otherwise the index returned is relative to <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Punctuation">[</span><span class="DecNumber">0</span><span class="Punctuation">]</span></span></tt>, not <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>. Subtract <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt> from the result for a <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>-origin index.</p>
    2365. 

  2365. <p>See also:</p>
    2366. 

  2366. <ul class="simple"><li><a class="reference external" href="#find,string,set[char],Natural,int">find func</a></li>
    2367. 

  2367. </ul>
    2368. 

  2368. 

  2369.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2069" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2370. 

  2370. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2069" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2371. 

  2371. 

  2372.   </dd>
    2373. 

  2373. </div>
    2374. 

  2374. <div id="rfind,string,char,Natural,int">
    2375. 

  2375.   <dt><pre><span class="Keyword">func</span> <a href="#rfind%2Cstring%2Cchar%2CNatural%2Cint"><span class="Identifier">rfind</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sub</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">;</span> <span class="Identifier">start</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">last</span> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2376. 

  2376.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuRFindChar&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2377. 

  2377.   <dd>
    2378. 

  2378.     
    2379. 

  2379.     <p>Searches for <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> inside range <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span><span class="Operator">..</span><span class="Identifier">last</span></span></tt> (both ends included) in reverse -- starting at high indexes and moving lower to the first character or <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>.  If <tt class="docutils literal"><span class="pre"><span class="Identifier">last</span></span></tt> is unspecified, it defaults to <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">high</span></span></tt> (the last element).</p>
    2380. 

  2380. <p>Searching is case-sensitive. If <tt class="docutils literal"><span class="pre"><span class="Identifier">sub</span></span></tt> is not in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>, -1 is returned. Otherwise the index returned is relative to <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span><span class="Punctuation">[</span><span class="DecNumber">0</span><span class="Punctuation">]</span></span></tt>, not <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>. Subtract <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt> from the result for a <tt class="docutils literal"><span class="pre"><span class="Identifier">start</span></span></tt>-origin index.</p>
    2381. 

  2381. <p>See also:</p>
    2382. 

  2382. <ul class="simple"><li><a class="reference external" href="#find,string,char,Natural,int">find func</a></li>
    2383. 

  2383. </ul>
    2384. 

  2384. 

  2385.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2051" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2386. 

  2386. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2051" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2387. 

  2387. 

  2388.   </dd>
    2389. 

  2389. </div>
    2390. 

  2390. 

  2391. </div>
    2392. 

  2392. <div id="rsplit-procs-all">
    2393. 

  2393.   <div id="rsplit,string,char,int">
    2394. 

  2394.   <dt><pre><span class="Keyword">func</span> <a href="#rsplit%2Cstring%2Cchar%2Cint"><span class="Identifier">rsplit</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sep</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">;</span> <span class="Identifier">maxsplit</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#seq"><span class="Identifier">seq</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2395. 

  2395.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuRSplitChar&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2396. 

  2396.   <dd>
    2397. 

  2397.     
    2398. 

  2398.     <p>The same as the <a class="reference external" href="#rsplit.i,string,char,int">rsplit iterator</a>, but is a func that returns a sequence of substrings in original order.</p>
    2399. 

  2399. <p>A possible common use case for <tt class="docutils literal"><span class="pre"><span class="Identifier">rsplit</span></span></tt> is path manipulation, particularly on systems that don't use a common delimiter.</p>
    2400. 

  2400. <p>For example, if a system had <tt class="docutils literal"><span class="pre"><span class="Comment">#</span></span></tt> as a delimiter, you could do the following to get the tail of the path:</p>
    2401. 

  2401. <p><pre class="listing"><span class="Keyword">var</span> <span class="Identifier">tailSplit</span> <span class="Operator">=</span> <span class="Identifier">rsplit</span><span class="Punctuation">(</span><span class="StringLit">&quot;Root#Object#Method#Index&quot;</span><span class="Punctuation">,</span> <span class="CharLit">'#'</span><span class="Punctuation">,</span> <span class="Identifier">maxsplit</span><span class="Operator">=</span><span class="DecNumber">1</span><span class="Punctuation">)</span></pre></p>
    2402. 

  2402. <p>Results in <tt class="docutils literal"><span class="pre"><span class="Identifier">tailSplit</span></span></tt> containing:</p>
    2403. 

  2403. <p><pre class="listing"><span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;Root#Object#Method&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;Index&quot;</span><span class="Punctuation">]</span></pre></p>
    2404. 

  2404. <p>See also:</p>
    2405. 

  2405. <ul class="simple"><li><a class="reference external" href="#rsplit.i,string,char,int">rsplit iterator</a></li>
    2406. 

  2406. <li><a class="reference external" href="#split,string,char,int">split func</a></li>
    2407. 

  2407. <li><a class="reference external" href="#splitLines,string">splitLines func</a></li>
    2408. 

  2408. <li><a class="reference external" href="#splitWhitespace,string,int">splitWhitespace func</a></li>
    2409. 

  2409. </ul>
    2410. 

  2410. 

  2411.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L805" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2412. 

  2412. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L805" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2413. 

  2413. 

  2414.   </dd>
    2415. 

  2415. </div>
    2416. 

  2416. <div id="rsplit,string,string,int">
    2417. 

  2417.   <dt><pre><span class="Keyword">func</span> <a href="#rsplit%2Cstring%2Cstring%2Cint"><span class="Identifier">rsplit</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sep</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">maxsplit</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#seq"><span class="Identifier">seq</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2418. 

  2418.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuRSplitString&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2419. 

  2419.   <dd>
    2420. 

  2420.     
    2421. 

  2421.     <p>The same as the <a class="reference external" href="#rsplit.i,string,string,int,bool">rsplit iterator</a>, but is a func that returns a sequence of substrings in original order.</p>
    2422. 

  2422. <p>A possible common use case for <tt class="docutils literal"><span class="pre"><span class="Identifier">rsplit</span></span></tt> is path manipulation, particularly on systems that don't use a common delimiter.</p>
    2423. 

  2423. <p>For example, if a system had <tt class="docutils literal"><span class="pre"><span class="Comment">#</span></span></tt> as a delimiter, you could do the following to get the tail of the path:</p>
    2424. 

  2424. <p><pre class="listing"><span class="Keyword">var</span> <span class="Identifier">tailSplit</span> <span class="Operator">=</span> <span class="Identifier">rsplit</span><span class="Punctuation">(</span><span class="StringLit">&quot;Root#Object#Method#Index&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;#&quot;</span><span class="Punctuation">,</span> <span class="Identifier">maxsplit</span><span class="Operator">=</span><span class="DecNumber">1</span><span class="Punctuation">)</span></pre></p>
    2425. 

  2425. <p>Results in <tt class="docutils literal"><span class="pre"><span class="Identifier">tailSplit</span></span></tt> containing:</p>
    2426. 

  2426. <p><pre class="listing"><span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;Root#Object#Method&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;Index&quot;</span><span class="Punctuation">]</span></pre></p>
    2427. 

  2427. <div class="admonition admonition-info"><span class="admonition-info-text"><b>Note:</b></span>
    2428. 

  2428. Empty separator string results in returning an original string, following the interpretation &quot;split by no element&quot;.</div>
    2429. 

  2429. <p>See also:</p>
    2430. 

  2430. <ul class="simple"><li><a class="reference external" href="#rsplit.i,string,string,int,bool">rsplit iterator</a></li>
    2431. 

  2431. <li><a class="reference external" href="#split,string,string,int">split func</a></li>
    2432. 

  2432. <li><a class="reference external" href="#splitLines,string">splitLines func</a></li>
    2433. 

  2433. <li><a class="reference external" href="#splitWhitespace,string,int">splitWhitespace func</a></li>
    2434. 

  2434. </ul>
    2435. 

  2435. 

  2436. <p><strong class="examples_text">Example:</strong></p>
    2437. 

  2437. <pre class="listing"><span class="Identifier">doAssert</span> <span class="StringLit">&quot;a  largely    spaced sentence&quot;</span><span class="Operator">.</span><span class="Identifier">rsplit</span><span class="Punctuation">(</span><span class="StringLit">&quot; &quot;</span><span class="Punctuation">,</span> <span class="Identifier">maxsplit</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span>
    2438. 

  2438.     <span class="StringLit">&quot;a  largely    spaced&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;sentence&quot;</span><span class="Punctuation">]</span>
    2439. 

  2439. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;a,b,c&quot;</span><span class="Operator">.</span><span class="Identifier">rsplit</span><span class="Punctuation">(</span><span class="StringLit">&quot;,&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;b&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;c&quot;</span><span class="Punctuation">]</span>
    2440. 

  2440. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;a man a plan a canal panama&quot;</span><span class="Operator">.</span><span class="Identifier">rsplit</span><span class="Punctuation">(</span><span class="StringLit">&quot;a &quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;man &quot;</span><span class="Punctuation">,</span>
    2441. 

  2441.     <span class="StringLit">&quot;plan &quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;canal panama&quot;</span><span class="Punctuation">]</span>
    2442. 

  2442. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;&quot;</span><span class="Operator">.</span><span class="Identifier">rsplit</span><span class="Punctuation">(</span><span class="StringLit">&quot;Elon Musk&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;&quot;</span><span class="Punctuation">]</span>
    2443. 

  2443. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;a  largely    spaced sentence&quot;</span><span class="Operator">.</span><span class="Identifier">rsplit</span><span class="Punctuation">(</span><span class="StringLit">&quot; &quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;&quot;</span><span class="Punctuation">,</span>
    2444. 

  2444.     <span class="StringLit">&quot;largely&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;spaced&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;sentence&quot;</span><span class="Punctuation">]</span>
    2445. 

  2445. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;empty sep returns unsplit s&quot;</span><span class="Operator">.</span><span class="Identifier">rsplit</span><span class="Punctuation">(</span><span class="StringLit">&quot;&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;empty sep returns unsplit s&quot;</span><span class="Punctuation">]</span></pre>
    2446. 

  2446.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L867" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2447. 

  2447. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L867" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2448. 

  2448. 

  2449.   </dd>
    2450. 

  2450. </div>
    2451. 

  2451. <div id="rsplit,string,set[char],int">
    2452. 

  2452.   <dt><pre><span class="Keyword">func</span> <a href="#rsplit%2Cstring%2Cset%5Bchar%5D%2Cint"><span class="Identifier">rsplit</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">seps</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">]</span> <span class="Other">=</span> <span class="Identifier">Whitespace</span><span class="Other">;</span> <span class="Identifier">maxsplit</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#seq"><span class="Identifier">seq</span></a><span class="Other">[</span>
    2453. 

  2453.     <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuRSplitCharSet&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2454. 

  2454.               <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2455. 

  2455.   <dd>
    2456. 

  2456.     
    2457. 

  2457.     <p>The same as the <a class="reference external" href="#rsplit.i,string,set[char],int">rsplit iterator</a>, but is a func that returns a sequence of substrings in original order.</p>
    2458. 

  2458. <p>A possible common use case for <tt class="docutils literal"><span class="pre"><span class="Identifier">rsplit</span></span></tt> is path manipulation, particularly on systems that don't use a common delimiter.</p>
    2459. 

  2459. <p>For example, if a system had <tt class="docutils literal"><span class="pre"><span class="Comment">#</span></span></tt> as a delimiter, you could do the following to get the tail of the path:</p>
    2460. 

  2460. <p><pre class="listing"><span class="Keyword">var</span> <span class="Identifier">tailSplit</span> <span class="Operator">=</span> <span class="Identifier">rsplit</span><span class="Punctuation">(</span><span class="StringLit">&quot;Root#Object#Method#Index&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">{</span><span class="Punctuation">'</span><span class="Comment">#'}, maxsplit=1)</span></pre></p>
    2461. 

  2461. <p>Results in <tt class="docutils literal"><span class="pre"><span class="Identifier">tailSplit</span></span></tt> containing:</p>
    2462. 

  2462. <p><pre class="listing"><span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;Root#Object#Method&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;Index&quot;</span><span class="Punctuation">]</span></pre></p>
    2463. 

  2463. <div class="admonition admonition-info"><span class="admonition-info-text"><b>Note:</b></span>
    2464. 

  2464. Empty separator set results in returning an original string, following the interpretation &quot;split by no element&quot;.</div>
    2465. 

  2465. <p>See also:</p>
    2466. 

  2466. <ul class="simple"><li><a class="reference external" href="#rsplit.i,string,set[char],int">rsplit iterator</a></li>
    2467. 

  2467. <li><a class="reference external" href="#split,string,set[char],int">split func</a></li>
    2468. 

  2468. <li><a class="reference external" href="#splitLines,string">splitLines func</a></li>
    2469. 

  2469. <li><a class="reference external" href="#splitWhitespace,string,int">splitWhitespace func</a></li>
    2470. 

  2470. </ul>
    2471. 

  2471. 

  2472.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L834" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2473. 

  2473. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L834" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2474. 

  2474. 

  2475.   </dd>
    2476. 

  2476. </div>
    2477. 

  2477. 

  2478. </div>
    2479. 

  2479. <div id="spaces-procs-all">
    2480. 

  2480.   <div id="spaces,Natural">
    2481. 

  2481.   <dt><pre><span class="Keyword">func</span> <a href="#spaces%2CNatural"><span class="Identifier">spaces</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2482. 

  2482.   <dd>
    2483. 

  2483.     
    2484. 

  2484.     <p>Returns a string with <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> space characters. You can use this func to left align strings.</p>
    2485. 

  2485. <p>See also:</p>
    2486. 

  2486. <ul class="simple"><li><a class="reference external" href="#align,string,Natural,char">align func</a></li>
    2487. 

  2487. <li><a class="reference external" href="#alignLeft,string,Natural,char">alignLeft func</a></li>
    2488. 

  2488. <li><a class="reference external" href="#indent,string,Natural,string">indent func</a></li>
    2489. 

  2489. <li><a class="reference external" href="#center,string,int,char">center func</a></li>
    2490. 

  2490. </ul>
    2491. 

  2491. 

  2492. <p><strong class="examples_text">Example:</strong></p>
    2493. 

  2493. <pre class="listing"><span class="Keyword">let</span>
    2494. 

  2494.   <span class="Identifier">width</span> <span class="Operator">=</span> <span class="DecNumber">15</span>
    2495. 

  2495.   <span class="Identifier">text1</span> <span class="Operator">=</span> <span class="StringLit">&quot;Hello user!&quot;</span>
    2496. 

  2496.   <span class="Identifier">text2</span> <span class="Operator">=</span> <span class="StringLit">&quot;This is a very long string&quot;</span>
    2497. 

  2497. <span class="Identifier">doAssert</span> <span class="Identifier">text1</span> <span class="Operator">&amp;</span> <span class="Identifier">spaces</span><span class="Punctuation">(</span><span class="Identifier">max</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="Identifier">width</span> <span class="Operator">-</span> <span class="Identifier">text1</span><span class="Operator">.</span><span class="Identifier">len</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">&amp;</span> <span class="StringLit">&quot;|&quot;</span> <span class="Operator">==</span>
    2498. 

  2498.          <span class="StringLit">&quot;Hello user!    |&quot;</span>
    2499. 

  2499. <span class="Identifier">doAssert</span> <span class="Identifier">text2</span> <span class="Operator">&amp;</span> <span class="Identifier">spaces</span><span class="Punctuation">(</span><span class="Identifier">max</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="Identifier">width</span> <span class="Operator">-</span> <span class="Identifier">text2</span><span class="Operator">.</span><span class="Identifier">len</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">&amp;</span> <span class="StringLit">&quot;|&quot;</span> <span class="Operator">==</span>
    2500. 

  2500.          <span class="StringLit">&quot;This is a very long string|&quot;</span></pre>
    2501. 

  2501.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1361" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2502. 

  2502. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1361" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2503. 

  2503. 

  2504.   </dd>
    2505. 

  2505. </div>
    2506. 

  2506. 

  2507. </div>
    2508. 

  2508. <div id="split-procs-all">
    2509. 

  2509.   <div id="split,string,char,int">
    2510. 

  2510.   <dt><pre><span class="Keyword">func</span> <a href="#split%2Cstring%2Cchar%2Cint"><span class="Identifier">split</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sep</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">;</span> <span class="Identifier">maxsplit</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#seq"><span class="Identifier">seq</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2511. 

  2511.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuSplitChar&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2512. 

  2512.   <dd>
    2513. 

  2513.     
    2514. 

  2514.     <p>The same as the <a class="reference external" href="#split.i,string,char,int">split iterator</a> (see its documentation), but is a func that returns a sequence of substrings.</p>
    2515. 

  2515. <p>See also:</p>
    2516. 

  2516. <ul class="simple"><li><a class="reference external" href="#split.i,string,char,int">split iterator</a></li>
    2517. 

  2517. <li><a class="reference external" href="#rsplit,string,char,int">rsplit func</a></li>
    2518. 

  2518. <li><a class="reference external" href="#splitLines,string">splitLines func</a></li>
    2519. 

  2519. <li><a class="reference external" href="#splitWhitespace,string,int">splitWhitespace func</a></li>
    2520. 

  2520. </ul>
    2521. 

  2521. 

  2522. <p><strong class="examples_text">Example:</strong></p>
    2523. 

  2523. <pre class="listing"><span class="Identifier">doAssert</span> <span class="StringLit">&quot;a,b,c&quot;</span><span class="Operator">.</span><span class="Identifier">split</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Punctuation">,</span><span class="Punctuation">'</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;b&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;c&quot;</span><span class="Punctuation">]</span>
    2524. 

  2524. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;&quot;</span><span class="Operator">.</span><span class="Identifier">split</span><span class="Punctuation">(</span><span class="Punctuation">'</span> <span class="CharLit">') == @[&quot;&quot;]</span></pre>
    2525. 

  2525.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L746" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2526. 

  2526. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L746" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2527. 

  2527. 

  2528.   </dd>
    2529. 

  2529. </div>
    2530. 

  2530. <div id="split,string,string,int">
    2531. 

  2531.   <dt><pre><span class="Keyword">func</span> <a href="#split%2Cstring%2Cstring%2Cint"><span class="Identifier">split</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sep</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">maxsplit</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#seq"><span class="Identifier">seq</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2532. 

  2532.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuSplitString&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2533. 

  2533.   <dd>
    2534. 

  2534.     
    2535. 

  2535.     <p>Splits the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> into substrings using a string separator.</p>
    2536. 

  2536. <p>Substrings are separated by the string <tt class="docutils literal"><span class="pre"><span class="Identifier">sep</span></span></tt>. This is a wrapper around the <a class="reference external" href="#split.i,string,string,int">split iterator</a>.</p>
    2537. 

  2537. <div class="admonition admonition-info"><span class="admonition-info-text"><b>Note:</b></span>
    2538. 

  2538. Empty separator string results in returning an original string, following the interpretation &quot;split by no element&quot;.</div>
    2539. 

  2539. <p>See also:</p>
    2540. 

  2540. <ul class="simple"><li><a class="reference external" href="#split.i,string,string,int">split iterator</a></li>
    2541. 

  2541. <li><a class="reference external" href="#rsplit,string,string,int">rsplit func</a></li>
    2542. 

  2542. <li><a class="reference external" href="#splitLines,string">splitLines func</a></li>
    2543. 

  2543. <li><a class="reference external" href="#splitWhitespace,string,int">splitWhitespace func</a></li>
    2544. 

  2544. </ul>
    2545. 

  2545. 

  2546. <p><strong class="examples_text">Example:</strong></p>
    2547. 

  2547. <pre class="listing"><span class="Identifier">doAssert</span> <span class="StringLit">&quot;a,b,c&quot;</span><span class="Operator">.</span><span class="Identifier">split</span><span class="Punctuation">(</span><span class="StringLit">&quot;,&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;b&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;c&quot;</span><span class="Punctuation">]</span>
    2548. 

  2548. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;a man a plan a canal panama&quot;</span><span class="Operator">.</span><span class="Identifier">split</span><span class="Punctuation">(</span><span class="StringLit">&quot;a &quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;man &quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;plan &quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;canal panama&quot;</span><span class="Punctuation">]</span>
    2549. 

  2549. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;&quot;</span><span class="Operator">.</span><span class="Identifier">split</span><span class="Punctuation">(</span><span class="StringLit">&quot;Elon Musk&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;&quot;</span><span class="Punctuation">]</span>
    2550. 

  2550. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;a  largely    spaced sentence&quot;</span><span class="Operator">.</span><span class="Identifier">split</span><span class="Punctuation">(</span><span class="StringLit">&quot; &quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;largely&quot;</span><span class="Punctuation">,</span>
    2551. 

  2551.     <span class="StringLit">&quot;&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;spaced&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;sentence&quot;</span><span class="Punctuation">]</span>
    2552. 

  2552. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;a  largely    spaced sentence&quot;</span><span class="Operator">.</span><span class="Identifier">split</span><span class="Punctuation">(</span><span class="StringLit">&quot; &quot;</span><span class="Punctuation">,</span> <span class="Identifier">maxsplit</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot; largely    spaced sentence&quot;</span><span class="Punctuation">]</span>
    2553. 

  2553. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;empty sep returns unsplit s&quot;</span><span class="Operator">.</span><span class="Identifier">split</span><span class="Punctuation">(</span><span class="StringLit">&quot;&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;empty sep returns unsplit s&quot;</span><span class="Punctuation">]</span></pre>
    2554. 

  2554.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L780" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2555. 

  2555. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L780" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2556. 

  2556. 

  2557.   </dd>
    2558. 

  2558. </div>
    2559. 

  2559. <div id="split,string,set[char],int">
    2560. 

  2560.   <dt><pre><span class="Keyword">func</span> <a href="#split%2Cstring%2Cset%5Bchar%5D%2Cint"><span class="Identifier">split</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">seps</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">]</span> <span class="Other">=</span> <span class="Identifier">Whitespace</span><span class="Other">;</span> <span class="Identifier">maxsplit</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#seq"><span class="Identifier">seq</span></a><span class="Other">[</span>
    2561. 

  2561.     <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuSplitCharSet&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2562. 

  2562.               <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2563. 

  2563.   <dd>
    2564. 

  2564.     
    2565. 

  2565.     The same as the <a class="reference external" href="#split.i,string,set[char],int">split iterator</a> (see its documentation), but is a func that returns a sequence of substrings.<div class="admonition admonition-info"><span class="admonition-info-text"><b>Note:</b></span>
    2566. 

  2566. Empty separator set results in returning an original string, following the interpretation &quot;split by no element&quot;.</div>
    2567. 

  2567. <p>See also:</p>
    2568. 

  2568. <ul class="simple"><li><a class="reference external" href="#split.i,string,set[char],int">split iterator</a></li>
    2569. 

  2569. <li><a class="reference external" href="#rsplit,string,set[char],int">rsplit func</a></li>
    2570. 

  2570. <li><a class="reference external" href="#splitLines,string">splitLines func</a></li>
    2571. 

  2571. <li><a class="reference external" href="#splitWhitespace,string,int">splitWhitespace func</a></li>
    2572. 

  2572. </ul>
    2573. 

  2573. 

  2574. <p><strong class="examples_text">Example:</strong></p>
    2575. 

  2575. <pre class="listing"><span class="Identifier">doAssert</span> <span class="StringLit">&quot;a,b;c&quot;</span><span class="Operator">.</span><span class="Identifier">split</span><span class="Punctuation">(</span><span class="Punctuation">{</span><span class="Punctuation">'</span><span class="Punctuation">,</span><span class="Punctuation">'</span><span class="Punctuation">,</span> <span class="CharLit">';'</span><span class="Punctuation">}</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;b&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;c&quot;</span><span class="Punctuation">]</span>
    2576. 

  2576. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;&quot;</span><span class="Operator">.</span><span class="Identifier">split</span><span class="Punctuation">(</span><span class="Punctuation">{</span><span class="Punctuation">'</span> <span class="CharLit">'}) == @[&quot;&quot;]</span>
    2577. 

  2577. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;empty seps return unsplit s&quot;</span><span class="Operator">.</span><span class="Identifier">split</span><span class="Punctuation">(</span><span class="Punctuation">{</span><span class="Punctuation">}</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="StringLit">&quot;empty seps return unsplit s&quot;</span><span class="Punctuation">]</span></pre>
    2578. 

  2578.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L761" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2579. 

  2579. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L761" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2580. 

  2580. 

  2581.   </dd>
    2582. 

  2582. </div>
    2583. 

  2583. 

  2584. </div>
    2585. 

  2585. <div id="splitLines-procs-all">
    2586. 

  2586.   <div id="splitLines,string">
    2587. 

  2587.   <dt><pre><span class="Keyword">func</span> <a href="#splitLines%2Cstring"><span class="Identifier">splitLines</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">keepEol</span> <span class="Other">=</span> <span class="Identifier">false</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#seq"><span class="Identifier">seq</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2588. 

  2588.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuSplitLines&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2589. 

  2589.   <dd>
    2590. 

  2590.     
    2591. 

  2591.     <p>The same as the <a class="reference external" href="#splitLines.i,string">splitLines iterator</a> (see its documentation), but is a func that returns a sequence of substrings.</p>
    2592. 

  2592. <p>See also:</p>
    2593. 

  2593. <ul class="simple"><li><a class="reference external" href="#splitLines.i,string">splitLines iterator</a></li>
    2594. 

  2594. <li><a class="reference external" href="#splitWhitespace,string,int">splitWhitespace func</a></li>
    2595. 

  2595. <li><a class="reference external" href="#countLines,string">countLines func</a></li>
    2596. 

  2596. </ul>
    2597. 

  2597. 

  2598.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L909" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2599. 

  2599. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L909" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2600. 

  2600. 

  2601.   </dd>
    2602. 

  2602. </div>
    2603. 

  2603. 

  2604. </div>
    2605. 

  2605. <div id="splitWhitespace-procs-all">
    2606. 

  2606.   <div id="splitWhitespace,string,int">
    2607. 

  2607.   <dt><pre><span class="Keyword">func</span> <a href="#splitWhitespace%2Cstring%2Cint"><span class="Identifier">splitWhitespace</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">maxsplit</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#seq"><span class="Identifier">seq</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2608. 

  2608.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuSplitWhitespace&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2609. 

  2609.   <dd>
    2610. 

  2610.     
    2611. 

  2611.     <p>The same as the <a class="reference external" href="#splitWhitespace.i,string,int">splitWhitespace iterator</a> (see its documentation), but is a func that returns a sequence of substrings.</p>
    2612. 

  2612. <p>See also:</p>
    2613. 

  2613. <ul class="simple"><li><a class="reference external" href="#splitWhitespace.i,string,int">splitWhitespace iterator</a></li>
    2614. 

  2614. <li><a class="reference external" href="#splitLines,string">splitLines func</a></li>
    2615. 

  2615. </ul>
    2616. 

  2616. 

  2617.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L920" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2618. 

  2618. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L920" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2619. 

  2619. 

  2620.   </dd>
    2621. 

  2621. </div>
    2622. 

  2622. 

  2623. </div>
    2624. 

  2624. <div id="startsWith-procs-all">
    2625. 

  2625.   <div id="startsWith,string,string">
    2626. 

  2626.   <dt><pre><span class="Keyword">func</span> <a href="#startsWith%2Cstring%2Cstring"><span class="Identifier">startsWith</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">,</span> <span class="Identifier">prefix</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuStartsWith&quot;</span><span class="Other">,</span>
    2627. 

  2627.     <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2628. 

  2628.   <dd>
    2629. 

  2629.     
    2630. 

  2630.     <p>Returns true if <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> starts with string <tt class="docutils literal"><span class="pre"><span class="Identifier">prefix</span></span></tt>.</p>
    2631. 

  2631. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">prefix</span> <span class="Operator">==</span> <span class="StringLit">&quot;&quot;</span></span></tt> true is returned.</p>
    2632. 

  2632. <p>See also:</p>
    2633. 

  2633. <ul class="simple"><li><a class="reference external" href="#endsWith,string,string">endsWith func</a></li>
    2634. 

  2634. <li><a class="reference external" href="#continuesWith,string,string,Natural">continuesWith func</a></li>
    2635. 

  2635. <li><a class="reference external" href="#removePrefix,string,string">removePrefix func</a></li>
    2636. 

  2636. </ul>
    2637. 

  2637. 

  2638. <p><strong class="examples_text">Example:</strong></p>
    2639. 

  2639. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="StringLit">&quot;abracadabra&quot;</span>
    2640. 

  2640. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">startsWith</span><span class="Punctuation">(</span><span class="StringLit">&quot;abra&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">true</span>
    2641. 

  2641. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">startsWith</span><span class="Punctuation">(</span><span class="StringLit">&quot;bra&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">false</span></pre>
    2642. 

  2642.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1633" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2643. 

  2643. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1633" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2644. 

  2644. 

  2645.   </dd>
    2646. 

  2646. </div>
    2647. 

  2647. <div id="startsWith,string,char">
    2648. 

  2648.   <dt><pre><span class="Keyword">func</span> <a href="#startsWith%2Cstring%2Cchar"><span class="Identifier">startsWith</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">prefix</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2649. 

  2649.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2650. 

  2650.   <dd>
    2651. 

  2651.     
    2652. 

  2652.     <p>Returns true if <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> starts with character <tt class="docutils literal"><span class="pre"><span class="Identifier">prefix</span></span></tt>.</p>
    2653. 

  2653. <p>See also:</p>
    2654. 

  2654. <ul class="simple"><li><a class="reference external" href="#endsWith,string,char">endsWith func</a></li>
    2655. 

  2655. <li><a class="reference external" href="#continuesWith,string,string,Natural">continuesWith func</a></li>
    2656. 

  2656. <li><a class="reference external" href="#removePrefix,string,char">removePrefix func</a></li>
    2657. 

  2657. </ul>
    2658. 

  2658. 

  2659. <p><strong class="examples_text">Example:</strong></p>
    2660. 

  2660. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="StringLit">&quot;abracadabra&quot;</span>
    2661. 

  2661. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">startsWith</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">a</span><span class="CharLit">') == true</span>
    2662. 

  2662. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">startsWith</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">b</span><span class="CharLit">') == false</span></pre>
    2663. 

  2663.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1620" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2664. 

  2664. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1620" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2665. 

  2665. 

  2666.   </dd>
    2667. 

  2667. </div>
    2668. 

  2668. 

  2669. </div>
    2670. 

  2670. <div id="strip-procs-all">
    2671. 

  2671.   <div id="strip,string,set[char]">
    2672. 

  2672.   <dt><pre><span class="Keyword">func</span> <a href="#strip%2Cstring%2Cset%5Bchar%5D"><span class="Identifier">strip</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">leading</span> <span class="Other">=</span> <span class="Identifier">true</span><span class="Other">;</span> <span class="Identifier">trailing</span> <span class="Other">=</span> <span class="Identifier">true</span><span class="Other">;</span>
    2673. 

  2673.            <span class="Identifier">chars</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">]</span> <span class="Other">=</span> <span class="Identifier">Whitespace</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuStrip&quot;</span><span class="Other">,</span>
    2674. 

  2674.     <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2675. 

  2675.   <dd>
    2676. 

  2676.     
    2677. 

  2677.     <p>Strips leading or trailing <tt class="docutils literal"><span class="pre"><span class="Identifier">chars</span></span></tt> (default: whitespace characters) from <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> and returns the resulting string.</p>
    2678. 

  2678. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">leading</span></span></tt> is true (default), leading <tt class="docutils literal"><span class="pre"><span class="Identifier">chars</span></span></tt> are stripped. If <tt class="docutils literal"><span class="pre"><span class="Identifier">trailing</span></span></tt> is true (default), trailing <tt class="docutils literal"><span class="pre"><span class="Identifier">chars</span></span></tt> are stripped. If both are false, the string is returned unchanged.</p>
    2679. 

  2679. <p>See also:</p>
    2680. 

  2680. <ul class="simple"><li><a class="reference external" href="strbasics.html#strip,string,set[char]">strip proc</a> Inplace version.</li>
    2681. 

  2681. <li><a class="reference external" href="#stripLineEnd,string">stripLineEnd func</a></li>
    2682. 

  2682. </ul>
    2683. 

  2683. 

  2684. <p><strong class="examples_text">Example:</strong></p>
    2685. 

  2685. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="StringLit">&quot;  vhellov   &quot;</span>
    2686. 

  2686. <span class="Keyword">let</span> <span class="Identifier">b</span> <span class="Operator">=</span> <span class="Identifier">strip</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">)</span>
    2687. 

  2687. <span class="Identifier">doAssert</span> <span class="Identifier">b</span> <span class="Operator">==</span> <span class="StringLit">&quot;vhellov&quot;</span>
    2688. 

  2688. 

  2689. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">strip</span><span class="Punctuation">(</span><span class="Identifier">leading</span> <span class="Operator">=</span> <span class="Identifier">false</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;  vhellov&quot;</span>
    2690. 

  2690. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">strip</span><span class="Punctuation">(</span><span class="Identifier">trailing</span> <span class="Operator">=</span> <span class="Identifier">false</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;vhellov   &quot;</span>
    2691. 

  2691. 

  2692. <span class="Identifier">doAssert</span> <span class="Identifier">b</span><span class="Operator">.</span><span class="Identifier">strip</span><span class="Punctuation">(</span><span class="Identifier">chars</span> <span class="Operator">=</span> <span class="Punctuation">{</span><span class="Punctuation">'</span><span class="Identifier">v</span><span class="CharLit">'}) == &quot;hello&quot;</span>
    2693. 

  2693. <span class="Identifier">doAssert</span> <span class="Identifier">b</span><span class="Operator">.</span><span class="Identifier">strip</span><span class="Punctuation">(</span><span class="Identifier">leading</span> <span class="Operator">=</span> <span class="Identifier">false</span><span class="Punctuation">,</span> <span class="Identifier">chars</span> <span class="Operator">=</span> <span class="Punctuation">{</span><span class="Punctuation">'</span><span class="Identifier">v</span><span class="CharLit">'}) == &quot;vhello&quot;</span>
    2694. 

  2694. 

  2695. <span class="Keyword">let</span> <span class="Identifier">c</span> <span class="Operator">=</span> <span class="StringLit">&quot;blaXbla&quot;</span>
    2696. 

  2696. <span class="Identifier">doAssert</span> <span class="Identifier">c</span><span class="Operator">.</span><span class="Identifier">strip</span><span class="Punctuation">(</span><span class="Identifier">chars</span> <span class="Operator">=</span> <span class="Punctuation">{</span><span class="Punctuation">'</span><span class="Identifier">b</span><span class="CharLit">', '</span><span class="Identifier">a</span><span class="CharLit">'}) == &quot;laXbl&quot;</span>
    2697. 

  2697. <span class="Identifier">doAssert</span> <span class="Identifier">c</span><span class="Operator">.</span><span class="Identifier">strip</span><span class="Punctuation">(</span><span class="Identifier">chars</span> <span class="Operator">=</span> <span class="Punctuation">{</span><span class="Punctuation">'</span><span class="Identifier">b</span><span class="CharLit">', '</span><span class="Identifier">a</span><span class="CharLit">', '</span><span class="Identifier">l</span><span class="CharLit">'}) == &quot;X&quot;</span></pre>
    2698. 

  2698.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2934" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2699. 

  2699. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2934" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2700. 

  2700. 

  2701.   </dd>
    2702. 

  2702. </div>
    2703. 

  2703. 

  2704. </div>
    2705. 

  2705. <div id="stripLineEnd-procs-all">
    2706. 

  2706.   <div id="stripLineEnd,string">
    2707. 

  2707.   <dt><pre><span class="Keyword">func</span> <a href="#stripLineEnd%2Cstring"><span class="Identifier">stripLineEnd</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2708. 

  2708.   <dd>
    2709. 

  2709.     
    2710. 

  2710.     Strips one of these suffixes from <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> in-place: <tt class="docutils literal"><span class="pre"><span class="Operator">\</span><span class="Identifier">r</span><span class="Punctuation">,</span> <span class="Operator">\</span><span class="Identifier">n</span><span class="Punctuation">,</span> <span class="Operator">\</span><span class="Identifier">r</span><span class="Operator">\</span><span class="Identifier">n</span><span class="Punctuation">,</span> <span class="Operator">\</span><span class="Identifier">f</span><span class="Punctuation">,</span> <span class="Operator">\</span><span class="Identifier">v</span></span></tt> (at most once instance). For example, can be useful in conjunction with <tt class="docutils literal"><span class="pre"><span class="Identifier">osproc</span><span class="Operator">.</span><span class="Identifier">execCmdEx</span></span></tt>. aka: <span id="chomp_1">chomp</span>
    2711. 

  2711. <p><strong class="examples_text">Example:</strong></p>
    2712. 

  2712. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">s</span> <span class="Operator">=</span> <span class="StringLit">&quot;foo</span><span class="EscapeSequence">\n</span><span class="EscapeSequence">\n</span><span class="StringLit">&quot;</span>
    2713. 

  2713. <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">stripLineEnd</span>
    2714. 

  2714. <span class="Identifier">doAssert</span> <span class="Identifier">s</span> <span class="Operator">==</span> <span class="StringLit">&quot;foo</span><span class="EscapeSequence">\n</span><span class="StringLit">&quot;</span>
    2715. 

  2715. <span class="Identifier">s</span> <span class="Operator">=</span> <span class="StringLit">&quot;foo</span><span class="EscapeSequence">\r</span><span class="EscapeSequence">\n</span><span class="StringLit">&quot;</span>
    2716. 

  2716. <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">stripLineEnd</span>
    2717. 

  2717. <span class="Identifier">doAssert</span> <span class="Identifier">s</span> <span class="Operator">==</span> <span class="StringLit">&quot;foo&quot;</span></pre>
    2718. 

  2718.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2970" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2719. 

  2719. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2970" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2720. 

  2720. 

  2721.   </dd>
    2722. 

  2722. </div>
    2723. 

  2723. 

  2724. </div>
    2725. 

  2725. <div id="toBin-procs-all">
    2726. 

  2726.   <div id="toBin,BiggestInt,Positive">
    2727. 

  2727.   <dt><pre><span class="Keyword">func</span> <a href="#toBin%2CBiggestInt%2CPositive"><span class="Identifier">toBin</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <a href="ctypes.html#BiggestInt"><span class="Identifier">BiggestInt</span></a><span class="Other">;</span> <span class="Identifier">len</span><span class="Other">:</span> <a href="system.html#Positive"><span class="Identifier">Positive</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuToBin&quot;</span><span class="Other">,</span>
    2728. 

  2728.     <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2729. 

  2729.   <dd>
    2730. 

  2730.     
    2731. 

  2731.     <p>Converts <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt> into its binary representation.</p>
    2732. 

  2732. <p>The resulting string is always <tt class="docutils literal"><span class="pre"><span class="Identifier">len</span></span></tt> characters long. No leading <tt class="docutils literal"><span class="pre"><span class="BinNumber">0b</span></span></tt> prefix is generated.</p>
    2733. 

  2733. 

  2734. <p><strong class="examples_text">Example:</strong></p>
    2735. 

  2735. <pre class="listing"><span class="Keyword">let</span>
    2736. 

  2736.   <span class="Identifier">a</span> <span class="Operator">=</span> <span class="DecNumber">29</span>
    2737. 

  2737.   <span class="Identifier">b</span> <span class="Operator">=</span> <span class="DecNumber">257</span>
    2738. 

  2738. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">toBin</span><span class="Punctuation">(</span><span class="DecNumber">8</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;00011101&quot;</span>
    2739. 

  2739. <span class="Identifier">doAssert</span> <span class="Identifier">b</span><span class="Operator">.</span><span class="Identifier">toBin</span><span class="Punctuation">(</span><span class="DecNumber">8</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;00000001&quot;</span>
    2740. 

  2740. <span class="Identifier">doAssert</span> <span class="Identifier">b</span><span class="Operator">.</span><span class="Identifier">toBin</span><span class="Punctuation">(</span><span class="DecNumber">9</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;100000001&quot;</span></pre>
    2741. 

  2741.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L930" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2742. 

  2742. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L930" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2743. 

  2743. 

  2744.   </dd>
    2745. 

  2745. </div>
    2746. 

  2746. 

  2747. </div>
    2748. 

  2748. <div id="toHex-procs-all">
    2749. 

  2749.   <div id="toHex,string">
    2750. 

  2750.   <dt><pre><span class="Keyword">func</span> <a href="#toHex%2Cstring"><span class="Identifier">toHex</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2751. 

  2751.   <dd>
    2752. 

  2752.     
    2753. 

  2753.     <p>Converts a bytes string to its hexadecimal representation.</p>
    2754. 

  2754. <p>The output is twice the input long. No prefix like <tt class="docutils literal"><span class="pre"><span class="HexNumber">0x</span></span></tt> is generated.</p>
    2755. 

  2755. <p>See also:</p>
    2756. 

  2756. <ul class="simple"><li><a class="reference external" href="#parseHexStr,string">parseHexStr func</a> for the reverse operation</li>
    2757. 

  2757. </ul>
    2758. 

  2758. 

  2759. <p><strong class="examples_text">Example:</strong></p>
    2760. 

  2760. <pre class="listing"><span class="Keyword">let</span>
    2761. 

  2761.   <span class="Identifier">a</span> <span class="Operator">=</span> <span class="StringLit">&quot;1&quot;</span>
    2762. 

  2762.   <span class="Identifier">b</span> <span class="Operator">=</span> <span class="StringLit">&quot;A&quot;</span>
    2763. 

  2763.   <span class="Identifier">c</span> <span class="Operator">=</span> <span class="StringLit">&quot;</span><span class="EscapeSequence">\0</span><span class="EscapeSequence">\255</span><span class="StringLit">&quot;</span>
    2764. 

  2764. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">toHex</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;31&quot;</span>
    2765. 

  2765. <span class="Identifier">doAssert</span> <span class="Identifier">b</span><span class="Operator">.</span><span class="Identifier">toHex</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;41&quot;</span>
    2766. 

  2766. <span class="Identifier">doAssert</span> <span class="Identifier">c</span><span class="Operator">.</span><span class="Identifier">toHex</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;00FF&quot;</span></pre>
    2767. 

  2767.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1022" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2768. 

  2768. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1022" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2769. 

  2769. 

  2770.   </dd>
    2771. 

  2771. </div>
    2772. 

  2772. <div id="toHex,T">
    2773. 

  2773.   <dt><pre><span class="Keyword">func</span> <a href="#toHex%2CT"><span class="Identifier">toHex</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">:</span> <a href="system.html#SomeInteger"><span class="Identifier">SomeInteger</span></a><span class="Other">]</span><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <span class="Identifier">T</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a></pre></dt>
    2774. 

  2774.   <dd>
    2775. 

  2775.     
    2776. 

  2776.     Shortcut for <tt class="docutils literal"><span class="pre"><span class="Identifier">toHex</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">,</span> <span class="Identifier">T</span><span class="Operator">.</span><span class="Identifier">sizeof</span> <span class="Operator">*</span> <span class="DecNumber">2</span><span class="Punctuation">)</span></span></tt>
    2777. 

  2777. <p><strong class="examples_text">Example:</strong></p>
    2778. 

  2778. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">toHex</span><span class="Punctuation">(</span><span class="DecNumber">1984'i64</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;00000000000007C0&quot;</span>
    2779. 

  2779. <span class="Identifier">doAssert</span> <span class="Identifier">toHex</span><span class="Punctuation">(</span><span class="DecNumber">1984'i16</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;07C0&quot;</span></pre>
    2780. 

  2780.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1009" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2781. 

  2781. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1009" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2782. 

  2782. 

  2783.   </dd>
    2784. 

  2784. </div>
    2785. 

  2785. <div id="toHex,T,Positive">
    2786. 

  2786.   <dt><pre><span class="Keyword">func</span> <a href="#toHex%2CT%2CPositive"><span class="Identifier">toHex</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">:</span> <a href="system.html#SomeInteger"><span class="Identifier">SomeInteger</span></a><span class="Other">]</span><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <span class="Identifier">T</span><span class="Other">;</span> <span class="Identifier">len</span><span class="Other">:</span> <a href="system.html#Positive"><span class="Identifier">Positive</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a></pre></dt>
    2787. 

  2787.   <dd>
    2788. 

  2788.     
    2789. 

  2789.     <p>Converts <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt> to its hexadecimal representation.</p>
    2790. 

  2790. <p>The resulting string will be exactly <tt class="docutils literal"><span class="pre"><span class="Identifier">len</span></span></tt> characters long. No prefix like <tt class="docutils literal"><span class="pre"><span class="HexNumber">0x</span></span></tt> is generated. <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt> is treated as an unsigned value.</p>
    2791. 

  2791. 

  2792. <p><strong class="examples_text">Example:</strong></p>
    2793. 

  2793. <pre class="listing"><span class="Keyword">let</span>
    2794. 

  2794.   <span class="Identifier">a</span> <span class="Operator">=</span> <span class="DecNumber">62'</span><span class="Identifier">u64</span>
    2795. 

  2795.   <span class="Identifier">b</span> <span class="Operator">=</span> <span class="DecNumber">4097'</span><span class="Identifier">u64</span>
    2796. 

  2796. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">toHex</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;03E&quot;</span>
    2797. 

  2797. <span class="Identifier">doAssert</span> <span class="Identifier">b</span><span class="Operator">.</span><span class="Identifier">toHex</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;001&quot;</span>
    2798. 

  2798. <span class="Identifier">doAssert</span> <span class="Identifier">b</span><span class="Operator">.</span><span class="Identifier">toHex</span><span class="Punctuation">(</span><span class="DecNumber">4</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;1001&quot;</span>
    2799. 

  2799. <span class="Identifier">doAssert</span> <span class="Identifier">toHex</span><span class="Punctuation">(</span><span class="DecNumber">62</span><span class="Punctuation">,</span> <span class="DecNumber">3</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;03E&quot;</span>
    2800. 

  2800. <span class="Identifier">doAssert</span> <span class="Identifier">toHex</span><span class="Punctuation">(</span><span class="Operator">-</span><span class="DecNumber">8</span><span class="Punctuation">,</span> <span class="DecNumber">6</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;FFFFF8&quot;</span></pre>
    2801. 

  2801.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L987" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2802. 

  2802. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L987" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2803. 

  2803. 

  2804.   </dd>
    2805. 

  2805. </div>
    2806. 

  2806. 

  2807. </div>
    2808. 

  2808. <div id="toLowerAscii-procs-all">
    2809. 

  2809.   <div id="toLowerAscii,char">
    2810. 

  2810.   <dt><pre><span class="Keyword">func</span> <a href="#toLowerAscii%2Cchar"><span class="Identifier">toLowerAscii</span></a><span class="Other">(</span><span class="Identifier">c</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuToLowerAsciiChar&quot;</span><span class="Other">,</span>
    2811. 

  2811.                                    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2812. 

  2812.   <dd>
    2813. 

  2813.     
    2814. 

  2814.     <p>Returns the lower case version of character <tt class="docutils literal"><span class="pre"><span class="Identifier">c</span></span></tt>.</p>
    2815. 

  2815. <p>This works only for the letters <tt class="docutils literal"><span class="pre"><span class="Identifier">A</span><span class="Operator">-</span><span class="Identifier">Z</span></span></tt>. See <a class="reference external" href="unicode.html#toLower,Rune">unicode.toLower</a> for a version that works for any Unicode character.</p>
    2816. 

  2816. <p>See also:</p>
    2817. 

  2817. <ul class="simple"><li><a class="reference external" href="#isLowerAscii,char">isLowerAscii func</a></li>
    2818. 

  2818. <li><a class="reference external" href="#toLowerAscii,string">toLowerAscii func</a> for converting a string</li>
    2819. 

  2819. </ul>
    2820. 

  2820. 

  2821. <p><strong class="examples_text">Example:</strong></p>
    2822. 

  2822. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">toLowerAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">A</span><span class="CharLit">') == '</span><span class="Identifier">a</span><span class="CharLit">'</span>
    2823. 

  2823. <span class="Identifier">doAssert</span> <span class="Identifier">toLowerAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">e</span><span class="CharLit">') == '</span><span class="Identifier">e</span><span class="CharLit">'</span></pre>
    2824. 

  2824.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L204" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2825. 

  2825. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L204" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2826. 

  2826. 

  2827.   </dd>
    2828. 

  2828. </div>
    2829. 

  2829. <div id="toLowerAscii,string">
    2830. 

  2830.   <dt><pre><span class="Keyword">func</span> <a href="#toLowerAscii%2Cstring"><span class="Identifier">toLowerAscii</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuToLowerAsciiStr&quot;</span><span class="Other">,</span>
    2831. 

  2831.                                        <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2832. 

  2832.   <dd>
    2833. 

  2833.     
    2834. 

  2834.     <p>Converts string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> into lower case.</p>
    2835. 

  2835. <p>This works only for the letters <tt class="docutils literal"><span class="pre"><span class="Identifier">A</span><span class="Operator">-</span><span class="Identifier">Z</span></span></tt>. See <a class="reference external" href="unicode.html#toLower,string">unicode.toLower</a> for a version that works for any Unicode character.</p>
    2836. 

  2836. <p>See also:</p>
    2837. 

  2837. <ul class="simple"><li><a class="reference external" href="#normalize,string">normalize func</a></li>
    2838. 

  2838. </ul>
    2839. 

  2839. 

  2840. <p><strong class="examples_text">Example:</strong></p>
    2841. 

  2841. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">toLowerAscii</span><span class="Punctuation">(</span><span class="StringLit">&quot;FooBar!&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;foobar!&quot;</span></pre>
    2842. 

  2842.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L227" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2843. 

  2843. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L227" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2844. 

  2844. 

  2845.   </dd>
    2846. 

  2846. </div>
    2847. 

  2847. 

  2848. </div>
    2849. 

  2849. <div id="toOct-procs-all">
    2850. 

  2850.   <div id="toOct,BiggestInt,Positive">
    2851. 

  2851.   <dt><pre><span class="Keyword">func</span> <a href="#toOct%2CBiggestInt%2CPositive"><span class="Identifier">toOct</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <a href="ctypes.html#BiggestInt"><span class="Identifier">BiggestInt</span></a><span class="Other">;</span> <span class="Identifier">len</span><span class="Other">:</span> <a href="system.html#Positive"><span class="Identifier">Positive</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuToOct&quot;</span><span class="Other">,</span>
    2852. 

  2852.     <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2853. 

  2853.   <dd>
    2854. 

  2854.     
    2855. 

  2855.     <p>Converts <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt> into its octal representation.</p>
    2856. 

  2856. <p>The resulting string is always <tt class="docutils literal"><span class="pre"><span class="Identifier">len</span></span></tt> characters long. No leading <tt class="docutils literal"><span class="pre"><span class="OctNumber">0o</span></span></tt> prefix is generated.</p>
    2857. 

  2857. <p>Do not confuse it with <a class="reference external" href="#toOctal,char">toOctal func</a>.</p>
    2858. 

  2858. 

  2859. <p><strong class="examples_text">Example:</strong></p>
    2860. 

  2860. <pre class="listing"><span class="Keyword">let</span>
    2861. 

  2861.   <span class="Identifier">a</span> <span class="Operator">=</span> <span class="DecNumber">62</span>
    2862. 

  2862.   <span class="Identifier">b</span> <span class="Operator">=</span> <span class="DecNumber">513</span>
    2863. 

  2863. <span class="Identifier">doAssert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">toOct</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;076&quot;</span>
    2864. 

  2864. <span class="Identifier">doAssert</span> <span class="Identifier">b</span><span class="Operator">.</span><span class="Identifier">toOct</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;001&quot;</span>
    2865. 

  2865. <span class="Identifier">doAssert</span> <span class="Identifier">b</span><span class="Operator">.</span><span class="Identifier">toOct</span><span class="Punctuation">(</span><span class="DecNumber">5</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;01001&quot;</span></pre>
    2866. 

  2866.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L952" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2867. 

  2867. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L952" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2868. 

  2868. 

  2869.   </dd>
    2870. 

  2870. </div>
    2871. 

  2871. 

  2872. </div>
    2873. 

  2873. <div id="toOctal-procs-all">
    2874. 

  2874.   <div id="toOctal,char">
    2875. 

  2875.   <dt><pre><span class="Keyword">func</span> <a href="#toOctal%2Cchar"><span class="Identifier">toOctal</span></a><span class="Other">(</span><span class="Identifier">c</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuToOctal&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2876. 

  2876.                                 <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2877. 

  2877.   <dd>
    2878. 

  2878.     
    2879. 

  2879.     <p>Converts a character <tt class="docutils literal"><span class="pre"><span class="Identifier">c</span></span></tt> to its octal representation.</p>
    2880. 

  2880. <p>The resulting string may not have a leading zero. Its length is always exactly 3.</p>
    2881. 

  2881. <p>Do not confuse it with <a class="reference external" href="#toOct,BiggestInt,Positive">toOct func</a>.</p>
    2882. 

  2882. 

  2883. <p><strong class="examples_text">Example:</strong></p>
    2884. 

  2884. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">toOctal</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="DecNumber">1'</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;061&quot;</span>
    2885. 

  2885. <span class="Identifier">doAssert</span> <span class="Identifier">toOctal</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">A</span><span class="CharLit">') == &quot;101&quot;</span>
    2886. 

  2886. <span class="Identifier">doAssert</span> <span class="Identifier">toOctal</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">a</span><span class="CharLit">') == &quot;141&quot;</span>
    2887. 

  2887. <span class="Identifier">doAssert</span> <span class="Identifier">toOctal</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Operator">!</span><span class="CharLit">') == &quot;041&quot;</span></pre>
    2888. 

  2888.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1047" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2889. 

  2889. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1047" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2890. 

  2890. 

  2891.   </dd>
    2892. 

  2892. </div>
    2893. 

  2893. 

  2894. </div>
    2895. 

  2895. <div id="toUpperAscii-procs-all">
    2896. 

  2896.   <div id="toUpperAscii,char">
    2897. 

  2897.   <dt><pre><span class="Keyword">func</span> <a href="#toUpperAscii%2Cchar"><span class="Identifier">toUpperAscii</span></a><span class="Other">(</span><span class="Identifier">c</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuToUpperAsciiChar&quot;</span><span class="Other">,</span>
    2898. 

  2898.                                    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2899. 

  2899.   <dd>
    2900. 

  2900.     
    2901. 

  2901.     <p>Converts character <tt class="docutils literal"><span class="pre"><span class="Identifier">c</span></span></tt> into upper case.</p>
    2902. 

  2902. <p>This works only for the letters <tt class="docutils literal"><span class="pre"><span class="Identifier">A</span><span class="Operator">-</span><span class="Identifier">Z</span></span></tt>.  See <a class="reference external" href="unicode.html#toUpper,Rune">unicode.toUpper</a> for a version that works for any Unicode character.</p>
    2903. 

  2903. <p>See also:</p>
    2904. 

  2904. <ul class="simple"><li><a class="reference external" href="#isUpperAscii,char">isUpperAscii func</a></li>
    2905. 

  2905. <li><a class="reference external" href="#toUpperAscii,string">toUpperAscii func</a> for converting a string</li>
    2906. 

  2906. <li><a class="reference external" href="#capitalizeAscii,string">capitalizeAscii func</a></li>
    2907. 

  2907. </ul>
    2908. 

  2908. 

  2909. <p><strong class="examples_text">Example:</strong></p>
    2910. 

  2910. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">toUpperAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">a</span><span class="CharLit">') == '</span><span class="Identifier">A</span><span class="CharLit">'</span>
    2911. 

  2911. <span class="Identifier">doAssert</span> <span class="Identifier">toUpperAscii</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Identifier">E</span><span class="CharLit">') == '</span><span class="Identifier">E</span><span class="CharLit">'</span></pre>
    2912. 

  2912.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L240" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2913. 

  2913. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L240" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2914. 

  2914. 

  2915.   </dd>
    2916. 

  2916. </div>
    2917. 

  2917. <div id="toUpperAscii,string">
    2918. 

  2918.   <dt><pre><span class="Keyword">func</span> <a href="#toUpperAscii%2Cstring"><span class="Identifier">toUpperAscii</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuToUpperAsciiStr&quot;</span><span class="Other">,</span>
    2919. 

  2919.                                        <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2920. 

  2920.   <dd>
    2921. 

  2921.     
    2922. 

  2922.     <p>Converts string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> into upper case.</p>
    2923. 

  2923. <p>This works only for the letters <tt class="docutils literal"><span class="pre"><span class="Identifier">A</span><span class="Operator">-</span><span class="Identifier">Z</span></span></tt>.  See <a class="reference external" href="unicode.html#toUpper,string">unicode.toUpper</a> for a version that works for any Unicode character.</p>
    2924. 

  2924. <p>See also:</p>
    2925. 

  2925. <ul class="simple"><li><a class="reference external" href="#capitalizeAscii,string">capitalizeAscii func</a></li>
    2926. 

  2926. </ul>
    2927. 

  2927. 

  2928. <p><strong class="examples_text">Example:</strong></p>
    2929. 

  2929. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">toUpperAscii</span><span class="Punctuation">(</span><span class="StringLit">&quot;FooBar!&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;FOOBAR!&quot;</span></pre>
    2930. 

  2930.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L259" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2931. 

  2931. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L259" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2932. 

  2932. 

  2933.   </dd>
    2934. 

  2934. </div>
    2935. 

  2935. 

  2936. </div>
    2937. 

  2937. <div id="trimZeros-procs-all">
    2938. 

  2938.   <div id="trimZeros,string,char">
    2939. 

  2939.   <dt><pre><span class="Keyword">func</span> <a href="#trimZeros%2Cstring%2Cchar"><span class="Identifier">trimZeros</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">decimalSep</span> <span class="Other">=</span> <span class="CharLit">'.'</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2940. 

  2940.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2941. 

  2941.   <dd>
    2942. 

  2942.     
    2943. 

  2943.     <p>Trim trailing zeros from a formatted floating point value <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt> (must be declared as <tt class="docutils literal"><span class="pre"><span class="Keyword">var</span></span></tt>).</p>
    2944. 

  2944. <p>This modifies <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt> itself, it does not return a copy.</p>
    2945. 

  2945. 

  2946. <p><strong class="examples_text">Example:</strong></p>
    2947. 

  2947. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">x</span> <span class="Operator">=</span> <span class="StringLit">&quot;123.456000000&quot;</span>
    2948. 

  2948. <span class="Identifier">x</span><span class="Operator">.</span><span class="Identifier">trimZeros</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    2949. 

  2949. <span class="Identifier">doAssert</span> <span class="Identifier">x</span> <span class="Operator">==</span> <span class="StringLit">&quot;123.456&quot;</span></pre>
    2950. 

  2950.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2567" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2951. 

  2951. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2567" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2952. 

  2952. 

  2953.   </dd>
    2954. 

  2954. </div>
    2955. 

  2955. 

  2956. </div>
    2957. 

  2957. <div id="unescape-procs-all">
    2958. 

  2958.   <div id="unescape,string,string,string">
    2959. 

  2959.   <dt><pre><span class="Keyword">func</span> <a href="#unescape%2Cstring%2Cstring%2Cstring"><span class="Identifier">unescape</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">prefix</span> <span class="Other">=</span> <span class="StringLit">&quot;\&quot;&quot;</span><span class="Other">;</span> <span class="Identifier">suffix</span> <span class="Other">=</span> <span class="StringLit">&quot;\&quot;&quot;</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    2960. 

  2960.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuUnescape&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2961. 

  2961.   <dd>
    2962. 

  2962.     
    2963. 

  2963.     <p>Unescapes a string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    2964. 

  2964. <p>This complements <a class="reference external" href="#escape,string,string,string">escape func</a> as it performs the opposite operations.</p>
    2965. 

  2965. <p>If <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> does not begin with <tt class="docutils literal"><span class="pre"><span class="Identifier">prefix</span></span></tt> and end with <tt class="docutils literal"><span class="pre"><span class="Identifier">suffix</span></span></tt> a ValueError exception will be raised.</p>
    2966. 

  2966. 

  2967.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2401" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2968. 

  2968. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2401" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2969. 

  2969. 

  2970.   </dd>
    2971. 

  2971. </div>
    2972. 

  2972. 

  2973. </div>
    2974. 

  2974. <div id="unindent-procs-all">
    2975. 

  2975.   <div id="unindent,string,Natural,string">
    2976. 

  2976.   <dt><pre><span class="Keyword">func</span> <a href="#unindent%2Cstring%2CNatural%2Cstring"><span class="Identifier">unindent</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">count</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a> <span class="Other">=</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">.</span><span class="Identifier">high</span><span class="Other">;</span> <span class="Identifier">padding</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> <span class="Other">=</span> <span class="StringLit">&quot; &quot;</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.
    2977. 

  2977.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuUnindent&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2978. 

  2978.   <dd>
    2979. 

  2979.     
    2980. 

  2980.     <p>Unindents each line in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> by <tt class="docutils literal"><span class="pre"><span class="Identifier">count</span></span></tt> amount of <tt class="docutils literal"><span class="pre"><span class="Identifier">padding</span></span></tt>.</p>
    2981. 

  2981. <p><strong>Note:</strong> This does not preserve the new line characters used in <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.</p>
    2982. 

  2982. <p>See also:</p>
    2983. 

  2983. <ul class="simple"><li><a class="reference external" href="#dedent,string,Natural">dedent func</a></li>
    2984. 

  2984. <li><a class="reference external" href="#align,string,Natural,char">align func</a></li>
    2985. 

  2985. <li><a class="reference external" href="#alignLeft,string,Natural,char">alignLeft func</a></li>
    2986. 

  2986. <li><a class="reference external" href="#spaces,Natural">spaces func</a></li>
    2987. 

  2987. <li><a class="reference external" href="#indent,string,Natural,string">indent func</a></li>
    2988. 

  2988. </ul>
    2989. 

  2989. 

  2990. <p><strong class="examples_text">Example:</strong></p>
    2991. 

  2991. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">x</span> <span class="Operator">=</span> <span class="LongStringLit">&quot;&quot;&quot;
    2992. 

  2992.       Hello
    2993. 

  2993.         There
    2994. 

  2994.     &quot;&quot;&quot;</span><span class="Operator">.</span><span class="Identifier">unindent</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    2995. 

  2995. 

  2996. <span class="Identifier">doAssert</span> <span class="Identifier">x</span> <span class="Operator">==</span> <span class="StringLit">&quot;Hello</span><span class="EscapeSequence">\n</span><span class="StringLit">There</span><span class="EscapeSequence">\n</span><span class="StringLit">&quot;</span></pre>
    2997. 

  2997.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L1495" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2998. 

  2998. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L1495" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2999. 

  2999. 

  3000.   </dd>
    3001. 

  3001. </div>
    3002. 

  3002. 

  3003. </div>
    3004. 

  3004. <div id="validIdentifier-procs-all">
    3005. 

  3005.   <div id="validIdentifier,string">
    3006. 

  3006.   <dt><pre><span class="Keyword">func</span> <a href="#validIdentifier%2Cstring"><span class="Identifier">validIdentifier</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nsuValidIdentifier&quot;</span><span class="Other">,</span>
    3007. 

  3007.                                         <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3008. 

  3008.   <dd>
    3009. 

  3009.     
    3010. 

  3010.     <p>Returns true if <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> is a valid identifier.</p>
    3011. 

  3011. <p>A valid identifier starts with a character of the set <tt class="docutils literal"><span class="pre"><span class="Identifier">IdentStartChars</span></span></tt> and is followed by any number of characters of the set <tt class="docutils literal"><span class="pre"><span class="Identifier">IdentChars</span></span></tt>.</p>
    3012. 

  3012. 

  3013. <p><strong class="examples_text">Example:</strong></p>
    3014. 

  3014. <pre class="listing"><span class="Identifier">doAssert</span> <span class="StringLit">&quot;abc_def08&quot;</span><span class="Operator">.</span><span class="Identifier">validIdentifier</span></pre>
    3015. 

  3015.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2444" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3016. 

  3016. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2444" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3017. 

  3017. 

  3018.   </dd>
    3019. 

  3019. </div>
    3020. 

  3020. 

  3021. </div>
    3022. 

  3022. 

  3023.   </dl>
    3024. 

  3024. </div>
    3025. 

  3025. <div class="section" id="15">
    3026. 

  3026.   <h1><a class="toc-backref" href="#15">Iterators</a></h1>
    3027. 

  3027.   <dl class="item">
    3028. 

  3028.     <div id="rsplit-iterators-all">
    3029. 

  3029.   <div id="rsplit.i,string,char,int">
    3030. 

  3030.   <dt><pre><span class="Keyword">iterator</span> <a href="#rsplit.i%2Cstring%2Cchar%2Cint"><span class="Identifier">rsplit</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sep</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">;</span> <span class="Identifier">maxsplit</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    3031. 

  3031.     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3032. 

  3032.   <dd>
    3033. 

  3033.     
    3034. 

  3034.     <p>Splits the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> into substrings from the right using a string separator. Works exactly the same as <a class="reference external" href="#split.i,string,char,int">split iterator</a> except in <strong>reverse</strong> order.</p>
    3035. 

  3035. <p><pre class="listing"><span class="Keyword">for</span> <span class="Identifier">piece</span> <span class="Keyword">in</span> <span class="StringLit">&quot;foo:bar&quot;</span><span class="Operator">.</span><span class="Identifier">rsplit</span><span class="Punctuation">(</span><span class="Punctuation">'</span><span class="Punctuation">:</span><span class="Punctuation">'</span><span class="Punctuation">)</span><span class="Punctuation">:</span>
    3036. 

  3036.   <span class="Identifier">echo</span> <span class="Identifier">piece</span></pre></p>
    3037. 

  3037. <p>Results in:</p>
    3038. 

  3038. <p><pre class="listing"><span class="StringLit">&quot;bar&quot;</span>
    3039. 

  3039. <span class="StringLit">&quot;foo&quot;</span></pre></p>
    3040. 

  3040. <p>Substrings are separated from the right by the char <tt class="docutils literal"><span class="pre"><span class="Identifier">sep</span></span></tt>.</p>
    3041. 

  3041. <p>See also:</p>
    3042. 

  3042. <ul class="simple"><li><a class="reference external" href="#split.i,string,char,int">split iterator</a></li>
    3043. 

  3043. <li><a class="reference external" href="#splitLines.i,string">splitLines iterator</a></li>
    3044. 

  3044. <li><a class="reference external" href="#splitWhitespace.i,string,int">splitWhitespace iterator</a></li>
    3045. 

  3045. <li><a class="reference external" href="#rsplit,string,char,int">rsplit func</a></li>
    3046. 

  3046. </ul>
    3047. 

  3047. 

  3048.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L564" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3049. 

  3049. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L564" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3050. 

  3050. 

  3051.   </dd>
    3052. 

  3052. </div>
    3053. 

  3053. <div id="rsplit.i,string,string,int,bool">
    3054. 

  3054.   <dt><pre><span class="Keyword">iterator</span> <a href="#rsplit.i%2Cstring%2Cstring%2Cint%2Cbool"><span class="Identifier">rsplit</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sep</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">maxsplit</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">;</span>
    3055. 

  3055.                 <span class="Identifier">keepSeparators</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> <span class="Other">=</span> <span class="Identifier">false</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    3056. 

  3056.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3057. 

  3057.   <dd>
    3058. 

  3058.     
    3059. 

  3059.     <p>Splits the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> into substrings from the right using a string separator. Works exactly the same as <a class="reference external" href="#split.i,string,string,int">split iterator</a> except in <strong>reverse</strong> order.</p>
    3060. 

  3060. <p><pre class="listing"><span class="Keyword">for</span> <span class="Identifier">piece</span> <span class="Keyword">in</span> <span class="StringLit">&quot;foothebar&quot;</span><span class="Operator">.</span><span class="Identifier">rsplit</span><span class="Punctuation">(</span><span class="StringLit">&quot;the&quot;</span><span class="Punctuation">)</span><span class="Punctuation">:</span>
    3061. 

  3061.   <span class="Identifier">echo</span> <span class="Identifier">piece</span></pre></p>
    3062. 

  3062. <p>Results in:</p>
    3063. 

  3063. <p><pre class="listing"><span class="StringLit">&quot;bar&quot;</span>
    3064. 

  3064. <span class="StringLit">&quot;foo&quot;</span></pre></p>
    3065. 

  3065. <p>Substrings are separated from the right by the string <tt class="docutils literal"><span class="pre"><span class="Identifier">sep</span></span></tt></p>
    3066. 

  3066. <div class="admonition admonition-info"><span class="admonition-info-text"><b>Note:</b></span>
    3067. 

  3067. Empty separator string results in returning an original string, following the interpretation &quot;split by no element&quot;.</div>
    3068. 

  3068. <p>See also:</p>
    3069. 

  3069. <ul class="simple"><li><a class="reference external" href="#split.i,string,string,int">split iterator</a></li>
    3070. 

  3070. <li><a class="reference external" href="#splitLines.i,string">splitLines iterator</a></li>
    3071. 

  3071. <li><a class="reference external" href="#splitWhitespace.i,string,int">splitWhitespace iterator</a></li>
    3072. 

  3072. <li><a class="reference external" href="#rsplit,string,string,int">rsplit func</a></li>
    3073. 

  3073. </ul>
    3074. 

  3074. 

  3075.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L621" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3076. 

  3076. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L621" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3077. 

  3077. 

  3078.   </dd>
    3079. 

  3079. </div>
    3080. 

  3080. <div id="rsplit.i,string,set[char],int">
    3081. 

  3081.   <dt><pre><span class="Keyword">iterator</span> <a href="#rsplit.i%2Cstring%2Cset%5Bchar%5D%2Cint"><span class="Identifier">rsplit</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">seps</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">]</span> <span class="Other">=</span> <span class="Identifier">Whitespace</span><span class="Other">;</span> <span class="Identifier">maxsplit</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.
    3082. 

  3082.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3083. 

  3083.   <dd>
    3084. 

  3084.     
    3085. 

  3085.     <p>Splits the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> into substrings from the right using a string separator. Works exactly the same as <a class="reference external" href="#split.i,string,char,int">split iterator</a> except in <strong>reverse</strong> order.</p>
    3086. 

  3086. <p><pre class="listing"><span class="Keyword">for</span> <span class="Identifier">piece</span> <span class="Keyword">in</span> <span class="StringLit">&quot;foo bar&quot;</span><span class="Operator">.</span><span class="Identifier">rsplit</span><span class="Punctuation">(</span><span class="Identifier">WhiteSpace</span><span class="Punctuation">)</span><span class="Punctuation">:</span>
    3087. 

  3087.   <span class="Identifier">echo</span> <span class="Identifier">piece</span></pre></p>
    3088. 

  3088. <p>Results in:</p>
    3089. 

  3089. <p><pre class="listing"><span class="StringLit">&quot;bar&quot;</span>
    3090. 

  3090. <span class="StringLit">&quot;foo&quot;</span></pre></p>
    3091. 

  3091. <p>Substrings are separated from the right by the set of chars <tt class="docutils literal"><span class="pre"><span class="Identifier">seps</span></span></tt></p>
    3092. 

  3092. <div class="admonition admonition-info"><span class="admonition-info-text"><b>Note:</b></span>
    3093. 

  3093. Empty separator set results in returning an original string, following the interpretation &quot;split by no element&quot;.</div>
    3094. 

  3094. <p>See also:</p>
    3095. 

  3095. <ul class="simple"><li><a class="reference external" href="#split.i,string,set[char],int">split iterator</a></li>
    3096. 

  3096. <li><a class="reference external" href="#splitLines.i,string">splitLines iterator</a></li>
    3097. 

  3097. <li><a class="reference external" href="#splitWhitespace.i,string,int">splitWhitespace iterator</a></li>
    3098. 

  3098. <li><a class="reference external" href="#rsplit,string,set[char],int">rsplit func</a></li>
    3099. 

  3099. </ul>
    3100. 

  3100. 

  3101.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L591" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3102. 

  3102. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L591" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3103. 

  3103. 

  3104.   </dd>
    3105. 

  3105. </div>
    3106. 

  3106. 

  3107. </div>
    3108. 

  3108. <div id="split-iterators-all">
    3109. 

  3109.   <div id="split.i,string,char,int">
    3110. 

  3110.   <dt><pre><span class="Keyword">iterator</span> <a href="#split.i%2Cstring%2Cchar%2Cint"><span class="Identifier">split</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sep</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">;</span> <span class="Identifier">maxsplit</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    3111. 

  3111.     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3112. 

  3112.   <dd>
    3113. 

  3113.     
    3114. 

  3114.     <p>Splits the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> into substrings using a single separator.</p>
    3115. 

  3115. <p>Substrings are separated by the character <tt class="docutils literal"><span class="pre"><span class="Identifier">sep</span></span></tt>. The code:</p>
    3116. 

  3116. <p><pre class="listing"><span class="Keyword">for</span> <span class="Identifier">word</span> <span class="Keyword">in</span> <span class="Identifier">split</span><span class="Punctuation">(</span><span class="StringLit">&quot;;;this;is;an;;example;;;&quot;</span><span class="Punctuation">,</span> <span class="CharLit">';'</span><span class="Punctuation">)</span><span class="Punctuation">:</span>
    3117. 

  3117.   <span class="Identifier">writeLine</span><span class="Punctuation">(</span><span class="Identifier">stdout</span><span class="Punctuation">,</span> <span class="Identifier">word</span><span class="Punctuation">)</span></pre></p>
    3118. 

  3118. <p>Results in:</p>
    3119. 

  3119. <p><pre class="listing"><span class="StringLit">&quot;&quot;</span>
    3120. 

  3120. <span class="StringLit">&quot;&quot;</span>
    3121. 

  3121. <span class="StringLit">&quot;this&quot;</span>
    3122. 

  3122. <span class="StringLit">&quot;is&quot;</span>
    3123. 

  3123. <span class="StringLit">&quot;an&quot;</span>
    3124. 

  3124. <span class="StringLit">&quot;&quot;</span>
    3125. 

  3125. <span class="StringLit">&quot;example&quot;</span>
    3126. 

  3126. <span class="StringLit">&quot;&quot;</span>
    3127. 

  3127. <span class="StringLit">&quot;&quot;</span>
    3128. 

  3128. <span class="StringLit">&quot;&quot;</span></pre></p>
    3129. 

  3129. <p>See also:</p>
    3130. 

  3130. <ul class="simple"><li><a class="reference external" href="#rsplit.i,string,char,int">rsplit iterator</a></li>
    3131. 

  3131. <li><a class="reference external" href="#splitLines.i,string">splitLines iterator</a></li>
    3132. 

  3132. <li><a class="reference external" href="#splitWhitespace.i,string,int">splitWhitespace iterator</a></li>
    3133. 

  3133. <li><a class="reference external" href="#split,string,char,int">split func</a></li>
    3134. 

  3134. </ul>
    3135. 

  3135. 

  3136.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L421" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3137. 

  3137. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L421" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3138. 

  3138. 

  3139.   </dd>
    3140. 

  3140. </div>
    3141. 

  3141. <div id="split.i,string,string,int">
    3142. 

  3142.   <dt><pre><span class="Keyword">iterator</span> <a href="#split.i%2Cstring%2Cstring%2Cint"><span class="Identifier">split</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">sep</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">maxsplit</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    3143. 

  3143.     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3144. 

  3144.   <dd>
    3145. 

  3145.     
    3146. 

  3146.     <p>Splits the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> into substrings using a string separator.</p>
    3147. 

  3147. <p>Substrings are separated by the string <tt class="docutils literal"><span class="pre"><span class="Identifier">sep</span></span></tt>. The code:</p>
    3148. 

  3148. <p><pre class="listing"><span class="Keyword">for</span> <span class="Identifier">word</span> <span class="Keyword">in</span> <span class="Identifier">split</span><span class="Punctuation">(</span><span class="StringLit">&quot;thisDATAisDATAcorrupted&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;DATA&quot;</span><span class="Punctuation">)</span><span class="Punctuation">:</span>
    3149. 

  3149.   <span class="Identifier">writeLine</span><span class="Punctuation">(</span><span class="Identifier">stdout</span><span class="Punctuation">,</span> <span class="Identifier">word</span><span class="Punctuation">)</span></pre></p>
    3150. 

  3150. <p>Results in:</p>
    3151. 

  3151. <p><pre class="listing"><span class="StringLit">&quot;this&quot;</span>
    3152. 

  3152. <span class="StringLit">&quot;is&quot;</span>
    3153. 

  3153. <span class="StringLit">&quot;corrupted&quot;</span></pre></p>
    3154. 

  3154. <div class="admonition admonition-info"><span class="admonition-info-text"><b>Note:</b></span>
    3155. 

  3155. Empty separator string results in returning an original string, following the interpretation &quot;split by no element&quot;.</div>
    3156. 

  3156. <p>See also:</p>
    3157. 

  3157. <ul class="simple"><li><a class="reference external" href="#rsplit.i,string,string,int,bool">rsplit iterator</a></li>
    3158. 

  3158. <li><a class="reference external" href="#splitLines.i,string">splitLines iterator</a></li>
    3159. 

  3159. <li><a class="reference external" href="#splitWhitespace.i,string,int">splitWhitespace iterator</a></li>
    3160. 

  3160. <li><a class="reference external" href="#split,string,string,int">split func</a></li>
    3161. 

  3161. </ul>
    3162. 

  3162. 

  3163.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L508" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3164. 

  3164. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L508" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3165. 

  3165. 

  3166.   </dd>
    3167. 

  3167. </div>
    3168. 

  3168. <div id="split.i,string,set[char],int">
    3169. 

  3169.   <dt><pre><span class="Keyword">iterator</span> <a href="#split.i%2Cstring%2Cset%5Bchar%5D%2Cint"><span class="Identifier">split</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">seps</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">]</span> <span class="Other">=</span> <span class="Identifier">Whitespace</span><span class="Other">;</span> <span class="Identifier">maxsplit</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.
    3170. 

  3170.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3171. 

  3171.   <dd>
    3172. 

  3172.     
    3173. 

  3173.     <p>Splits the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> into substrings using a group of separators.</p>
    3174. 

  3174. <p>Substrings are separated by a substring containing only <tt class="docutils literal"><span class="pre"><span class="Identifier">seps</span></span></tt>.</p>
    3175. 

  3175. <p><pre class="listing"><span class="Keyword">for</span> <span class="Identifier">word</span> <span class="Keyword">in</span> <span class="Identifier">split</span><span class="Punctuation">(</span><span class="StringLit">&quot;this</span><span class="EscapeSequence">\l</span><span class="StringLit">is an</span><span class="EscapeSequence">\t</span><span class="StringLit">example&quot;</span><span class="Punctuation">)</span><span class="Punctuation">:</span>
    3176. 

  3176.   <span class="Identifier">writeLine</span><span class="Punctuation">(</span><span class="Identifier">stdout</span><span class="Punctuation">,</span> <span class="Identifier">word</span><span class="Punctuation">)</span></pre></p>
    3177. 

  3177. <p>...generates this output:</p>
    3178. 

  3178. <p><pre class="listing"><span class="StringLit">&quot;this&quot;</span>
    3179. 

  3179. <span class="StringLit">&quot;is&quot;</span>
    3180. 

  3180. <span class="StringLit">&quot;an&quot;</span>
    3181. 

  3181. <span class="StringLit">&quot;example&quot;</span></pre></p>
    3182. 

  3182. <p>And the following code:</p>
    3183. 

  3183. <p><pre class="listing"><span class="Keyword">for</span> <span class="Identifier">word</span> <span class="Keyword">in</span> <span class="Identifier">split</span><span class="Punctuation">(</span><span class="StringLit">&quot;this:is;an$example&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">{</span><span class="Punctuation">'</span><span class="Punctuation">;</span><span class="Punctuation">'</span><span class="Punctuation">,</span> <span class="CharLit">':'</span><span class="Punctuation">,</span> <span class="CharLit">'$'</span><span class="Punctuation">}</span><span class="Punctuation">)</span><span class="Punctuation">:</span>
    3184. 

  3184.   <span class="Identifier">writeLine</span><span class="Punctuation">(</span><span class="Identifier">stdout</span><span class="Punctuation">,</span> <span class="Identifier">word</span><span class="Punctuation">)</span></pre></p>
    3185. 

  3185. <p>...produces the same output as the first example. The code:</p>
    3186. 

  3186. <p><pre class="listing"><span class="Keyword">let</span> <span class="Identifier">date</span> <span class="Operator">=</span> <span class="StringLit">&quot;2012-11-20T22:08:08.398990&quot;</span>
    3187. 

  3187. <span class="Keyword">let</span> <span class="Identifier">separators</span> <span class="Operator">=</span> <span class="Punctuation">{</span><span class="Punctuation">'</span> <span class="CharLit">', '</span><span class="Operator">-</span><span class="CharLit">', '</span><span class="Punctuation">:</span><span class="Punctuation">'</span><span class="Punctuation">,</span> <span class="CharLit">'T'</span><span class="Punctuation">}</span>
    3188. 

  3188. <span class="Keyword">for</span> <span class="Identifier">number</span> <span class="Keyword">in</span> <span class="Identifier">split</span><span class="Punctuation">(</span><span class="Identifier">date</span><span class="Punctuation">,</span> <span class="Identifier">separators</span><span class="Punctuation">)</span><span class="Punctuation">:</span>
    3189. 

  3189.   <span class="Identifier">writeLine</span><span class="Punctuation">(</span><span class="Identifier">stdout</span><span class="Punctuation">,</span> <span class="Identifier">number</span><span class="Punctuation">)</span></pre></p>
    3190. 

  3190. <p>...results in:</p>
    3191. 

  3191. <p><pre class="listing"><span class="StringLit">&quot;2012&quot;</span>
    3192. 

  3192. <span class="StringLit">&quot;11&quot;</span>
    3193. 

  3193. <span class="StringLit">&quot;20&quot;</span>
    3194. 

  3194. <span class="StringLit">&quot;22&quot;</span>
    3195. 

  3195. <span class="StringLit">&quot;08&quot;</span>
    3196. 

  3196. <span class="StringLit">&quot;08.398990&quot;</span></pre></p>
    3197. 

  3197. <div class="admonition admonition-info"><span class="admonition-info-text"><b>Note:</b></span>
    3198. 

  3198. Empty separator set results in returning an original string, following the interpretation &quot;split by no element&quot;.</div>
    3199. 

  3199. <p>See also:</p>
    3200. 

  3200. <ul class="simple"><li><a class="reference external" href="#rsplit.i,string,set[char],int">rsplit iterator</a></li>
    3201. 

  3201. <li><a class="reference external" href="#splitLines.i,string">splitLines iterator</a></li>
    3202. 

  3202. <li><a class="reference external" href="#splitWhitespace.i,string,int">splitWhitespace iterator</a></li>
    3203. 

  3203. <li><a class="reference external" href="#split,string,set[char],int">split func</a></li>
    3204. 

  3204. </ul>
    3205. 

  3205. 

  3206.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L451" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3207. 

  3207. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L451" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3208. 

  3208. 

  3209.   </dd>
    3210. 

  3210. </div>
    3211. 

  3211. 

  3212. </div>
    3213. 

  3213. <div id="splitLines-iterators-all">
    3214. 

  3214.   <div id="splitLines.i,string">
    3215. 

  3215.   <dt><pre><span class="Keyword">iterator</span> <a href="#splitLines.i%2Cstring"><span class="Identifier">splitLines</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">keepEol</span> <span class="Other">=</span> <span class="Identifier">false</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    3216. 

  3216.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3217. 

  3217.   <dd>
    3218. 

  3218.     
    3219. 

  3219.     <p>Splits the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> into its containing lines.</p>
    3220. 

  3220. <p>Every <a class="reference external" href="manual.html#lexical-analysis-character-literals">character literal</a> newline combination (CR, LF, CR-LF) is supported. The result strings contain no trailing end of line characters unless the parameter <tt class="docutils literal"><span class="pre"><span class="Identifier">keepEol</span></span></tt> is set to <tt class="docutils literal"><span class="pre"><span class="Identifier">true</span></span></tt>.</p>
    3221. 

  3221. <p>Example:</p>
    3222. 

  3222. <p><pre class="listing"><span class="Keyword">for</span> <span class="Identifier">line</span> <span class="Keyword">in</span> <span class="Identifier">splitLines</span><span class="Punctuation">(</span><span class="StringLit">&quot;</span><span class="EscapeSequence">\n</span><span class="StringLit">this</span><span class="EscapeSequence">\n</span><span class="StringLit">is</span><span class="EscapeSequence">\n</span><span class="StringLit">an</span><span class="EscapeSequence">\n</span><span class="EscapeSequence">\n</span><span class="StringLit">example</span><span class="EscapeSequence">\n</span><span class="StringLit">&quot;</span><span class="Punctuation">)</span><span class="Punctuation">:</span>
    3223. 

  3223.   <span class="Identifier">writeLine</span><span class="Punctuation">(</span><span class="Identifier">stdout</span><span class="Punctuation">,</span> <span class="Identifier">line</span><span class="Punctuation">)</span></pre></p>
    3224. 

  3224. <p>Results in:</p>
    3225. 

  3225. <p><pre class="listing"><span class="StringLit">&quot;&quot;</span>
    3226. 

  3226. <span class="StringLit">&quot;this&quot;</span>
    3227. 

  3227. <span class="StringLit">&quot;is&quot;</span>
    3228. 

  3228. <span class="StringLit">&quot;an&quot;</span>
    3229. 

  3229. <span class="StringLit">&quot;&quot;</span>
    3230. 

  3230. <span class="StringLit">&quot;example&quot;</span>
    3231. 

  3231. <span class="StringLit">&quot;&quot;</span></pre></p>
    3232. 

  3232. <p>See also:</p>
    3233. 

  3233. <ul class="simple"><li><a class="reference external" href="#splitWhitespace.i,string,int">splitWhitespace iterator</a></li>
    3234. 

  3234. <li><a class="reference external" href="#splitLines,string">splitLines func</a></li>
    3235. 

  3235. </ul>
    3236. 

  3236. 

  3237.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L653" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3238. 

  3238. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L653" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3239. 

  3239. 

  3240.   </dd>
    3241. 

  3241. </div>
    3242. 

  3242. 

  3243. </div>
    3244. 

  3244. <div id="splitWhitespace-iterators-all">
    3245. 

  3245.   <div id="splitWhitespace.i,string,int">
    3246. 

  3246.   <dt><pre><span class="Keyword">iterator</span> <a href="#splitWhitespace.i%2Cstring%2Cint"><span class="Identifier">splitWhitespace</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">maxsplit</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> <span class="Other">=</span> <span class="DecNumber">-1</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    3247. 

  3247.     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3248. 

  3248.   <dd>
    3249. 

  3249.     
    3250. 

  3250.     <p>Splits the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> at whitespace stripping leading and trailing whitespace if necessary. If <tt class="docutils literal"><span class="pre"><span class="Identifier">maxsplit</span></span></tt> is specified and is positive, no more than <tt class="docutils literal"><span class="pre"><span class="Identifier">maxsplit</span></span></tt> splits is made.</p>
    3251. 

  3251. <p>The following code:</p>
    3252. 

  3252. <p><pre class="listing"><span class="Keyword">let</span> <span class="Identifier">s</span> <span class="Operator">=</span> <span class="StringLit">&quot;  foo </span><span class="EscapeSequence">\t</span><span class="StringLit"> bar  baz  &quot;</span>
    3253. 

  3253. <span class="Keyword">for</span> <span class="Identifier">ms</span> <span class="Keyword">in</span> <span class="Punctuation">[</span><span class="Operator">-</span><span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="DecNumber">3</span><span class="Punctuation">]</span><span class="Punctuation">:</span>
    3254. 

  3254.   <span class="Identifier">echo</span> <span class="StringLit">&quot;------ maxsplit = &quot;</span><span class="Punctuation">,</span> <span class="Identifier">ms</span><span class="Punctuation">,</span> <span class="StringLit">&quot;:&quot;</span>
    3255. 

  3255.   <span class="Keyword">for</span> <span class="Identifier">item</span> <span class="Keyword">in</span> <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">splitWhitespace</span><span class="Punctuation">(</span><span class="Identifier">maxsplit</span><span class="Operator">=</span><span class="Identifier">ms</span><span class="Punctuation">)</span><span class="Punctuation">:</span>
    3256. 

  3256.     <span class="Identifier">echo</span> <span class="CharLit">'&quot;'</span><span class="Punctuation">,</span> <span class="Identifier">item</span><span class="Punctuation">,</span> <span class="CharLit">'&quot;'</span></pre></p>
    3257. 

  3257. <p>...results in:</p>
    3258. 

  3258. <p><pre class="listing"><span class="Operator">------</span> <span class="Identifier">maxsplit</span> <span class="Operator">=</span> <span class="Operator">-</span><span class="DecNumber">1</span><span class="Punctuation">:</span>
    3259. 

  3259. <span class="StringLit">&quot;foo&quot;</span>
    3260. 

  3260. <span class="StringLit">&quot;bar&quot;</span>
    3261. 

  3261. <span class="StringLit">&quot;baz&quot;</span>
    3262. 

  3262. <span class="Operator">------</span> <span class="Identifier">maxsplit</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">:</span>
    3263. 

  3263. <span class="StringLit">&quot;foo&quot;</span>
    3264. 

  3264. <span class="StringLit">&quot;bar  baz  &quot;</span>
    3265. 

  3265. <span class="Operator">------</span> <span class="Identifier">maxsplit</span> <span class="Operator">=</span> <span class="DecNumber">2</span><span class="Punctuation">:</span>
    3266. 

  3266. <span class="StringLit">&quot;foo&quot;</span>
    3267. 

  3267. <span class="StringLit">&quot;bar&quot;</span>
    3268. 

  3268. <span class="StringLit">&quot;baz  &quot;</span>
    3269. 

  3269. <span class="Operator">------</span> <span class="Identifier">maxsplit</span> <span class="Operator">=</span> <span class="DecNumber">3</span><span class="Punctuation">:</span>
    3270. 

  3270. <span class="StringLit">&quot;foo&quot;</span>
    3271. 

  3271. <span class="StringLit">&quot;bar&quot;</span>
    3272. 

  3272. <span class="StringLit">&quot;baz&quot;</span></pre></p>
    3273. 

  3273. <p>See also:</p>
    3274. 

  3274. <ul class="simple"><li><a class="reference external" href="#splitLines.i,string">splitLines iterator</a></li>
    3275. 

  3275. <li><a class="reference external" href="#splitWhitespace,string,int">splitWhitespace func</a></li>
    3276. 

  3276. </ul>
    3277. 

  3277. 

  3278.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L704" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3279. 

  3279. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L704" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3280. 

  3280. 

  3281.   </dd>
    3282. 

  3282. </div>
    3283. 

  3283. 

  3284. </div>
    3285. 

  3285. <div id="tokenize-iterators-all">
    3286. 

  3286.   <div id="tokenize.i,string,set[char]">
    3287. 

  3287.   <dt><pre><span class="Keyword">iterator</span> <a href="#tokenize.i%2Cstring%2Cset%5Bchar%5D"><span class="Identifier">tokenize</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">seps</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">]</span> <span class="Other">=</span> <span class="Identifier">Whitespace</span><span class="Other">)</span><span class="Other">:</span> <span class="Keyword">tuple</span><span class="Other">[</span><span class="Identifier">token</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">,</span>
    3288. 

  3288.     <span class="Identifier">isSep</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3289. 

  3289.   <dd>
    3290. 

  3290.     
    3291. 

  3291.     <p>Tokenizes the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> into substrings.</p>
    3292. 

  3292. <p>Substrings are separated by a substring containing only <tt class="docutils literal"><span class="pre"><span class="Identifier">seps</span></span></tt>. Example:</p>
    3293. 

  3293. <p><pre class="listing"><span class="Keyword">for</span> <span class="Identifier">word</span> <span class="Keyword">in</span> <span class="Identifier">tokenize</span><span class="Punctuation">(</span><span class="StringLit">&quot;  this is an  example  &quot;</span><span class="Punctuation">)</span><span class="Punctuation">:</span>
    3294. 

  3294.   <span class="Identifier">writeLine</span><span class="Punctuation">(</span><span class="Identifier">stdout</span><span class="Punctuation">,</span> <span class="Identifier">word</span><span class="Punctuation">)</span></pre></p>
    3295. 

  3295. <p>Results in:</p>
    3296. 

  3296. <p><pre class="listing"><span class="Punctuation">(</span><span class="StringLit">&quot;  &quot;</span><span class="Punctuation">,</span> <span class="Identifier">true</span><span class="Punctuation">)</span>
    3297. 

  3297. <span class="Punctuation">(</span><span class="StringLit">&quot;this&quot;</span><span class="Punctuation">,</span> <span class="Identifier">false</span><span class="Punctuation">)</span>
    3298. 

  3298. <span class="Punctuation">(</span><span class="StringLit">&quot; &quot;</span><span class="Punctuation">,</span> <span class="Identifier">true</span><span class="Punctuation">)</span>
    3299. 

  3299. <span class="Punctuation">(</span><span class="StringLit">&quot;is&quot;</span><span class="Punctuation">,</span> <span class="Identifier">false</span><span class="Punctuation">)</span>
    3300. 

  3300. <span class="Punctuation">(</span><span class="StringLit">&quot; &quot;</span><span class="Punctuation">,</span> <span class="Identifier">true</span><span class="Punctuation">)</span>
    3301. 

  3301. <span class="Punctuation">(</span><span class="StringLit">&quot;an&quot;</span><span class="Punctuation">,</span> <span class="Identifier">false</span><span class="Punctuation">)</span>
    3302. 

  3302. <span class="Punctuation">(</span><span class="StringLit">&quot;  &quot;</span><span class="Punctuation">,</span> <span class="Identifier">true</span><span class="Punctuation">)</span>
    3303. 

  3303. <span class="Punctuation">(</span><span class="StringLit">&quot;example&quot;</span><span class="Punctuation">,</span> <span class="Identifier">false</span><span class="Punctuation">)</span>
    3304. 

  3304. <span class="Punctuation">(</span><span class="StringLit">&quot;  &quot;</span><span class="Punctuation">,</span> <span class="Identifier">true</span><span class="Punctuation">)</span></pre></p>
    3305. 

  3305. 

  3306.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/strutils.nim#L2996" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3307. 

  3307. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/strutils.nim#L2996" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3308. 

  3308. 

  3309.   </dd>
    3310. 

  3310. </div>
    3311. 

  3311. 

  3312. </div>
    3313. 

  3313. 

  3314.   </dl>
    3315. 

  3315. </div>
    3316. 

  3316. 

  3317.   </div>
    3318. 

  3318. </div>
    3319. 

  3319. 

  3320.       <div class="twelve-columns footer">
    3321. 

  3321.         <span class="nim-sprite"></span>
    3322. 

  3322.         <br>
    3323. 

  3323.         <small style="color: var(--hint);">Made with Nim. Generated: 2025-02-06 22:28:15 UTC</small>
    3324. 

  3324.       </div>
    3325. 

  3325.     </div>
    3326. 

  3326.   </div>
    3327. 

  3327.       <script defer data-domain="nim-lang.org" src="https://plausible.io/js/plausible.js"></script>
    3328. 

  3328.     
    3329. 

  3329. </body>
    3330. 

  3330. </html>
    3331. 

  3331.