TITLE

Helper subroutines for working with Raku Native Arrays (CArray)


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/NativeHelpers::Array/NativeHelpers-Array-0.0.5/README.md","sources":[],"node":{"type":"block","id":"74GhsxIdah-NAob7IHvDa","margin":"","name":"root","content":[{"type":"block","id":"YXYeXpFhJqcjAiTm6_Cul","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":23,"offset":22}},"content":["NativeHelpers::Array"]},{"type":"para","id":"RMNr2UZHJQhgaUoevmNQ9","margin":"","location":{"start":{"line":3,"column":1,"offset":24},"end":{"line":3,"column":64,"offset":87}},"text":"text","content":["Helper subroutines for working with Raku Native Arrays (CArray)"]},{"type":"para","id":"Z33Puh4Hv1qqlyCRvAuKI","margin":"","location":{"start":{"line":5,"column":1,"offset":89},"end":{"line":5,"column":93,"offset":181}},"text":"text","content":[{"type":"block","id":"AdphQdQS6rc4QZZPaZZVi","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":89},"end":{"line":5,"column":93,"offset":181}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/NativeHelpers-Array/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"1Pj08cJ7hFat6J4GtIJhL","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":183},"end":{"line":7,"column":15,"offset":197}},"content":["Description"]},{"type":"para","id":"5zG7APkwQ-OngzxQ7fZZv","margin":"","location":{"start":{"line":9,"column":1,"offset":199},"end":{"line":10,"column":57,"offset":317}},"text":"text","content":["This provides a number of exported subroutines that may prove\nuseful when dealing with array data in a native binding."]},{"type":"para","id":"emk5Q0f0p32qwbMw1L30z","margin":"","location":{"start":{"line":12,"column":1,"offset":319},"end":{"line":14,"column":39,"offset":479}},"text":"text","content":["The subroutines themselves are not particularly sophisticated\nbut having them in a separate module saves copying the code\ninto modules where they may be useful."]},{"type":"block","id":"J3vmGvOUP4hYpqhUMGF75","margin":"","level":2,"name":"head","location":{"start":{"line":16,"column":1,"offset":481},"end":{"line":16,"column":16,"offset":496}},"content":["Installation"]},{"type":"para","id":"pye0Q7PnbRCchFOnSJ43Q","margin":"","location":{"start":{"line":18,"column":1,"offset":498},"end":{"line":18,"column":94,"offset":591}},"text":"text","content":["Assuming you have a working raku installation you should be able to install this with ",{"type":"fcode","name":"I","content":["zef"]}," :"]},{"type":"block","id":"QwEmYVlCeYPLKjwEM9Yke","margin":"","name":"code","config":[],"location":{"start":{"line":20,"column":1,"offset":593},"end":{"line":20,"column":18,"offset":610}},"content":[{"type":"verbatim","value":"zef install ."}]},{"type":"para","id":"ltjj-VUp2nQSW9seeWL6m","margin":"","location":{"start":{"line":22,"column":1,"offset":612},"end":{"line":22,"column":20,"offset":631}},"text":"text","content":["Remote installation"]},{"type":"block","id":"qkeE-T2L-ZbhQ2n8wdddp","margin":"","name":"code","config":[],"location":{"start":{"line":24,"column":1,"offset":633},"end":{"line":24,"column":37,"offset":669}},"content":[{"type":"verbatim","value":"zef install NativeHelpers::Array"}]},{"type":"para","id":"DV-ALfQDOkVfKxRLAahuQ","margin":"","location":{"start":{"line":26,"column":1,"offset":671},"end":{"line":26,"column":64,"offset":734}},"text":"text","content":["Other install mechanisms may be become available in the future."]},{"type":"block","id":"gXl8EPQMhbqMgXglcDNyo","margin":"","level":2,"name":"head","location":{"start":{"line":28,"column":1,"offset":736},"end":{"line":28,"column":11,"offset":746}},"content":["Support"]},{"type":"para","id":"D2YaKBNA_3D4mFkM_0_fz","margin":"","location":{"start":{"line":30,"column":1,"offset":748},"end":{"line":30,"column":107,"offset":854}},"text":"text","content":["Suggestions/patches are welcomed via github at ",{"meta":"https://github.com/jonathanstowe/NativeHelpers-Array/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/NativeHelpers-Array/issues"]}]},{"type":"block","id":"3VjSgB1wYofu-Sup0ng7D","margin":"","level":2,"name":"head","location":{"start":{"line":32,"column":1,"offset":856},"end":{"line":32,"column":11,"offset":866}},"content":["Licence"]},{"type":"para","id":"7R2QhwV_nt4flHPXZrjac","margin":"","location":{"start":{"line":34,"column":1,"offset":868},"end":{"line":34,"column":23,"offset":890}},"text":"text","content":["This is free software."]},{"type":"para","id":"8GtCB6EIw2ofbss8sp5pZ","margin":"","location":{"start":{"line":36,"column":1,"offset":892},"end":{"line":36,"column":72,"offset":963}},"text":"text","content":["Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in the distribution for details."]},{"type":"para","id":"ECEJ3AbpyB1WFkKz9aDoi","margin":"","location":{"start":{"line":38,"column":1,"offset":965},"end":{"line":38,"column":29,"offset":993}},"text":"text","content":["© Jonathan Stowe 2015 - 2021"]}]},"publishUrl":"/mods/zef/NativeHelpers::Array/NativeHelpers-Array-0.0.5/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","author":"Jonathan Stowe <jns+git@gellyfish.co.uk>","authors":["Jonathan Stowe <jns+git@gellyfish.co.uk>"],"build-depends":[],"depends":[],"description":"Helper subroutines for working with Raku Native Arrays (CArray)","dist":"NativeHelpers::Array:ver<0.0.5>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"NativeHelpers::Array","path":"N/AT/NATIVEHELPERS_ARRAY/a34da6a03530ec3a98ea25f0f7ba0a37e9e68aac.tar.gz","provides":{"NativeHelpers::Array":"lib/NativeHelpers/Array.pm"},"raku":"6.*","resources":[],"source-url":"git://github.com/jonathanstowe/NativeHelpers-Array.git","support":{"bugtracker":"https://github.com/jonathanstowe/NativeHelpers-Array/issues","source":"git://github.com/jonathanstowe/NativeHelpers-Array.git"},"tags":["utils","native","array"],"test-depends":[],"version":"0.0.5"},"files":[{"file":"work_mods/zef/NativeHelpers::Array/NativeHelpers-Array-0.0.5/README.md","publishUrl":"/mods/zef/NativeHelpers::Array/NativeHelpers-Array-0.0.5/README.md"},{"file":"work_mods/zef/NativeHelpers::Array/NativeHelpers-Array-0.0.5/lib/NativeHelpers/Array.pm","publishUrl":"/mods/zef/NativeHelpers::Array/NativeHelpers-Array-0.0.5/lib/NativeHelpers/Array.pm"}],"src":"zef","url":"/mods/zef/NativeHelpers::Array"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/NativeHelpers::Array/NativeHelpers-Array-0.0.5/README.md","sources":[],"node":{"type":"block","id":"74GhsxIdah-NAob7IHvDa","margin":"","name":"root","content":[{"type":"block","id":"YXYeXpFhJqcjAiTm6_Cul","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":23,"offset":22}},"content":["NativeHelpers::Array"]},{"type":"para","id":"RMNr2UZHJQhgaUoevmNQ9","margin":"","location":{"start":{"line":3,"column":1,"offset":24},"end":{"line":3,"column":64,"offset":87}},"text":"text","content":["Helper subroutines for working with Raku Native Arrays (CArray)"]},{"type":"para","id":"Z33Puh4Hv1qqlyCRvAuKI","margin":"","location":{"start":{"line":5,"column":1,"offset":89},"end":{"line":5,"column":93,"offset":181}},"text":"text","content":[{"type":"block","id":"AdphQdQS6rc4QZZPaZZVi","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":89},"end":{"line":5,"column":93,"offset":181}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/NativeHelpers-Array/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"1Pj08cJ7hFat6J4GtIJhL","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":183},"end":{"line":7,"column":15,"offset":197}},"content":["Description"]},{"type":"para","id":"5zG7APkwQ-OngzxQ7fZZv","margin":"","location":{"start":{"line":9,"column":1,"offset":199},"end":{"line":10,"column":57,"offset":317}},"text":"text","content":["This provides a number of exported subroutines that may prove\nuseful when dealing with array data in a native binding."]},{"type":"para","id":"emk5Q0f0p32qwbMw1L30z","margin":"","location":{"start":{"line":12,"column":1,"offset":319},"end":{"line":14,"column":39,"offset":479}},"text":"text","content":["The subroutines themselves are not particularly sophisticated\nbut having them in a separate module saves copying the code\ninto modules where they may be useful."]},{"type":"block","id":"J3vmGvOUP4hYpqhUMGF75","margin":"","level":2,"name":"head","location":{"start":{"line":16,"column":1,"offset":481},"end":{"line":16,"column":16,"offset":496}},"content":["Installation"]},{"type":"para","id":"pye0Q7PnbRCchFOnSJ43Q","margin":"","location":{"start":{"line":18,"column":1,"offset":498},"end":{"line":18,"column":94,"offset":591}},"text":"text","content":["Assuming you have a working raku installation you should be able to install this with ",{"type":"fcode","name":"I","content":["zef"]}," :"]},{"type":"block","id":"QwEmYVlCeYPLKjwEM9Yke","margin":"","name":"code","config":[],"location":{"start":{"line":20,"column":1,"offset":593},"end":{"line":20,"column":18,"offset":610}},"content":[{"type":"verbatim","value":"zef install ."}]},{"type":"para","id":"ltjj-VUp2nQSW9seeWL6m","margin":"","location":{"start":{"line":22,"column":1,"offset":612},"end":{"line":22,"column":20,"offset":631}},"text":"text","content":["Remote installation"]},{"type":"block","id":"qkeE-T2L-ZbhQ2n8wdddp","margin":"","name":"code","config":[],"location":{"start":{"line":24,"column":1,"offset":633},"end":{"line":24,"column":37,"offset":669}},"content":[{"type":"verbatim","value":"zef install NativeHelpers::Array"}]},{"type":"para","id":"DV-ALfQDOkVfKxRLAahuQ","margin":"","location":{"start":{"line":26,"column":1,"offset":671},"end":{"line":26,"column":64,"offset":734}},"text":"text","content":["Other install mechanisms may be become available in the future."]},{"type":"block","id":"gXl8EPQMhbqMgXglcDNyo","margin":"","level":2,"name":"head","location":{"start":{"line":28,"column":1,"offset":736},"end":{"line":28,"column":11,"offset":746}},"content":["Support"]},{"type":"para","id":"D2YaKBNA_3D4mFkM_0_fz","margin":"","location":{"start":{"line":30,"column":1,"offset":748},"end":{"line":30,"column":107,"offset":854}},"text":"text","content":["Suggestions/patches are welcomed via github at ",{"meta":"https://github.com/jonathanstowe/NativeHelpers-Array/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/NativeHelpers-Array/issues"]}]},{"type":"block","id":"3VjSgB1wYofu-Sup0ng7D","margin":"","level":2,"name":"head","location":{"start":{"line":32,"column":1,"offset":856},"end":{"line":32,"column":11,"offset":866}},"content":["Licence"]},{"type":"para","id":"7R2QhwV_nt4flHPXZrjac","margin":"","location":{"start":{"line":34,"column":1,"offset":868},"end":{"line":34,"column":23,"offset":890}},"text":"text","content":["This is free software."]},{"type":"para","id":"8GtCB6EIw2ofbss8sp5pZ","margin":"","location":{"start":{"line":36,"column":1,"offset":892},"end":{"line":36,"column":72,"offset":963}},"text":"text","content":["Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in the distribution for details."]},{"type":"para","id":"ECEJ3AbpyB1WFkKz9aDoi","margin":"","location":{"start":{"line":38,"column":1,"offset":965},"end":{"line":38,"column":29,"offset":993}},"text":"text","content":["© Jonathan Stowe 2015 - 2021"]}]},"publishUrl":"/mods/zef/NativeHelpers::Array/NativeHelpers-Array-0.0.5/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","author":"Jonathan Stowe <jns+git@gellyfish.co.uk>","authors":["Jonathan Stowe <jns+git@gellyfish.co.uk>"],"build-depends":[],"depends":[],"description":"Helper subroutines for working with Raku Native Arrays (CArray)","dist":"NativeHelpers::Array:ver<0.0.5>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"NativeHelpers::Array","path":"N/AT/NATIVEHELPERS_ARRAY/a34da6a03530ec3a98ea25f0f7ba0a37e9e68aac.tar.gz","provides":{"NativeHelpers::Array":"lib/NativeHelpers/Array.pm"},"raku":"6.*","resources":[],"source-url":"git://github.com/jonathanstowe/NativeHelpers-Array.git","support":{"bugtracker":"https://github.com/jonathanstowe/NativeHelpers-Array/issues","source":"git://github.com/jonathanstowe/NativeHelpers-Array.git"},"tags":["utils","native","array"],"test-depends":[],"version":"0.0.5"},"files":[{"file":"work_mods/zef/NativeHelpers::Array/NativeHelpers-Array-0.0.5/README.md","publishUrl":"/mods/zef/NativeHelpers::Array/NativeHelpers-Array-0.0.5/README.md"},{"file":"work_mods/zef/NativeHelpers::Array/NativeHelpers-Array-0.0.5/lib/NativeHelpers/Array.pm","publishUrl":"/mods/zef/NativeHelpers::Array/NativeHelpers-Array-0.0.5/lib/NativeHelpers/Array.pm"}],"src":"zef","url":"/mods/zef/NativeHelpers::Array"}}}
    =end data
    =end React


root

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

NativeHelpers::Array


Compile a search needle specification


Needle::Compile


Endian safe Binary Struct packing and unpacking


=begin data
{"type":"page","file":"work_mods/zef/Native::Packing/Native-Packing-0.0.5/README.md","sources":[],"node":{"type":"block","id":"P_kmbWPTuHWujgG69FXsf","margin":"","name":"root","content":[{"type":"block","id":"mDpHY3j8DTuSa-_vK2N_e","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":22,"offset":21}},"content":["Native-Packing-raku"]},{"type":"para","id":"YBA1OBrHkoIcdTIOuGcuV","margin":"","location":{"start":{"line":3,"column":1,"offset":23},"end":{"line":3,"column":140,"offset":162}},"text":"text","content":[{"meta":"https://travis-ci.org/pdf-raku/Native-Packing-raku","type":"fcode","name":"L","content":[{"type":"block","id":"4DbaN6cVvH0dSsxmNb3AC","margin":"","name":"Image","config":[],"location":{"start":{"line":3,"column":2,"offset":24},"end":{"line":3,"column":87,"offset":109}},"content":[{"type":"image","src":"https://travis-ci.org/pdf-raku/Native-Packing-raku.svg?branch=master","alt":"Build Status"}]}]}]},{"type":"block","id":"4rXxHmrVWhf1EWT2P0yOn","margin":"","level":2,"name":"head","location":{"start":{"line":5,"column":1,"offset":164},"end":{"line":5,"column":15,"offset":178}},"content":["Description"]},{"type":"para","id":"T-JukzZ2YEJ4Vh0yds6KH","margin":"","location":{"start":{"line":7,"column":1,"offset":180},"end":{"line":8,"column":38,"offset":277}},"text":"text","content":["Native::Packing is a simple solution for structured reading\nand writing of binary numerical data."]},{"type":"block","id":"69_WuzNxrdfWtKYvaX4mk","margin":"","level":2,"name":"head","location":{"start":{"line":10,"column":1,"offset":279},"end":{"line":10,"column":11,"offset":289}},"content":["Example"]},{"type":"block","id":"lML1j45oSYG1niwFUcOjf","margin":"","name":"code","config":[],"location":{"start":{"line":12,"column":1,"offset":291},"end":{"line":32,"column":4,"offset":756}},"content":[{"type":"verbatim","value":"use v6;\nuse Native::Packing :Endian;\n\n# open a GIF read the header\nmy class LogicalDescriptor\n    does Native::Packing[Endian::Vax] {\n\n    has uint16 $.width;\n    has uint16 $.height;\n    has uint8  $.flags;\n    has uint8  $.bgColorIndex;\n    has uint8  $.aspect;\n}\n\nmy $fh = \"t/lightbulb.gif\".IO.open( :r, :bin);\nmy $offset = 6;  # skip GIF header\n\nmy LogicalDescriptor $screen .= read: $fh, :$offset;\nsay \"GIF has size {$screen.width} X {$screen.height}\";"}]},{"type":"para","id":"uOtNHv5fedZS-sfiy7n8L","margin":"","location":{"start":{"line":34,"column":1,"offset":758},"end":{"line":35,"column":71,"offset":917}},"text":"text","content":["It currently handles records containing native integers (",{"type":"fcode","name":"C","content":["int8"]},", ",{"type":"fcode","name":"C","content":["uint8"]},", ",{"type":"fcode","name":"C","content":["int16"]},", etc),\nnumerics (",{"type":"fcode","name":"C","content":["num32"]},", ",{"type":"fcode","name":"C","content":["num64"]},") and sub-records of type ",{"type":"fcode","name":"C","content":["Native::Packing"]},"."]},{"type":"list","id":"glr_sXmzeymNCWj82YKuT","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"n94MqysAEUwbRK354GiqQ","margin":"","name":"item","level":1,"location":{"start":{"line":37,"column":1,"offset":919},"end":{"line":37,"column":83,"offset":1001}},"content":[{"type":"para","id":"6LhY58ctohexVZDbSIhNx","margin":"","location":{"start":{"line":37,"column":3,"offset":921},"end":{"line":37,"column":83,"offset":1001}},"text":"text","content":["Data may read be and written to binary files, via the ",{"type":"fcode","name":"C","content":["read"]}," and ",{"type":"fcode","name":"C","content":["write"]}," methods"]}]},{"type":"block","id":"UZm_2Pe3q7bp4MFzxfwQ_","margin":"","name":"item","level":1,"location":{"start":{"line":39,"column":1,"offset":1003},"end":{"line":39,"column":70,"offset":1072}},"content":[{"type":"para","id":"nrPuuYVBp2uEA2-wV_eRn","margin":"","location":{"start":{"line":39,"column":3,"offset":1005},"end":{"line":39,"column":70,"offset":1072}},"text":"text","content":["Or read and written to buffers via the ",{"type":"fcode","name":"C","content":["unpack"]}," and ",{"type":"fcode","name":"C","content":["pack"]}," methods."]}]}]},{"type":"block","id":"AAsUi9qPTeRjNN9syzPi-","margin":"","level":2,"name":"head","location":{"start":{"line":41,"column":1,"offset":1074},"end":{"line":41,"column":13,"offset":1086}},"content":["Endianess"]},{"type":"para","id":"fbRen_KyfgQkC9GMfSDbT","margin":"","location":{"start":{"line":43,"column":1,"offset":1088},"end":{"line":43,"column":25,"offset":1112}},"text":"text","content":["The two fixed modes are:"]},{"type":"list","id":"JtzQHeDrj5lCJIaif1pqP","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"QNsDwpmxJhUKrTP_yX0PK","margin":"","name":"item","level":1,"location":{"start":{"line":45,"column":1,"offset":1114},"end":{"line":45,"column":58,"offset":1171}},"content":[{"type":"para","id":"ER8XLV3RSCnttb8TQDyE_","margin":"","location":{"start":{"line":45,"column":3,"offset":1116},"end":{"line":45,"column":58,"offset":1171}},"text":"text","content":["Vax (big endian) - least significant byte written first"]}]},{"type":"block","id":"g0hvu79hdqsEVzHMallqH","margin":"","name":"item","level":1,"location":{"start":{"line":47,"column":1,"offset":1173},"end":{"line":47,"column":64,"offset":1236}},"content":[{"type":"para","id":"STOygfI7y1uRvWsrIK6i5","margin":"","location":{"start":{"line":47,"column":3,"offset":1175},"end":{"line":47,"column":64,"offset":1236}},"text":"text","content":["Network (little endian) - most significant byte written first"]}]}]},{"type":"para","id":"M9uafvvAK_ggPu9TTYiiK","margin":"","location":{"start":{"line":49,"column":1,"offset":1238},"end":{"line":50,"column":22,"offset":1325}},"text":"text","content":["The endianess of the binary format needs to be known to correctly\nread and write to it."]},{"type":"para","id":"AVQ3-1uOlIGIg4IOTUEzN","margin":"","location":{"start":{"line":52,"column":1,"offset":1327},"end":{"line":53,"column":56,"offset":1455}},"text":"text","content":["There is also a platform-dependant ",{"type":"fcode","name":"C","content":["Host"]}," mode. This will read and write\nbinary data in the same endianess as the host computer."]},{"type":"para","id":"sL4YnNyRTZ8eYBRvIzq6Y","margin":"","location":{"start":{"line":55,"column":1,"offset":1457},"end":{"line":55,"column":17,"offset":1473}},"text":"text","content":["Endian Examples:"]},{"type":"block","id":"1FRvHkGJV-1SUKpzTKwTd","margin":"","name":"code","config":[],"location":{"start":{"line":57,"column":1,"offset":1475},"end":{"line":65,"column":4,"offset":1762}},"content":[{"type":"verbatim","value":"use Native::Packing :Endian;\nclass C { has int16 $.a }\nmy $c = C.new: :a(42);\nsay ($c but Native::Packing[Vax]).pack;     # Buf[uint8]:0x<2a 00>\nsay ($c but Native::Packing[Network]).pack; # Buf[uint8]:0x<00 2a>\nsay ($c but Native::Packing[Host]).pack;    # Depends on your host\n"}]}]},"publishUrl":"/mods/zef/Native::Packing/Native-Packing-0.0.5/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:dwarring","build-depends":[],"depends":[],"description":"Endian safe Binary Struct packing and unpacking","dist":"Native::Packing:ver<0.0.5>:auth<zef:dwarring>","license":"Artistic-2.0","name":"Native::Packing","path":"N/AT/NATIVE_PACKING/e6b803d4f7f34f61492317bcbae35e14db9b6158.tar.gz","perl":"6.c","provides":{"Native::Packing":"lib/Native/Packing.rakumod"},"resources":[],"source-url":"git://github.com/pdf-raku/Native-Packing-raku.git","tags":["binary","endian","native","struct","pack","unpack"],"test-depends":[],"version":"0.0.5"},"files":[{"file":"work_mods/zef/Native::Packing/Native-Packing-0.0.5/README.md","publishUrl":"/mods/zef/Native::Packing/Native-Packing-0.0.5/README.md"},{"file":"work_mods/zef/Native::Packing/Native-Packing-0.0.5/lib/Native/Packing.rakumod","publishUrl":"/mods/zef/Native::Packing/Native-Packing-0.0.5/lib/Native/Packing.rakumod"}],"src":"zef","url":"/mods/zef/Native::Packing"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Native::Packing/Native-Packing-0.0.5/README.md","sources":[],"node":{"type":"block","id":"P_kmbWPTuHWujgG69FXsf","margin":"","name":"root","content":[{"type":"block","id":"mDpHY3j8DTuSa-_vK2N_e","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":22,"offset":21}},"content":["Native-Packing-raku"]},{"type":"para","id":"YBA1OBrHkoIcdTIOuGcuV","margin":"","location":{"start":{"line":3,"column":1,"offset":23},"end":{"line":3,"column":140,"offset":162}},"text":"text","content":[{"meta":"https://travis-ci.org/pdf-raku/Native-Packing-raku","type":"fcode","name":"L","content":[{"type":"block","id":"4DbaN6cVvH0dSsxmNb3AC","margin":"","name":"Image","config":[],"location":{"start":{"line":3,"column":2,"offset":24},"end":{"line":3,"column":87,"offset":109}},"content":[{"type":"image","src":"https://travis-ci.org/pdf-raku/Native-Packing-raku.svg?branch=master","alt":"Build Status"}]}]}]},{"type":"block","id":"4rXxHmrVWhf1EWT2P0yOn","margin":"","level":2,"name":"head","location":{"start":{"line":5,"column":1,"offset":164},"end":{"line":5,"column":15,"offset":178}},"content":["Description"]},{"type":"para","id":"T-JukzZ2YEJ4Vh0yds6KH","margin":"","location":{"start":{"line":7,"column":1,"offset":180},"end":{"line":8,"column":38,"offset":277}},"text":"text","content":["Native::Packing is a simple solution for structured reading\nand writing of binary numerical data."]},{"type":"block","id":"69_WuzNxrdfWtKYvaX4mk","margin":"","level":2,"name":"head","location":{"start":{"line":10,"column":1,"offset":279},"end":{"line":10,"column":11,"offset":289}},"content":["Example"]},{"type":"block","id":"lML1j45oSYG1niwFUcOjf","margin":"","name":"code","config":[],"location":{"start":{"line":12,"column":1,"offset":291},"end":{"line":32,"column":4,"offset":756}},"content":[{"type":"verbatim","value":"use v6;\nuse Native::Packing :Endian;\n\n# open a GIF read the header\nmy class LogicalDescriptor\n    does Native::Packing[Endian::Vax] {\n\n    has uint16 $.width;\n    has uint16 $.height;\n    has uint8  $.flags;\n    has uint8  $.bgColorIndex;\n    has uint8  $.aspect;\n}\n\nmy $fh = \"t/lightbulb.gif\".IO.open( :r, :bin);\nmy $offset = 6;  # skip GIF header\n\nmy LogicalDescriptor $screen .= read: $fh, :$offset;\nsay \"GIF has size {$screen.width} X {$screen.height}\";"}]},{"type":"para","id":"uOtNHv5fedZS-sfiy7n8L","margin":"","location":{"start":{"line":34,"column":1,"offset":758},"end":{"line":35,"column":71,"offset":917}},"text":"text","content":["It currently handles records containing native integers (",{"type":"fcode","name":"C","content":["int8"]},", ",{"type":"fcode","name":"C","content":["uint8"]},", ",{"type":"fcode","name":"C","content":["int16"]},", etc),\nnumerics (",{"type":"fcode","name":"C","content":["num32"]},", ",{"type":"fcode","name":"C","content":["num64"]},") and sub-records of type ",{"type":"fcode","name":"C","content":["Native::Packing"]},"."]},{"type":"list","id":"glr_sXmzeymNCWj82YKuT","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"n94MqysAEUwbRK354GiqQ","margin":"","name":"item","level":1,"location":{"start":{"line":37,"column":1,"offset":919},"end":{"line":37,"column":83,"offset":1001}},"content":[{"type":"para","id":"6LhY58ctohexVZDbSIhNx","margin":"","location":{"start":{"line":37,"column":3,"offset":921},"end":{"line":37,"column":83,"offset":1001}},"text":"text","content":["Data may read be and written to binary files, via the ",{"type":"fcode","name":"C","content":["read"]}," and ",{"type":"fcode","name":"C","content":["write"]}," methods"]}]},{"type":"block","id":"UZm_2Pe3q7bp4MFzxfwQ_","margin":"","name":"item","level":1,"location":{"start":{"line":39,"column":1,"offset":1003},"end":{"line":39,"column":70,"offset":1072}},"content":[{"type":"para","id":"nrPuuYVBp2uEA2-wV_eRn","margin":"","location":{"start":{"line":39,"column":3,"offset":1005},"end":{"line":39,"column":70,"offset":1072}},"text":"text","content":["Or read and written to buffers via the ",{"type":"fcode","name":"C","content":["unpack"]}," and ",{"type":"fcode","name":"C","content":["pack"]}," methods."]}]}]},{"type":"block","id":"AAsUi9qPTeRjNN9syzPi-","margin":"","level":2,"name":"head","location":{"start":{"line":41,"column":1,"offset":1074},"end":{"line":41,"column":13,"offset":1086}},"content":["Endianess"]},{"type":"para","id":"fbRen_KyfgQkC9GMfSDbT","margin":"","location":{"start":{"line":43,"column":1,"offset":1088},"end":{"line":43,"column":25,"offset":1112}},"text":"text","content":["The two fixed modes are:"]},{"type":"list","id":"JtzQHeDrj5lCJIaif1pqP","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"QNsDwpmxJhUKrTP_yX0PK","margin":"","name":"item","level":1,"location":{"start":{"line":45,"column":1,"offset":1114},"end":{"line":45,"column":58,"offset":1171}},"content":[{"type":"para","id":"ER8XLV3RSCnttb8TQDyE_","margin":"","location":{"start":{"line":45,"column":3,"offset":1116},"end":{"line":45,"column":58,"offset":1171}},"text":"text","content":["Vax (big endian) - least significant byte written first"]}]},{"type":"block","id":"g0hvu79hdqsEVzHMallqH","margin":"","name":"item","level":1,"location":{"start":{"line":47,"column":1,"offset":1173},"end":{"line":47,"column":64,"offset":1236}},"content":[{"type":"para","id":"STOygfI7y1uRvWsrIK6i5","margin":"","location":{"start":{"line":47,"column":3,"offset":1175},"end":{"line":47,"column":64,"offset":1236}},"text":"text","content":["Network (little endian) - most significant byte written first"]}]}]},{"type":"para","id":"M9uafvvAK_ggPu9TTYiiK","margin":"","location":{"start":{"line":49,"column":1,"offset":1238},"end":{"line":50,"column":22,"offset":1325}},"text":"text","content":["The endianess of the binary format needs to be known to correctly\nread and write to it."]},{"type":"para","id":"AVQ3-1uOlIGIg4IOTUEzN","margin":"","location":{"start":{"line":52,"column":1,"offset":1327},"end":{"line":53,"column":56,"offset":1455}},"text":"text","content":["There is also a platform-dependant ",{"type":"fcode","name":"C","content":["Host"]}," mode. This will read and write\nbinary data in the same endianess as the host computer."]},{"type":"para","id":"sL4YnNyRTZ8eYBRvIzq6Y","margin":"","location":{"start":{"line":55,"column":1,"offset":1457},"end":{"line":55,"column":17,"offset":1473}},"text":"text","content":["Endian Examples:"]},{"type":"block","id":"1FRvHkGJV-1SUKpzTKwTd","margin":"","name":"code","config":[],"location":{"start":{"line":57,"column":1,"offset":1475},"end":{"line":65,"column":4,"offset":1762}},"content":[{"type":"verbatim","value":"use Native::Packing :Endian;\nclass C { has int16 $.a }\nmy $c = C.new: :a(42);\nsay ($c but Native::Packing[Vax]).pack;     # Buf[uint8]:0x<2a 00>\nsay ($c but Native::Packing[Network]).pack; # Buf[uint8]:0x<00 2a>\nsay ($c but Native::Packing[Host]).pack;    # Depends on your host\n"}]}]},"publishUrl":"/mods/zef/Native::Packing/Native-Packing-0.0.5/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:dwarring","build-depends":[],"depends":[],"description":"Endian safe Binary Struct packing and unpacking","dist":"Native::Packing:ver<0.0.5>:auth<zef:dwarring>","license":"Artistic-2.0","name":"Native::Packing","path":"N/AT/NATIVE_PACKING/e6b803d4f7f34f61492317bcbae35e14db9b6158.tar.gz","perl":"6.c","provides":{"Native::Packing":"lib/Native/Packing.rakumod"},"resources":[],"source-url":"git://github.com/pdf-raku/Native-Packing-raku.git","tags":["binary","endian","native","struct","pack","unpack"],"test-depends":[],"version":"0.0.5"},"files":[{"file":"work_mods/zef/Native::Packing/Native-Packing-0.0.5/README.md","publishUrl":"/mods/zef/Native::Packing/Native-Packing-0.0.5/README.md"},{"file":"work_mods/zef/Native::Packing/Native-Packing-0.0.5/lib/Native/Packing.rakumod","publishUrl":"/mods/zef/Native::Packing/Native-Packing-0.0.5/lib/Native/Packing.rakumod"}],"src":"zef","url":"/mods/zef/Native::Packing"}}}
    =end data
    =end React


Native::Packing


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


NativeHelpers::Array

NativeHelpers::Array

image https://github.com/jonathanstowe/NativeHelpers-Array/workflows/CI/badge.svg not found

Description

Installation

Support

Licence

NativeHelpers::Array v0.0.5

Authors

License

Dependencies

Test Dependencies

Provides

Documentation