TITLE

SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/Array::Circular/Array-Circular-0.0.4/README.md","sources":[],"node":{"type":"block","id":"YbweMJpbYQY3_MP0Ge7Jm","margin":"","name":"root","content":[{"type":"para","id":"WnmlMTm_uPR8ecN-yYNf3","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":137,"offset":136}},"text":"text","content":[{"meta":"https://github.com/lizmat/Array-Circular/actions","type":"fcode","name":"L","content":[{"type":"block","id":"tsV_zdFzz1wwGMfLlKedM","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":86,"offset":85}},"content":[{"type":"image","src":"https://github.com/lizmat/Array-Circular/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"aRJH2EcIQ7uyrXohLTQSR","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":138},"end":{"line":3,"column":7,"offset":144}},"content":["NAME"]},{"type":"para","id":"ctcp99kmPL7bHj4oN9x8c","margin":"","location":{"start":{"line":5,"column":1,"offset":146},"end":{"line":5,"column":52,"offset":197}},"text":"text","content":["Array::Circular - add \"is circular\" trait to Arrays"]},{"type":"block","id":"EZf-owFc8mLoWaq46WKZS","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":199},"end":{"line":7,"column":11,"offset":209}},"content":["SYNOPSIS"]},{"type":"block","id":"F0cxiUOZghqtpTkWQCwvi","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":211},"end":{"line":11,"column":49,"offset":285}},"content":[{"type":"verbatim","value":"use Array::Circular;\n\nmy @a is circular(3);  # limit to 3 elements"}]},{"type":"block","id":"vB6ZnuUGh62h4IhFzW6pC","margin":"","level":1,"name":"head","location":{"start":{"line":13,"column":1,"offset":287},"end":{"line":13,"column":14,"offset":300}},"content":["DESCRIPTION"]},{"type":"para","id":"iKZbqAw1DjgZCnhoUBFjP","margin":"","location":{"start":{"line":15,"column":1,"offset":302},"end":{"line":15,"column":430,"offset":731}},"text":"text","content":["This module adds a ",{"type":"fcode","name":"C","content":["is circular"]}," trait to ",{"type":"fcode","name":"C","content":["Arrays"]},". This limits the size of the array to the given number of elements, similar to shaped arrays. However, unlike shaped arrays, you ",{"type":"fcode","name":"B","content":["can"]}," ",{"type":"fcode","name":"C","content":["push"]},", ",{"type":"fcode","name":"C","content":["append"]},", ",{"type":"fcode","name":"C","content":["unshift"]}," and ",{"type":"fcode","name":"C","content":["prepend"]}," to arrays with the ",{"type":"fcode","name":"C","content":["is circular"]}," trait. Then, if the resulting size of the array is larger than the given size, elements will be removed \"from the other end\" until the array has the given size again."]},{"type":"block","id":"exX3P3DSnXcF37BcjbXDc","margin":"","level":1,"name":"head","location":{"start":{"line":17,"column":1,"offset":733},"end":{"line":17,"column":9,"offset":741}},"content":["AUTHOR"]},{"type":"para","id":"vQZfuIFhKQdyqQwoVrC4H","margin":"","location":{"start":{"line":19,"column":1,"offset":743},"end":{"line":19,"column":37,"offset":779}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"EPNdIPHQbriv8CPYa6OTM","margin":"","location":{"start":{"line":21,"column":1,"offset":781},"end":{"line":21,"column":109,"offset":889}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/Array-Circular","type":"fcode","name":"L","content":["https://github.com/lizmat/Array-Circular"]}," . Comments and Pull Requests are welcome."]},{"type":"block","id":"DbT9rS1Jil4jnTvsmFiZK","margin":"","level":1,"name":"head","location":{"start":{"line":23,"column":1,"offset":891},"end":{"line":23,"column":24,"offset":914}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"f70i_WlUrtmLw0tIcMscA","margin":"","location":{"start":{"line":25,"column":1,"offset":916},"end":{"line":25,"column":47,"offset":962}},"text":"text","content":["Copyright 2018, 2020, 2021 Elizabeth Mattijsen"]},{"type":"para","id":"7YKbu_vL3nrV_UD0xynts","margin":"","location":{"start":{"line":27,"column":1,"offset":964},"end":{"line":27,"column":104,"offset":1067}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/Array::Circular/Array-Circular-0.0.4/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"add \"is circular\" trait to Arrays","dist":"Array::Circular:ver<0.0.4>:auth<zef:lizmat>","license":"Artistic-2.0","name":"Array::Circular","path":"A/RR/ARRAY_CIRCULAR/275a0e03cbd282d3bf0f2519e6464cc6fd035a6a.tar.gz","perl":"6.c","provides":{"Array::Circular":"lib/Array/Circular.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/Array-Circular.git","tags":["UTILS"],"test-depends":[],"version":"0.0.4"},"files":[{"file":"work_mods/zef/Array::Circular/Array-Circular-0.0.4/README.md","publishUrl":"/mods/zef/Array::Circular/Array-Circular-0.0.4/README.md"},{"file":"work_mods/zef/Array::Circular/Array-Circular-0.0.4/lib/Array/Circular.rakumod","publishUrl":"/mods/zef/Array::Circular/Array-Circular-0.0.4/lib/Array/Circular.rakumod"}],"src":"zef","url":"/mods/zef/Array::Circular"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Array::Circular/Array-Circular-0.0.4/README.md","sources":[],"node":{"type":"block","id":"YbweMJpbYQY3_MP0Ge7Jm","margin":"","name":"root","content":[{"type":"para","id":"WnmlMTm_uPR8ecN-yYNf3","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":137,"offset":136}},"text":"text","content":[{"meta":"https://github.com/lizmat/Array-Circular/actions","type":"fcode","name":"L","content":[{"type":"block","id":"tsV_zdFzz1wwGMfLlKedM","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":86,"offset":85}},"content":[{"type":"image","src":"https://github.com/lizmat/Array-Circular/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"aRJH2EcIQ7uyrXohLTQSR","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":138},"end":{"line":3,"column":7,"offset":144}},"content":["NAME"]},{"type":"para","id":"ctcp99kmPL7bHj4oN9x8c","margin":"","location":{"start":{"line":5,"column":1,"offset":146},"end":{"line":5,"column":52,"offset":197}},"text":"text","content":["Array::Circular - add \"is circular\" trait to Arrays"]},{"type":"block","id":"EZf-owFc8mLoWaq46WKZS","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":199},"end":{"line":7,"column":11,"offset":209}},"content":["SYNOPSIS"]},{"type":"block","id":"F0cxiUOZghqtpTkWQCwvi","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":211},"end":{"line":11,"column":49,"offset":285}},"content":[{"type":"verbatim","value":"use Array::Circular;\n\nmy @a is circular(3);  # limit to 3 elements"}]},{"type":"block","id":"vB6ZnuUGh62h4IhFzW6pC","margin":"","level":1,"name":"head","location":{"start":{"line":13,"column":1,"offset":287},"end":{"line":13,"column":14,"offset":300}},"content":["DESCRIPTION"]},{"type":"para","id":"iKZbqAw1DjgZCnhoUBFjP","margin":"","location":{"start":{"line":15,"column":1,"offset":302},"end":{"line":15,"column":430,"offset":731}},"text":"text","content":["This module adds a ",{"type":"fcode","name":"C","content":["is circular"]}," trait to ",{"type":"fcode","name":"C","content":["Arrays"]},". This limits the size of the array to the given number of elements, similar to shaped arrays. However, unlike shaped arrays, you ",{"type":"fcode","name":"B","content":["can"]}," ",{"type":"fcode","name":"C","content":["push"]},", ",{"type":"fcode","name":"C","content":["append"]},", ",{"type":"fcode","name":"C","content":["unshift"]}," and ",{"type":"fcode","name":"C","content":["prepend"]}," to arrays with the ",{"type":"fcode","name":"C","content":["is circular"]}," trait. Then, if the resulting size of the array is larger than the given size, elements will be removed \"from the other end\" until the array has the given size again."]},{"type":"block","id":"exX3P3DSnXcF37BcjbXDc","margin":"","level":1,"name":"head","location":{"start":{"line":17,"column":1,"offset":733},"end":{"line":17,"column":9,"offset":741}},"content":["AUTHOR"]},{"type":"para","id":"vQZfuIFhKQdyqQwoVrC4H","margin":"","location":{"start":{"line":19,"column":1,"offset":743},"end":{"line":19,"column":37,"offset":779}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"EPNdIPHQbriv8CPYa6OTM","margin":"","location":{"start":{"line":21,"column":1,"offset":781},"end":{"line":21,"column":109,"offset":889}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/Array-Circular","type":"fcode","name":"L","content":["https://github.com/lizmat/Array-Circular"]}," . Comments and Pull Requests are welcome."]},{"type":"block","id":"DbT9rS1Jil4jnTvsmFiZK","margin":"","level":1,"name":"head","location":{"start":{"line":23,"column":1,"offset":891},"end":{"line":23,"column":24,"offset":914}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"f70i_WlUrtmLw0tIcMscA","margin":"","location":{"start":{"line":25,"column":1,"offset":916},"end":{"line":25,"column":47,"offset":962}},"text":"text","content":["Copyright 2018, 2020, 2021 Elizabeth Mattijsen"]},{"type":"para","id":"7YKbu_vL3nrV_UD0xynts","margin":"","location":{"start":{"line":27,"column":1,"offset":964},"end":{"line":27,"column":104,"offset":1067}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/Array::Circular/Array-Circular-0.0.4/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"add \"is circular\" trait to Arrays","dist":"Array::Circular:ver<0.0.4>:auth<zef:lizmat>","license":"Artistic-2.0","name":"Array::Circular","path":"A/RR/ARRAY_CIRCULAR/275a0e03cbd282d3bf0f2519e6464cc6fd035a6a.tar.gz","perl":"6.c","provides":{"Array::Circular":"lib/Array/Circular.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/Array-Circular.git","tags":["UTILS"],"test-depends":[],"version":"0.0.4"},"files":[{"file":"work_mods/zef/Array::Circular/Array-Circular-0.0.4/README.md","publishUrl":"/mods/zef/Array::Circular/Array-Circular-0.0.4/README.md"},{"file":"work_mods/zef/Array::Circular/Array-Circular-0.0.4/lib/Array/Circular.rakumod","publishUrl":"/mods/zef/Array::Circular/Array-Circular-0.0.4/lib/Array/Circular.rakumod"}],"src":"zef","url":"/mods/zef/Array::Circular"}}}
    =end data
    =end React


root

add "is circular" trait to Arrays


para

L<Examples| file:../examples/index.podlite>


L<Download |file:../download/index.podlite>


=begin React :component<HeaderCol> :id<menu> 
=para L<Documentation|/doc/introduction>
=para L<Modules| /mods>
=para L<Examples| file:../examples/index.podlite>
=para L<Download |file:../download/index.podlite>
=para L<About|file:../about/index.podlite>
=para 🔍 K<⌘K>/K<ctrl-K>
=end React


HEADER

FOOTER

Array::Circular


arrays that round indices while accessing elements


=begin data
{"type":"page","file":"work_mods/zef/Array::Rounded/Array-Rounded-0.0.1/README.md","sources":[],"node":{"type":"block","id":"4VnEwwe9jrVTUJxgQ2DNV","margin":"","name":"root","content":[{"type":"para","id":"6eEsmMqcw84mdPxmGrmVk","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":147,"offset":146}},"text":"text","content":[{"meta":"https://github.com/lizmat/Array-Rounded/actions","type":"fcode","name":"L","content":[{"type":"block","id":"FarMsFroLfDyNsqNt0-9s","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":97,"offset":96}},"content":[{"type":"image","src":"https://github.com/lizmat/Array-Rounded/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"enmDiZMwgxrnVNv9VCFdy","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":148},"end":{"line":3,"column":7,"offset":154}},"content":["NAME"]},{"type":"para","id":"8qKu-TRLv6NmHsQJsHlIK","margin":"","location":{"start":{"line":5,"column":1,"offset":156},"end":{"line":5,"column":68,"offset":223}},"text":"text","content":["Array::Rounded - arrays that round indices while accessing elements"]},{"type":"block","id":"vMYWTJHloAFdW8_l1ZseA","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":225},"end":{"line":7,"column":11,"offset":235}},"content":["SYNOPSIS"]},{"type":"block","id":"u_G0d5NjuFhzLJsZxC4zj","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":237},"end":{"line":14,"column":4,"offset":311}},"content":[{"type":"verbatim","value":"use Array::Rounded;\n\nmy @a is Rounded = ^10;\nsay @a[1.5];  # 2"}]},{"type":"block","id":"Dcm5VUPuQhBP7CDzoShXC","margin":"","level":1,"name":"head","location":{"start":{"line":16,"column":1,"offset":313},"end":{"line":16,"column":14,"offset":326}},"content":["DESCRIPTION"]},{"type":"para","id":"6FfrmuNKll1CyfKvkGRC6","margin":"","location":{"start":{"line":18,"column":1,"offset":328},"end":{"line":18,"column":237,"offset":564}},"text":"text","content":["Array::Rounded provides a subclass of ",{"type":"fcode","name":"C","content":["Array"]}," called ",{"type":"fcode","name":"C","content":["Rounded"]}," that will ",{"type":"fcode","name":"B","content":["round"]}," non-integer indices on the array, rather than truncating them. Other than that, any arrays created with the ",{"type":"fcode","name":"C","content":["Rounded"]}," class will act as a normal ",{"type":"fcode","name":"C","content":["Array"]},"."]},{"type":"block","id":"093Uo63QMxZBp0b1lcqvw","margin":"","level":1,"name":"head","location":{"start":{"line":20,"column":1,"offset":566},"end":{"line":20,"column":25,"offset":590}},"content":["IMPLEMENTATION DETAILS"]},{"type":"para","id":"jzQRpKjl9kN0VyI76cVXJ","margin":"","location":{"start":{"line":22,"column":1,"offset":592},"end":{"line":22,"column":249,"offset":840}},"text":"text","content":["Because ",{"type":"fcode","name":"C","content":["postcircumfix:<[ ]>"]}," already intifies any non-integer value in current and possibly future versions of the Raku Programming Language, this module also exports some ",{"type":"fcode","name":"C","content":["postcircumfix:<[ ]>"]}," candidates to circumvent the premature intifications."]},{"type":"para","id":"dGPSzwGAkKilCEHBH4N-d","margin":"","location":{"start":{"line":24,"column":1,"offset":842},"end":{"line":24,"column":127,"offset":968}},"text":"text","content":["Also, due to some issues with native arrays, it has as yet been impossible to provide similar functionality for native arrays."]},{"type":"block","id":"VfPEtzakN_thWNZ2MgDmI","margin":"","level":1,"name":"head","location":{"start":{"line":26,"column":1,"offset":970},"end":{"line":26,"column":9,"offset":978}},"content":["AUTHOR"]},{"type":"para","id":"gfxLOr-s3U5xUYxSx0SRp","margin":"","location":{"start":{"line":28,"column":1,"offset":980},"end":{"line":28,"column":37,"offset":1016}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"D60gl-vY7f5dtS9RFhJ1e","margin":"","location":{"start":{"line":30,"column":1,"offset":1018},"end":{"line":30,"column":108,"offset":1125}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/Array-Rounded","type":"fcode","name":"L","content":["https://github.com/lizmat/Array-Rounded"]}," . Comments and Pull Requests are welcome."]},{"type":"para","id":"-NPCRKhsWFecMdetihcND","margin":"","location":{"start":{"line":32,"column":1,"offset":1127},"end":{"line":32,"column":163,"offset":1289}},"text":"text","content":["If you like this module, or what I’m doing more generally, committing to a ",{"meta":"https://github.com/sponsors/lizmat/","type":"fcode","name":"L","content":["small sponsorship"]}," would mean a great deal to me!"]},{"type":"block","id":"tsJ0R60ktL_P95IuMUT6d","margin":"","level":1,"name":"head","location":{"start":{"line":34,"column":1,"offset":1291},"end":{"line":34,"column":24,"offset":1314}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"dXbX8B9LG1e8xGS4aKb1t","margin":"","location":{"start":{"line":36,"column":1,"offset":1316},"end":{"line":36,"column":35,"offset":1350}},"text":"text","content":["Copyright 2022 Elizabeth Mattijsen"]},{"type":"para","id":"nXx-nFekPcZ02mymS6fyW","margin":"","location":{"start":{"line":38,"column":1,"offset":1352},"end":{"line":38,"column":104,"offset":1455}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/Array::Rounded/Array-Rounded-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"arrays that round indices while accessing elements","dist":"Array::Rounded:ver<0.0.1>:auth<zef:lizmat>","license":"Artistic-2.0","name":"Array::Rounded","path":"A/RR/ARRAY_ROUNDED/72e2e56365690b99e2735ba17a3af3e84f6a015b.tar.gz","perl":"6.d","provides":{"Array::Rounded":"lib/Array/Rounded.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/Array-Rounded.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/Array::Rounded/Array-Rounded-0.0.1/README.md","publishUrl":"/mods/zef/Array::Rounded/Array-Rounded-0.0.1/README.md"},{"file":"work_mods/zef/Array::Rounded/Array-Rounded-0.0.1/lib/Array/Rounded.rakumod","publishUrl":"/mods/zef/Array::Rounded/Array-Rounded-0.0.1/lib/Array/Rounded.rakumod"}],"src":"zef","url":"/mods/zef/Array::Rounded"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Array::Rounded/Array-Rounded-0.0.1/README.md","sources":[],"node":{"type":"block","id":"4VnEwwe9jrVTUJxgQ2DNV","margin":"","name":"root","content":[{"type":"para","id":"6eEsmMqcw84mdPxmGrmVk","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":147,"offset":146}},"text":"text","content":[{"meta":"https://github.com/lizmat/Array-Rounded/actions","type":"fcode","name":"L","content":[{"type":"block","id":"FarMsFroLfDyNsqNt0-9s","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":97,"offset":96}},"content":[{"type":"image","src":"https://github.com/lizmat/Array-Rounded/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"enmDiZMwgxrnVNv9VCFdy","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":148},"end":{"line":3,"column":7,"offset":154}},"content":["NAME"]},{"type":"para","id":"8qKu-TRLv6NmHsQJsHlIK","margin":"","location":{"start":{"line":5,"column":1,"offset":156},"end":{"line":5,"column":68,"offset":223}},"text":"text","content":["Array::Rounded - arrays that round indices while accessing elements"]},{"type":"block","id":"vMYWTJHloAFdW8_l1ZseA","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":225},"end":{"line":7,"column":11,"offset":235}},"content":["SYNOPSIS"]},{"type":"block","id":"u_G0d5NjuFhzLJsZxC4zj","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":237},"end":{"line":14,"column":4,"offset":311}},"content":[{"type":"verbatim","value":"use Array::Rounded;\n\nmy @a is Rounded = ^10;\nsay @a[1.5];  # 2"}]},{"type":"block","id":"Dcm5VUPuQhBP7CDzoShXC","margin":"","level":1,"name":"head","location":{"start":{"line":16,"column":1,"offset":313},"end":{"line":16,"column":14,"offset":326}},"content":["DESCRIPTION"]},{"type":"para","id":"6FfrmuNKll1CyfKvkGRC6","margin":"","location":{"start":{"line":18,"column":1,"offset":328},"end":{"line":18,"column":237,"offset":564}},"text":"text","content":["Array::Rounded provides a subclass of ",{"type":"fcode","name":"C","content":["Array"]}," called ",{"type":"fcode","name":"C","content":["Rounded"]}," that will ",{"type":"fcode","name":"B","content":["round"]}," non-integer indices on the array, rather than truncating them. Other than that, any arrays created with the ",{"type":"fcode","name":"C","content":["Rounded"]}," class will act as a normal ",{"type":"fcode","name":"C","content":["Array"]},"."]},{"type":"block","id":"093Uo63QMxZBp0b1lcqvw","margin":"","level":1,"name":"head","location":{"start":{"line":20,"column":1,"offset":566},"end":{"line":20,"column":25,"offset":590}},"content":["IMPLEMENTATION DETAILS"]},{"type":"para","id":"jzQRpKjl9kN0VyI76cVXJ","margin":"","location":{"start":{"line":22,"column":1,"offset":592},"end":{"line":22,"column":249,"offset":840}},"text":"text","content":["Because ",{"type":"fcode","name":"C","content":["postcircumfix:<[ ]>"]}," already intifies any non-integer value in current and possibly future versions of the Raku Programming Language, this module also exports some ",{"type":"fcode","name":"C","content":["postcircumfix:<[ ]>"]}," candidates to circumvent the premature intifications."]},{"type":"para","id":"dGPSzwGAkKilCEHBH4N-d","margin":"","location":{"start":{"line":24,"column":1,"offset":842},"end":{"line":24,"column":127,"offset":968}},"text":"text","content":["Also, due to some issues with native arrays, it has as yet been impossible to provide similar functionality for native arrays."]},{"type":"block","id":"VfPEtzakN_thWNZ2MgDmI","margin":"","level":1,"name":"head","location":{"start":{"line":26,"column":1,"offset":970},"end":{"line":26,"column":9,"offset":978}},"content":["AUTHOR"]},{"type":"para","id":"gfxLOr-s3U5xUYxSx0SRp","margin":"","location":{"start":{"line":28,"column":1,"offset":980},"end":{"line":28,"column":37,"offset":1016}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"D60gl-vY7f5dtS9RFhJ1e","margin":"","location":{"start":{"line":30,"column":1,"offset":1018},"end":{"line":30,"column":108,"offset":1125}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/Array-Rounded","type":"fcode","name":"L","content":["https://github.com/lizmat/Array-Rounded"]}," . Comments and Pull Requests are welcome."]},{"type":"para","id":"-NPCRKhsWFecMdetihcND","margin":"","location":{"start":{"line":32,"column":1,"offset":1127},"end":{"line":32,"column":163,"offset":1289}},"text":"text","content":["If you like this module, or what I’m doing more generally, committing to a ",{"meta":"https://github.com/sponsors/lizmat/","type":"fcode","name":"L","content":["small sponsorship"]}," would mean a great deal to me!"]},{"type":"block","id":"tsJ0R60ktL_P95IuMUT6d","margin":"","level":1,"name":"head","location":{"start":{"line":34,"column":1,"offset":1291},"end":{"line":34,"column":24,"offset":1314}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"dXbX8B9LG1e8xGS4aKb1t","margin":"","location":{"start":{"line":36,"column":1,"offset":1316},"end":{"line":36,"column":35,"offset":1350}},"text":"text","content":["Copyright 2022 Elizabeth Mattijsen"]},{"type":"para","id":"nXx-nFekPcZ02mymS6fyW","margin":"","location":{"start":{"line":38,"column":1,"offset":1352},"end":{"line":38,"column":104,"offset":1455}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/Array::Rounded/Array-Rounded-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"arrays that round indices while accessing elements","dist":"Array::Rounded:ver<0.0.1>:auth<zef:lizmat>","license":"Artistic-2.0","name":"Array::Rounded","path":"A/RR/ARRAY_ROUNDED/72e2e56365690b99e2735ba17a3af3e84f6a015b.tar.gz","perl":"6.d","provides":{"Array::Rounded":"lib/Array/Rounded.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/Array-Rounded.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/Array::Rounded/Array-Rounded-0.0.1/README.md","publishUrl":"/mods/zef/Array::Rounded/Array-Rounded-0.0.1/README.md"},{"file":"work_mods/zef/Array::Rounded/Array-Rounded-0.0.1/lib/Array/Rounded.rakumod","publishUrl":"/mods/zef/Array::Rounded/Array-Rounded-0.0.1/lib/Array/Rounded.rakumod"}],"src":"zef","url":"/mods/zef/Array::Rounded"}}}
    =end data
    =end React


Array::Rounded


=begin data
{"type":"page","file":"work_mods/zef/Array::Agnostic/Array-Agnostic-0.0.10/README.md","sources":[],"node":{"type":"block","id":"mFiJCL4K05pQoHuJceIU4","margin":"","name":"root","content":[{"type":"para","id":"fDMnB7Z4fr1imC0glMK4m","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":137,"offset":136}},"text":"text","content":[{"meta":"https://github.com/lizmat/Array-Agnostic/actions","type":"fcode","name":"L","content":[{"type":"block","id":"swV518_m7B-DJ4lKtPdDy","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":86,"offset":85}},"content":[{"type":"image","src":"https://github.com/lizmat/Array-Agnostic/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"asV7r3RFPm3BdkPZuO38m","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":138},"end":{"line":3,"column":7,"offset":144}},"content":["NAME"]},{"type":"para","id":"YgwP9_B_Rjbf9z1IWFxMT","margin":"","location":{"start":{"line":5,"column":1,"offset":146},"end":{"line":5,"column":50,"offset":195}},"text":"text","content":["Array::Agnostic - be an array without knowing how"]},{"type":"block","id":"-upZLiopC4tLRgZDZcahg","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":197},"end":{"line":7,"column":11,"offset":207}},"content":["SYNOPSIS"]},{"type":"block","id":"1bKH8pWpivjakHJPdcdFl","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":209},"end":{"line":15,"column":30,"offset":383}},"content":[{"type":"verbatim","value":"use Array::Agnostic;\nclass MyArray does Array::Agnostic {\n    method AT-POS()     { ... }\n    method elems()      { ... }\n}\n\nmy @a is MyArray = 1,2,3;"}]},{"type":"block","id":"lqHGTDelUPUkgFgMqBERv","margin":"","level":1,"name":"head","location":{"start":{"line":17,"column":1,"offset":385},"end":{"line":17,"column":14,"offset":398}},"content":["DESCRIPTION"]},{"type":"para","id":"qi3350Ssj_kX1GAAnZYdg","margin":"","location":{"start":{"line":19,"column":1,"offset":400},"end":{"line":19,"column":220,"offset":619}},"text":"text","content":["This module makes an ",{"type":"fcode","name":"C","content":["Array::Agnostic"]}," role available for those classes that wish to implement the ",{"type":"fcode","name":"C","content":["Positional"]}," role as an ",{"type":"fcode","name":"C","content":["Array"]},". It provides all of the ",{"type":"fcode","name":"C","content":["Array"]}," functionality while only needing to implement 2 methods:"]},{"type":"block","id":"oJB_ITFTrzD5cJyFnMd37","margin":"","level":2,"name":"head","location":{"start":{"line":21,"column":1,"offset":621},"end":{"line":21,"column":20,"offset":640}},"content":["Required Methods"]},{"type":"block","id":"6Kkc6qXtv35IoWJGMAgnE","margin":"","level":3,"name":"head","location":{"start":{"line":23,"column":1,"offset":642},"end":{"line":23,"column":18,"offset":659}},"content":["method AT-POS"]},{"type":"block","id":"Z19vs7QBL_iqi03BzSaAE","margin":"","name":"code","config":[],"location":{"start":{"line":25,"column":1,"offset":661},"end":{"line":27,"column":79,"offset":792}},"content":[{"type":"verbatim","value":"method AT-POS($position) { ... }  # simple case\n\nmethod AT-POS($position) { Proxy.new( FETCH => { ... }, STORE => { ... } }"}]},{"type":"para","id":"8JxD4Eh2D8PNfjHtp5j1U","margin":"","location":{"start":{"line":29,"column":1,"offset":794},"end":{"line":29,"column":179,"offset":972}},"text":"text","content":["Return the value at the given position in the array. Must return a ",{"type":"fcode","name":"C","content":["Proxy"]}," that will assign to that position if you wish to allow for auto-vivification of elements in your array."]},{"type":"block","id":"1vYjJPxEegaB5ST-nd7k3","margin":"","level":3,"name":"head","location":{"start":{"line":31,"column":1,"offset":974},"end":{"line":31,"column":17,"offset":990}},"content":["method elems"]},{"type":"block","id":"vXkbYut0XByRYgabQyiYm","margin":"","name":"code","config":[],"location":{"start":{"line":33,"column":1,"offset":992},"end":{"line":33,"column":36,"offset":1027}},"content":[{"type":"verbatim","value":"method elems(--> Int:D) { ... }"}]},{"type":"para","id":"9Oz7zld8XxXXQzmnPdOEV","margin":"","location":{"start":{"line":35,"column":1,"offset":1029},"end":{"line":35,"column":94,"offset":1122}},"text":"text","content":["Return the number of elements in the array (defined as the index of the highest element + 1)."]},{"type":"block","id":"J6mXQQVfO7TasqDlCs4Bl","margin":"","level":2,"name":"head","location":{"start":{"line":37,"column":1,"offset":1124},"end":{"line":37,"column":39,"offset":1162}},"content":["Optional Methods (provided by role)"]},{"type":"para","id":"lmjg7WHE6izbFNU2WbIH6","margin":"","location":{"start":{"line":39,"column":1,"offset":1164},"end":{"line":39,"column":242,"offset":1405}},"text":"text","content":["You may implement these methods out of performance reasons yourself, but you don't have to as an implementation is provided by this role. They follow the same semantics as the methods on the ",{"meta":"https://docs.perl6.org/type/Array","type":"fcode","name":"L","content":["Array object"]},"."]},{"type":"para","id":"v_wzNsjtVlUG2YuMJamis","margin":"","location":{"start":{"line":41,"column":1,"offset":1407},"end":{"line":41,"column":243,"offset":1649}},"text":"text","content":["In alphabetical order: ",{"type":"fcode","name":"C","content":["append"]},", ",{"type":"fcode","name":"C","content":["Array"]},", ",{"type":"fcode","name":"C","content":["ASSIGN-POS"]},", ",{"type":"fcode","name":"C","content":["end"]},", ",{"type":"fcode","name":"C","content":["gist"]},", ",{"type":"fcode","name":"C","content":["grab"]},", ",{"type":"fcode","name":"C","content":["iterator"]},", ",{"type":"fcode","name":"C","content":["keys"]},", ",{"type":"fcode","name":"C","content":["kv"]},", ",{"type":"fcode","name":"C","content":["list"]},", ",{"type":"fcode","name":"C","content":["List"]},", ",{"type":"fcode","name":"C","content":["new"]},", ",{"type":"fcode","name":"C","content":["pairs"]},", ",{"type":"fcode","name":"C","content":["perl"]},", ",{"type":"fcode","name":"C","content":["pop"]},", ",{"type":"fcode","name":"C","content":["prepend"]},", ",{"type":"fcode","name":"C","content":["push"]},", ",{"type":"fcode","name":"C","content":["shape"]},", ",{"type":"fcode","name":"C","content":["shift"]},", ",{"type":"fcode","name":"C","content":["Slip"]},", ",{"type":"fcode","name":"C","content":["STORE"]},", ",{"type":"fcode","name":"C","content":["Str"]},", ",{"type":"fcode","name":"C","content":["splice"]},", ",{"type":"fcode","name":"C","content":["unshift"]},", ",{"type":"fcode","name":"C","content":["values"]}]},{"type":"block","id":"kMLqkr_3lagCkB2xvJL9S","margin":"","level":2,"name":"head","location":{"start":{"line":43,"column":1,"offset":1651},"end":{"line":43,"column":48,"offset":1698}},"content":["Optional Internal Methods (provided by role)"]},{"type":"para","id":"BB9CU875BBRjBVABzypTp","margin":"","location":{"start":{"line":45,"column":1,"offset":1700},"end":{"line":45,"column":107,"offset":1806}},"text":"text","content":["These methods may be implemented by the consumer for performance reasons or to provide a given capability."]},{"type":"block","id":"b5KD_G86Vpvso0Th199jE","margin":"","level":3,"name":"head","location":{"start":{"line":47,"column":1,"offset":1808},"end":{"line":47,"column":20,"offset":1827}},"content":["method BIND-POS"]},{"type":"block","id":"tqN2CvClYpAwbNmW91-Qm","margin":"","name":"code","config":[],"location":{"start":{"line":49,"column":1,"offset":1829},"end":{"line":49,"column":47,"offset":1875}},"content":[{"type":"verbatim","value":"method BIND-POS($position, $value) { ... }"}]},{"type":"para","id":"YczTlBRHCl27dR7ONaihe","margin":"","location":{"start":{"line":51,"column":1,"offset":1877},"end":{"line":51,"column":134,"offset":2010}},"text":"text","content":["Bind the given value to the given position in the array, and return the value. Will throw an exception if called and not implemented."]},{"type":"block","id":"fOZiCXzU5cWiPQU423ksN","margin":"","level":3,"name":"head","location":{"start":{"line":53,"column":1,"offset":2012},"end":{"line":53,"column":22,"offset":2033}},"content":["method DELETE-POS"]},{"type":"block","id":"S_Ie8bECMcnRukafXDix-","margin":"","name":"code","config":[],"location":{"start":{"line":55,"column":1,"offset":2035},"end":{"line":55,"column":41,"offset":2075}},"content":[{"type":"verbatim","value":"method DELETE-POS($position) { ... }"}]},{"type":"para","id":"XIPX3e1m-YfGRaFL8C4Yn","margin":"","location":{"start":{"line":57,"column":1,"offset":2077},"end":{"line":57,"column":171,"offset":2247}},"text":"text","content":["Mark the element at the given position in the array as absent (make ",{"type":"fcode","name":"C","content":["EXISTS-POS"]}," return ",{"type":"fcode","name":"C","content":["False"]}," for this position). Will throw an exception if called and not implemented."]},{"type":"block","id":"qd6iBDAx6vuH2QvCRXqfC","margin":"","level":3,"name":"head","location":{"start":{"line":59,"column":1,"offset":2249},"end":{"line":59,"column":22,"offset":2270}},"content":["method EXISTS-POS"]},{"type":"block","id":"K2hT2N6Yu-vwXqKjhik5G","margin":"","name":"code","config":[],"location":{"start":{"line":61,"column":1,"offset":2272},"end":{"line":61,"column":41,"offset":2312}},"content":[{"type":"verbatim","value":"method EXISTS-POS($position) { ... }"}]},{"type":"para","id":"blgHB9zzXrMGZuwsHzi6a","margin":"","location":{"start":{"line":63,"column":1,"offset":2314},"end":{"line":63,"column":201,"offset":2514}},"text":"text","content":["Return ",{"type":"fcode","name":"C","content":["Bool"]}," indicating whether the element at the given position exists (aka, is ",{"type":"fcode","name":"B","content":["not"]}," marked as absent). If not implemented, Will call ",{"type":"fcode","name":"C","content":["AT-POS"]}," and return ",{"type":"fcode","name":"C","content":["True"]}," if the returned value is defined."]},{"type":"block","id":"v6eZvb5SY48rVJV4GKKfZ","margin":"","level":3,"name":"head","location":{"start":{"line":65,"column":1,"offset":2516},"end":{"line":65,"column":17,"offset":2532}},"content":["method CLEAR"]},{"type":"block","id":"A5fY7NaPxWhRHSPRLLy-Z","margin":"","name":"code","config":[],"location":{"start":{"line":67,"column":1,"offset":2534},"end":{"line":67,"column":34,"offset":2567}},"content":[{"type":"verbatim","value":"method CLEAR(--> Nil) { ... }"}]},{"type":"para","id":"9zPzN3pLqcTui062UrWQv","margin":"","location":{"start":{"line":69,"column":1,"offset":2569},"end":{"line":69,"column":198,"offset":2766}},"text":"text","content":["Reset the array to have no elements at all. By default implemented by repeatedly calling ",{"type":"fcode","name":"C","content":["DELETE-POS"]},", which will by all means, be very slow. So it is a good idea to implement this method yourself."]},{"type":"block","id":"7YS1ZPSQ6d5HEye5hwd0E","margin":"","level":3,"name":"head","location":{"start":{"line":71,"column":1,"offset":2768},"end":{"line":71,"column":27,"offset":2794}},"content":["method move-indexes-up"]},{"type":"block","id":"iKmaviXe6gNBWIU6uIQMJ","margin":"","name":"code","config":[],"location":{"start":{"line":73,"column":1,"offset":2796},"end":{"line":73,"column":52,"offset":2847}},"content":[{"type":"verbatim","value":"method move-indexes-up($up, $start = 0) { ... }"}]},{"type":"para","id":"9P4RQxQ_29uc1LyLmMtgk","margin":"","location":{"start":{"line":75,"column":1,"offset":2849},"end":{"line":75,"column":284,"offset":3132}},"text":"text","content":["Add the given value to the ",{"type":"fcode","name":"B","content":["indexes"]}," of the elements in the array, optionally starting from a given start index value (by default 0, so all elements of the array will be affected). This functionality is needed if you want to be able to use ",{"type":"fcode","name":"C","content":["shift"]},", ",{"type":"fcode","name":"C","content":["unshift"]}," and related functions."]},{"type":"block","id":"8Eb3T96pGPDUqrf8J5d17","margin":"","level":3,"name":"head","location":{"start":{"line":77,"column":1,"offset":3134},"end":{"line":77,"column":29,"offset":3162}},"content":["method move-indexes-down"]},{"type":"block","id":"GMuBHSktdz8SA9AdbOA3u","margin":"","name":"code","config":[],"location":{"start":{"line":79,"column":1,"offset":3164},"end":{"line":79,"column":60,"offset":3223}},"content":[{"type":"verbatim","value":"method move-indexes-down($down, $start = $down) { ... }"}]},{"type":"para","id":"1brYW_wVlIj86wLV79EJ5","margin":"","location":{"start":{"line":81,"column":1,"offset":3225},"end":{"line":81,"column":326,"offset":3550}},"text":"text","content":["Subtract the given value to the ",{"type":"fcode","name":"B","content":["indexes"]}," of the elements in the array, optionally starting from a given start index value (by default the same as the number to subtract, so that all elements of the array will be affected. This functionality is needed if you want to be able to use ",{"type":"fcode","name":"C","content":["shift"]},", ",{"type":"fcode","name":"C","content":["unshift"]}," and related functions."]},{"type":"block","id":"veysHB2AIgoANqkGhuBo-","margin":"","level":2,"name":"head","location":{"start":{"line":83,"column":1,"offset":3552},"end":{"line":83,"column":24,"offset":3575}},"content":["Exported subroutines"]},{"type":"block","id":"nxRWmGPIjKkiCDZTtdlsK","margin":"","level":3,"name":"head","location":{"start":{"line":85,"column":1,"offset":3577},"end":{"line":85,"column":21,"offset":3597}},"content":["sub is-container"]},{"type":"block","id":"tJ-WMZqzsiyC1zdvk0vcH","margin":"","name":"code","config":[],"location":{"start":{"line":87,"column":1,"offset":3599},"end":{"line":89,"column":35,"offset":3683}},"content":[{"type":"verbatim","value":"my $a = 42;\nsay is-container($a);  # True\nsay is-container(42);  # False"}]},{"type":"para","id":"a8KDjDfsnuczBkSS9NDom","margin":"","location":{"start":{"line":91,"column":1,"offset":3685},"end":{"line":91,"column":207,"offset":3891}},"text":"text","content":["Returns whether the given argument is a container or not. This can be handy for situations where you want to also support binding, ",{"type":"fcode","name":"B","content":["and"]}," allow for methods such as ",{"type":"fcode","name":"C","content":["shift"]},", ",{"type":"fcode","name":"C","content":["unshift"]}," and related functions."]},{"type":"block","id":"By9u4jXpOeKXFh5Ig4lnA","margin":"","level":1,"name":"head","location":{"start":{"line":93,"column":1,"offset":3893},"end":{"line":93,"column":9,"offset":3901}},"content":["AUTHOR"]},{"type":"para","id":"kM767tsnk38bfbEWLrSkF","margin":"","location":{"start":{"line":95,"column":1,"offset":3903},"end":{"line":95,"column":37,"offset":3939}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"Ry5gRvp1z2oWLx9j5DZtw","margin":"","location":{"start":{"line":97,"column":1,"offset":3941},"end":{"line":97,"column":109,"offset":4049}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/Array-Agnostic","type":"fcode","name":"L","content":["https://github.com/lizmat/Array-Agnostic"]}," . Comments and Pull Requests are welcome."]},{"type":"block","id":"KDh72xi37IgGOWCDi5i1r","margin":"","level":1,"name":"head","location":{"start":{"line":99,"column":1,"offset":4051},"end":{"line":99,"column":24,"offset":4074}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"2_vJY4L2sbiw8Y05ff721","margin":"","location":{"start":{"line":101,"column":1,"offset":4076},"end":{"line":101,"column":47,"offset":4122}},"text":"text","content":["Copyright 2018, 2020, 2021 Elizabeth Mattijsen"]},{"type":"para","id":"X0zXRlpSHn24cvPkdCze9","margin":"","location":{"start":{"line":103,"column":1,"offset":4124},"end":{"line":103,"column":104,"offset":4227}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/Array::Agnostic/Array-Agnostic-0.0.10/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"be an array without knowing how","dist":"Array::Agnostic:ver<0.0.10>:auth<zef:lizmat>","license":"Artistic-2.0","name":"Array::Agnostic","path":"A/RR/ARRAY_AGNOSTIC/35768879cbb21c139dec01ad882173ce4701f7d8.tar.gz","perl":"6.d","provides":{"Array::Agnostic":"lib/Array/Agnostic.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/Array-Agnostic.git","tags":["UTILS"],"test-depends":[],"version":"0.0.10"},"files":[{"file":"work_mods/zef/Array::Agnostic/Array-Agnostic-0.0.10/README.md","publishUrl":"/mods/zef/Array::Agnostic/Array-Agnostic-0.0.10/README.md"},{"file":"work_mods/zef/Array::Agnostic/Array-Agnostic-0.0.10/lib/Array/Agnostic.rakumod","publishUrl":"/mods/zef/Array::Agnostic/Array-Agnostic-0.0.10/lib/Array/Agnostic.rakumod"}],"src":"zef","url":"/mods/zef/Array::Agnostic"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Array::Agnostic/Array-Agnostic-0.0.10/README.md","sources":[],"node":{"type":"block","id":"mFiJCL4K05pQoHuJceIU4","margin":"","name":"root","content":[{"type":"para","id":"fDMnB7Z4fr1imC0glMK4m","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":137,"offset":136}},"text":"text","content":[{"meta":"https://github.com/lizmat/Array-Agnostic/actions","type":"fcode","name":"L","content":[{"type":"block","id":"swV518_m7B-DJ4lKtPdDy","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":86,"offset":85}},"content":[{"type":"image","src":"https://github.com/lizmat/Array-Agnostic/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"asV7r3RFPm3BdkPZuO38m","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":138},"end":{"line":3,"column":7,"offset":144}},"content":["NAME"]},{"type":"para","id":"YgwP9_B_Rjbf9z1IWFxMT","margin":"","location":{"start":{"line":5,"column":1,"offset":146},"end":{"line":5,"column":50,"offset":195}},"text":"text","content":["Array::Agnostic - be an array without knowing how"]},{"type":"block","id":"-upZLiopC4tLRgZDZcahg","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":197},"end":{"line":7,"column":11,"offset":207}},"content":["SYNOPSIS"]},{"type":"block","id":"1bKH8pWpivjakHJPdcdFl","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":209},"end":{"line":15,"column":30,"offset":383}},"content":[{"type":"verbatim","value":"use Array::Agnostic;\nclass MyArray does Array::Agnostic {\n    method AT-POS()     { ... }\n    method elems()      { ... }\n}\n\nmy @a is MyArray = 1,2,3;"}]},{"type":"block","id":"lqHGTDelUPUkgFgMqBERv","margin":"","level":1,"name":"head","location":{"start":{"line":17,"column":1,"offset":385},"end":{"line":17,"column":14,"offset":398}},"content":["DESCRIPTION"]},{"type":"para","id":"qi3350Ssj_kX1GAAnZYdg","margin":"","location":{"start":{"line":19,"column":1,"offset":400},"end":{"line":19,"column":220,"offset":619}},"text":"text","content":["This module makes an ",{"type":"fcode","name":"C","content":["Array::Agnostic"]}," role available for those classes that wish to implement the ",{"type":"fcode","name":"C","content":["Positional"]}," role as an ",{"type":"fcode","name":"C","content":["Array"]},". It provides all of the ",{"type":"fcode","name":"C","content":["Array"]}," functionality while only needing to implement 2 methods:"]},{"type":"block","id":"oJB_ITFTrzD5cJyFnMd37","margin":"","level":2,"name":"head","location":{"start":{"line":21,"column":1,"offset":621},"end":{"line":21,"column":20,"offset":640}},"content":["Required Methods"]},{"type":"block","id":"6Kkc6qXtv35IoWJGMAgnE","margin":"","level":3,"name":"head","location":{"start":{"line":23,"column":1,"offset":642},"end":{"line":23,"column":18,"offset":659}},"content":["method AT-POS"]},{"type":"block","id":"Z19vs7QBL_iqi03BzSaAE","margin":"","name":"code","config":[],"location":{"start":{"line":25,"column":1,"offset":661},"end":{"line":27,"column":79,"offset":792}},"content":[{"type":"verbatim","value":"method AT-POS($position) { ... }  # simple case\n\nmethod AT-POS($position) { Proxy.new( FETCH => { ... }, STORE => { ... } }"}]},{"type":"para","id":"8JxD4Eh2D8PNfjHtp5j1U","margin":"","location":{"start":{"line":29,"column":1,"offset":794},"end":{"line":29,"column":179,"offset":972}},"text":"text","content":["Return the value at the given position in the array. Must return a ",{"type":"fcode","name":"C","content":["Proxy"]}," that will assign to that position if you wish to allow for auto-vivification of elements in your array."]},{"type":"block","id":"1vYjJPxEegaB5ST-nd7k3","margin":"","level":3,"name":"head","location":{"start":{"line":31,"column":1,"offset":974},"end":{"line":31,"column":17,"offset":990}},"content":["method elems"]},{"type":"block","id":"vXkbYut0XByRYgabQyiYm","margin":"","name":"code","config":[],"location":{"start":{"line":33,"column":1,"offset":992},"end":{"line":33,"column":36,"offset":1027}},"content":[{"type":"verbatim","value":"method elems(--> Int:D) { ... }"}]},{"type":"para","id":"9Oz7zld8XxXXQzmnPdOEV","margin":"","location":{"start":{"line":35,"column":1,"offset":1029},"end":{"line":35,"column":94,"offset":1122}},"text":"text","content":["Return the number of elements in the array (defined as the index of the highest element + 1)."]},{"type":"block","id":"J6mXQQVfO7TasqDlCs4Bl","margin":"","level":2,"name":"head","location":{"start":{"line":37,"column":1,"offset":1124},"end":{"line":37,"column":39,"offset":1162}},"content":["Optional Methods (provided by role)"]},{"type":"para","id":"lmjg7WHE6izbFNU2WbIH6","margin":"","location":{"start":{"line":39,"column":1,"offset":1164},"end":{"line":39,"column":242,"offset":1405}},"text":"text","content":["You may implement these methods out of performance reasons yourself, but you don't have to as an implementation is provided by this role. They follow the same semantics as the methods on the ",{"meta":"https://docs.perl6.org/type/Array","type":"fcode","name":"L","content":["Array object"]},"."]},{"type":"para","id":"v_wzNsjtVlUG2YuMJamis","margin":"","location":{"start":{"line":41,"column":1,"offset":1407},"end":{"line":41,"column":243,"offset":1649}},"text":"text","content":["In alphabetical order: ",{"type":"fcode","name":"C","content":["append"]},", ",{"type":"fcode","name":"C","content":["Array"]},", ",{"type":"fcode","name":"C","content":["ASSIGN-POS"]},", ",{"type":"fcode","name":"C","content":["end"]},", ",{"type":"fcode","name":"C","content":["gist"]},", ",{"type":"fcode","name":"C","content":["grab"]},", ",{"type":"fcode","name":"C","content":["iterator"]},", ",{"type":"fcode","name":"C","content":["keys"]},", ",{"type":"fcode","name":"C","content":["kv"]},", ",{"type":"fcode","name":"C","content":["list"]},", ",{"type":"fcode","name":"C","content":["List"]},", ",{"type":"fcode","name":"C","content":["new"]},", ",{"type":"fcode","name":"C","content":["pairs"]},", ",{"type":"fcode","name":"C","content":["perl"]},", ",{"type":"fcode","name":"C","content":["pop"]},", ",{"type":"fcode","name":"C","content":["prepend"]},", ",{"type":"fcode","name":"C","content":["push"]},", ",{"type":"fcode","name":"C","content":["shape"]},", ",{"type":"fcode","name":"C","content":["shift"]},", ",{"type":"fcode","name":"C","content":["Slip"]},", ",{"type":"fcode","name":"C","content":["STORE"]},", ",{"type":"fcode","name":"C","content":["Str"]},", ",{"type":"fcode","name":"C","content":["splice"]},", ",{"type":"fcode","name":"C","content":["unshift"]},", ",{"type":"fcode","name":"C","content":["values"]}]},{"type":"block","id":"kMLqkr_3lagCkB2xvJL9S","margin":"","level":2,"name":"head","location":{"start":{"line":43,"column":1,"offset":1651},"end":{"line":43,"column":48,"offset":1698}},"content":["Optional Internal Methods (provided by role)"]},{"type":"para","id":"BB9CU875BBRjBVABzypTp","margin":"","location":{"start":{"line":45,"column":1,"offset":1700},"end":{"line":45,"column":107,"offset":1806}},"text":"text","content":["These methods may be implemented by the consumer for performance reasons or to provide a given capability."]},{"type":"block","id":"b5KD_G86Vpvso0Th199jE","margin":"","level":3,"name":"head","location":{"start":{"line":47,"column":1,"offset":1808},"end":{"line":47,"column":20,"offset":1827}},"content":["method BIND-POS"]},{"type":"block","id":"tqN2CvClYpAwbNmW91-Qm","margin":"","name":"code","config":[],"location":{"start":{"line":49,"column":1,"offset":1829},"end":{"line":49,"column":47,"offset":1875}},"content":[{"type":"verbatim","value":"method BIND-POS($position, $value) { ... }"}]},{"type":"para","id":"YczTlBRHCl27dR7ONaihe","margin":"","location":{"start":{"line":51,"column":1,"offset":1877},"end":{"line":51,"column":134,"offset":2010}},"text":"text","content":["Bind the given value to the given position in the array, and return the value. Will throw an exception if called and not implemented."]},{"type":"block","id":"fOZiCXzU5cWiPQU423ksN","margin":"","level":3,"name":"head","location":{"start":{"line":53,"column":1,"offset":2012},"end":{"line":53,"column":22,"offset":2033}},"content":["method DELETE-POS"]},{"type":"block","id":"S_Ie8bECMcnRukafXDix-","margin":"","name":"code","config":[],"location":{"start":{"line":55,"column":1,"offset":2035},"end":{"line":55,"column":41,"offset":2075}},"content":[{"type":"verbatim","value":"method DELETE-POS($position) { ... }"}]},{"type":"para","id":"XIPX3e1m-YfGRaFL8C4Yn","margin":"","location":{"start":{"line":57,"column":1,"offset":2077},"end":{"line":57,"column":171,"offset":2247}},"text":"text","content":["Mark the element at the given position in the array as absent (make ",{"type":"fcode","name":"C","content":["EXISTS-POS"]}," return ",{"type":"fcode","name":"C","content":["False"]}," for this position). Will throw an exception if called and not implemented."]},{"type":"block","id":"qd6iBDAx6vuH2QvCRXqfC","margin":"","level":3,"name":"head","location":{"start":{"line":59,"column":1,"offset":2249},"end":{"line":59,"column":22,"offset":2270}},"content":["method EXISTS-POS"]},{"type":"block","id":"K2hT2N6Yu-vwXqKjhik5G","margin":"","name":"code","config":[],"location":{"start":{"line":61,"column":1,"offset":2272},"end":{"line":61,"column":41,"offset":2312}},"content":[{"type":"verbatim","value":"method EXISTS-POS($position) { ... }"}]},{"type":"para","id":"blgHB9zzXrMGZuwsHzi6a","margin":"","location":{"start":{"line":63,"column":1,"offset":2314},"end":{"line":63,"column":201,"offset":2514}},"text":"text","content":["Return ",{"type":"fcode","name":"C","content":["Bool"]}," indicating whether the element at the given position exists (aka, is ",{"type":"fcode","name":"B","content":["not"]}," marked as absent). If not implemented, Will call ",{"type":"fcode","name":"C","content":["AT-POS"]}," and return ",{"type":"fcode","name":"C","content":["True"]}," if the returned value is defined."]},{"type":"block","id":"v6eZvb5SY48rVJV4GKKfZ","margin":"","level":3,"name":"head","location":{"start":{"line":65,"column":1,"offset":2516},"end":{"line":65,"column":17,"offset":2532}},"content":["method CLEAR"]},{"type":"block","id":"A5fY7NaPxWhRHSPRLLy-Z","margin":"","name":"code","config":[],"location":{"start":{"line":67,"column":1,"offset":2534},"end":{"line":67,"column":34,"offset":2567}},"content":[{"type":"verbatim","value":"method CLEAR(--> Nil) { ... }"}]},{"type":"para","id":"9zPzN3pLqcTui062UrWQv","margin":"","location":{"start":{"line":69,"column":1,"offset":2569},"end":{"line":69,"column":198,"offset":2766}},"text":"text","content":["Reset the array to have no elements at all. By default implemented by repeatedly calling ",{"type":"fcode","name":"C","content":["DELETE-POS"]},", which will by all means, be very slow. So it is a good idea to implement this method yourself."]},{"type":"block","id":"7YS1ZPSQ6d5HEye5hwd0E","margin":"","level":3,"name":"head","location":{"start":{"line":71,"column":1,"offset":2768},"end":{"line":71,"column":27,"offset":2794}},"content":["method move-indexes-up"]},{"type":"block","id":"iKmaviXe6gNBWIU6uIQMJ","margin":"","name":"code","config":[],"location":{"start":{"line":73,"column":1,"offset":2796},"end":{"line":73,"column":52,"offset":2847}},"content":[{"type":"verbatim","value":"method move-indexes-up($up, $start = 0) { ... }"}]},{"type":"para","id":"9P4RQxQ_29uc1LyLmMtgk","margin":"","location":{"start":{"line":75,"column":1,"offset":2849},"end":{"line":75,"column":284,"offset":3132}},"text":"text","content":["Add the given value to the ",{"type":"fcode","name":"B","content":["indexes"]}," of the elements in the array, optionally starting from a given start index value (by default 0, so all elements of the array will be affected). This functionality is needed if you want to be able to use ",{"type":"fcode","name":"C","content":["shift"]},", ",{"type":"fcode","name":"C","content":["unshift"]}," and related functions."]},{"type":"block","id":"8Eb3T96pGPDUqrf8J5d17","margin":"","level":3,"name":"head","location":{"start":{"line":77,"column":1,"offset":3134},"end":{"line":77,"column":29,"offset":3162}},"content":["method move-indexes-down"]},{"type":"block","id":"GMuBHSktdz8SA9AdbOA3u","margin":"","name":"code","config":[],"location":{"start":{"line":79,"column":1,"offset":3164},"end":{"line":79,"column":60,"offset":3223}},"content":[{"type":"verbatim","value":"method move-indexes-down($down, $start = $down) { ... }"}]},{"type":"para","id":"1brYW_wVlIj86wLV79EJ5","margin":"","location":{"start":{"line":81,"column":1,"offset":3225},"end":{"line":81,"column":326,"offset":3550}},"text":"text","content":["Subtract the given value to the ",{"type":"fcode","name":"B","content":["indexes"]}," of the elements in the array, optionally starting from a given start index value (by default the same as the number to subtract, so that all elements of the array will be affected. This functionality is needed if you want to be able to use ",{"type":"fcode","name":"C","content":["shift"]},", ",{"type":"fcode","name":"C","content":["unshift"]}," and related functions."]},{"type":"block","id":"veysHB2AIgoANqkGhuBo-","margin":"","level":2,"name":"head","location":{"start":{"line":83,"column":1,"offset":3552},"end":{"line":83,"column":24,"offset":3575}},"content":["Exported subroutines"]},{"type":"block","id":"nxRWmGPIjKkiCDZTtdlsK","margin":"","level":3,"name":"head","location":{"start":{"line":85,"column":1,"offset":3577},"end":{"line":85,"column":21,"offset":3597}},"content":["sub is-container"]},{"type":"block","id":"tJ-WMZqzsiyC1zdvk0vcH","margin":"","name":"code","config":[],"location":{"start":{"line":87,"column":1,"offset":3599},"end":{"line":89,"column":35,"offset":3683}},"content":[{"type":"verbatim","value":"my $a = 42;\nsay is-container($a);  # True\nsay is-container(42);  # False"}]},{"type":"para","id":"a8KDjDfsnuczBkSS9NDom","margin":"","location":{"start":{"line":91,"column":1,"offset":3685},"end":{"line":91,"column":207,"offset":3891}},"text":"text","content":["Returns whether the given argument is a container or not. This can be handy for situations where you want to also support binding, ",{"type":"fcode","name":"B","content":["and"]}," allow for methods such as ",{"type":"fcode","name":"C","content":["shift"]},", ",{"type":"fcode","name":"C","content":["unshift"]}," and related functions."]},{"type":"block","id":"By9u4jXpOeKXFh5Ig4lnA","margin":"","level":1,"name":"head","location":{"start":{"line":93,"column":1,"offset":3893},"end":{"line":93,"column":9,"offset":3901}},"content":["AUTHOR"]},{"type":"para","id":"kM767tsnk38bfbEWLrSkF","margin":"","location":{"start":{"line":95,"column":1,"offset":3903},"end":{"line":95,"column":37,"offset":3939}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"Ry5gRvp1z2oWLx9j5DZtw","margin":"","location":{"start":{"line":97,"column":1,"offset":3941},"end":{"line":97,"column":109,"offset":4049}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/Array-Agnostic","type":"fcode","name":"L","content":["https://github.com/lizmat/Array-Agnostic"]}," . Comments and Pull Requests are welcome."]},{"type":"block","id":"KDh72xi37IgGOWCDi5i1r","margin":"","level":1,"name":"head","location":{"start":{"line":99,"column":1,"offset":4051},"end":{"line":99,"column":24,"offset":4074}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"2_vJY4L2sbiw8Y05ff721","margin":"","location":{"start":{"line":101,"column":1,"offset":4076},"end":{"line":101,"column":47,"offset":4122}},"text":"text","content":["Copyright 2018, 2020, 2021 Elizabeth Mattijsen"]},{"type":"para","id":"X0zXRlpSHn24cvPkdCze9","margin":"","location":{"start":{"line":103,"column":1,"offset":4124},"end":{"line":103,"column":104,"offset":4227}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/Array::Agnostic/Array-Agnostic-0.0.10/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"be an array without knowing how","dist":"Array::Agnostic:ver<0.0.10>:auth<zef:lizmat>","license":"Artistic-2.0","name":"Array::Agnostic","path":"A/RR/ARRAY_AGNOSTIC/35768879cbb21c139dec01ad882173ce4701f7d8.tar.gz","perl":"6.d","provides":{"Array::Agnostic":"lib/Array/Agnostic.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/Array-Agnostic.git","tags":["UTILS"],"test-depends":[],"version":"0.0.10"},"files":[{"file":"work_mods/zef/Array::Agnostic/Array-Agnostic-0.0.10/README.md","publishUrl":"/mods/zef/Array::Agnostic/Array-Agnostic-0.0.10/README.md"},{"file":"work_mods/zef/Array::Agnostic/Array-Agnostic-0.0.10/lib/Array/Agnostic.rakumod","publishUrl":"/mods/zef/Array::Agnostic/Array-Agnostic-0.0.10/lib/Array/Agnostic.rakumod"}],"src":"zef","url":"/mods/zef/Array::Agnostic"}}}
    =end data
    =end React


be an array without knowing how


Array::Agnostic


The Raku Knowledge Base


=begin React :component<HeaderCol> :id<footer>  
=begin nested :!nested
=item1 B<Language>
    =item2 L<Get started|file:../getting-started/getting-started.podlite>
    =item2 L<Why Raku?|/doc/language/faq#Why-should-I-learn-Raku-What's-so-great-about-it>
    =item2 L<Try Raku|https://glot.io/new/raku>
    =item2 L<Raku cheat sheet|https://github.com/Raku/mu/blob/master/docs/Perl6/Cheatsheet/cheatsheet.txt>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<Raku on Exercism|https://exercism.org/tracks/raku>
    =item2 L<Wikipedia|https://en.wikipedia.org/wiki/Raku_(programming_language)>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=begin nested :!nested

=item1 B<L<Documentation|/doc>>
    =item2 L<Getting started, Migration guides from other languages, & Tutorials | file:../doc/introduction.podlite>
    =item2 L<Language References|file:../doc/reference.podlite>
    =item2 L<Type Reference| file:../doc/types.podlite>
    =item2 L<Miscellaneous| file:../doc/miscellaneous.podlite>
    =item2 L<FAQs (Frequently Asked Questions)|/doc/language/faq>
    =item2 L<Community|/doc/language/community>
    =item2 L<The list of all documents|file:../doc/index.podlite>

=item1 B<Resources>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>

=end nested
=begin nested :!nested

=item1 B<Resoures>
    =item2 L<Download | file:../download/index.podlite>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=item1 B<Learning>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Wikibook |https://en.wikibooks.org/wiki/Raku_Programming>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>
    =item2 L<Learn Raku in Y minutes|https://learnxinyminutes.com/docs/raku/>
    =item2 L<Golfing |https://github.com/AlexDaniel/raku-golf-cheatsheet>
=end nested
=begin nested :!nested

=item1 B<Explore>
    =item2 L<Raku Blog Aggregator|https://planet.raku.org/>
    =item2 L<Rakudo Weekly|https://rakudoweekly.blog/>
    =item2 L<The Weekly Challenge |https://perlweeklychallenge.org/>
    =item2 L<Raku Advent Calendar|https://raku-advent.blog/>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=end React


=begin React :component<CookieConsent> :id<CookieConsent> :buttonCaption("Got it!")
=para
This website uses cookies for analytics.
=end React


Array::Circular

NAME

SYNOPSIS

DESCRIPTION

AUTHOR

COPYRIGHT AND LICENSE

Array::Circular v0.0.4

Authors

License

Dependencies

Test Dependencies

Provides

Documentation