TITLE

SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/ValuePair/ValuePair-0.0.1/README.md","sources":[],"node":{"type":"block","id":"j22x_tG9S1URoRcEh4zKi","margin":"","name":"root","content":[{"type":"para","id":"I_Tldz-oHZkNPY-WK8ZRm","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":139,"offset":138}},"text":"text","content":[{"meta":"https://github.com/lizmat/ValuePair/actions","type":"fcode","name":"L","content":[{"type":"block","id":"xTBnPaLNhK2wBp74hI-ed","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":93,"offset":92}},"content":[{"type":"image","src":"https://github.com/lizmat/ValuePair/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"XrKTX7c3lFPbmFaQ86hm6","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":140},"end":{"line":4,"column":5,"offset":149}},"content":["NAME"]},{"type":"para","id":"sYdlDxeupEHuUTk7xxK-1","margin":"","location":{"start":{"line":6,"column":1,"offset":151},"end":{"line":6,"column":49,"offset":199}},"text":"text","content":["ValuePair - Provide an immutable Pair value type"]},{"type":"block","id":"kFcMv9YsSwqPfRJvw-Pbn","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":201},"end":{"line":9,"column":9,"offset":218}},"content":["SYNOPSIS"]},{"type":"block","id":"fSj8EvZyZWPXyzYsPrHgT","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":220},"end":{"line":18,"column":4,"offset":337}},"content":[{"type":"verbatim","value":"use ValuePair;\n\nmy $a = ValuePair.new(\"a\",42);\nmy $b = ValuePair.new(\"a\",42);\n\nset($a, $b);  # elems == 1"}]},{"type":"block","id":"CLZAt2QJ2ZFFJZ0fUxLgg","margin":"","level":1,"name":"head","location":{"start":{"line":20,"column":1,"offset":339},"end":{"line":21,"column":12,"offset":362}},"content":["DESCRIPTION"]},{"type":"para","id":"FxWb-BbuxTdrFvxUJEcii","margin":"","location":{"start":{"line":23,"column":1,"offset":364},"end":{"line":23,"column":199,"offset":562}},"text":"text","content":["The functionality provided by this module, will most likely be provided in language level 6.e and higher. If an implementation of ValuePair is already available, loading this module becomes a no-op."]},{"type":"para","id":"QZBbAziq93CDeoynwEUZZ","margin":"","location":{"start":{"line":25,"column":1,"offset":564},"end":{"line":25,"column":312,"offset":875}},"text":"text","content":["Raku provides a semi-immutable ",{"type":"fcode","name":"C","content":["Pair"]}," datatype, where the value of a Pair object can be a container, and thus mutable. Therefore, a standard Pair is ",{"type":"fcode","name":"B","content":["not"]}," a value type. The ",{"type":"fcode","name":"C","content":["ValuePair"]}," class provided by this module, is a subclass of ",{"type":"fcode","name":"C","content":["Pair"]},", and does not allow a mutable value. And thus it can be a value type."]},{"type":"block","id":"iSHdVIM0SOrC3LN1p5FGE","margin":"","level":1,"name":"head","location":{"start":{"line":27,"column":1,"offset":877},"end":{"line":28,"column":7,"offset":890}},"content":["AUTHOR"]},{"type":"para","id":"gARmq22dSLAliJ9p1CFBC","margin":"","location":{"start":{"line":30,"column":1,"offset":892},"end":{"line":30,"column":37,"offset":928}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"g9G06rlY_uTds3THj9F9M","margin":"","location":{"start":{"line":32,"column":1,"offset":930},"end":{"line":32,"column":104,"offset":1033}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/ValuePair","type":"fcode","name":"L","content":["https://github.com/lizmat/ValuePair"]}," . Comments and Pull Requests are welcome."]},{"type":"para","id":"y7kGRKDgeTvetQ-v3qeVI","margin":"","location":{"start":{"line":34,"column":1,"offset":1035},"end":{"line":34,"column":163,"offset":1197}},"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":"1hDY67k45aH2-pFXh9IVU","margin":"","level":1,"name":"head","location":{"start":{"line":36,"column":1,"offset":1199},"end":{"line":37,"column":22,"offset":1242}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"StZDiTXk0jvsONFE8VeJC","margin":"","location":{"start":{"line":39,"column":1,"offset":1244},"end":{"line":39,"column":35,"offset":1278}},"text":"text","content":["Copyright 2022 Elizabeth Mattijsen"]},{"type":"para","id":"o_HfvLTnxniH7ro0AuAtF","margin":"","location":{"start":{"line":41,"column":1,"offset":1280},"end":{"line":41,"column":104,"offset":1383}},"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/ValuePair/ValuePair-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"Provide an immutable Pair value type","dist":"ValuePair:ver<0.0.1>:auth<zef:lizmat>","license":"Artistic-2.0","name":"ValuePair","path":"V/AL/VALUEPAIR/8605f290a44f796bff75c535e4bc1244e853f16a.tar.gz","perl":"6.d","provides":{"ValuePair":"lib/ValuePair.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/ValuePair.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/ValuePair/ValuePair-0.0.1/README.md","publishUrl":"/mods/zef/ValuePair/ValuePair-0.0.1/README.md"},{"file":"work_mods/zef/ValuePair/ValuePair-0.0.1/lib/ValuePair.rakumod","publishUrl":"/mods/zef/ValuePair/ValuePair-0.0.1/lib/ValuePair.rakumod"}],"src":"zef","url":"/mods/zef/ValuePair"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/ValuePair/ValuePair-0.0.1/README.md","sources":[],"node":{"type":"block","id":"j22x_tG9S1URoRcEh4zKi","margin":"","name":"root","content":[{"type":"para","id":"I_Tldz-oHZkNPY-WK8ZRm","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":139,"offset":138}},"text":"text","content":[{"meta":"https://github.com/lizmat/ValuePair/actions","type":"fcode","name":"L","content":[{"type":"block","id":"xTBnPaLNhK2wBp74hI-ed","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":93,"offset":92}},"content":[{"type":"image","src":"https://github.com/lizmat/ValuePair/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"XrKTX7c3lFPbmFaQ86hm6","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":140},"end":{"line":4,"column":5,"offset":149}},"content":["NAME"]},{"type":"para","id":"sYdlDxeupEHuUTk7xxK-1","margin":"","location":{"start":{"line":6,"column":1,"offset":151},"end":{"line":6,"column":49,"offset":199}},"text":"text","content":["ValuePair - Provide an immutable Pair value type"]},{"type":"block","id":"kFcMv9YsSwqPfRJvw-Pbn","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":201},"end":{"line":9,"column":9,"offset":218}},"content":["SYNOPSIS"]},{"type":"block","id":"fSj8EvZyZWPXyzYsPrHgT","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":220},"end":{"line":18,"column":4,"offset":337}},"content":[{"type":"verbatim","value":"use ValuePair;\n\nmy $a = ValuePair.new(\"a\",42);\nmy $b = ValuePair.new(\"a\",42);\n\nset($a, $b);  # elems == 1"}]},{"type":"block","id":"CLZAt2QJ2ZFFJZ0fUxLgg","margin":"","level":1,"name":"head","location":{"start":{"line":20,"column":1,"offset":339},"end":{"line":21,"column":12,"offset":362}},"content":["DESCRIPTION"]},{"type":"para","id":"FxWb-BbuxTdrFvxUJEcii","margin":"","location":{"start":{"line":23,"column":1,"offset":364},"end":{"line":23,"column":199,"offset":562}},"text":"text","content":["The functionality provided by this module, will most likely be provided in language level 6.e and higher. If an implementation of ValuePair is already available, loading this module becomes a no-op."]},{"type":"para","id":"QZBbAziq93CDeoynwEUZZ","margin":"","location":{"start":{"line":25,"column":1,"offset":564},"end":{"line":25,"column":312,"offset":875}},"text":"text","content":["Raku provides a semi-immutable ",{"type":"fcode","name":"C","content":["Pair"]}," datatype, where the value of a Pair object can be a container, and thus mutable. Therefore, a standard Pair is ",{"type":"fcode","name":"B","content":["not"]}," a value type. The ",{"type":"fcode","name":"C","content":["ValuePair"]}," class provided by this module, is a subclass of ",{"type":"fcode","name":"C","content":["Pair"]},", and does not allow a mutable value. And thus it can be a value type."]},{"type":"block","id":"iSHdVIM0SOrC3LN1p5FGE","margin":"","level":1,"name":"head","location":{"start":{"line":27,"column":1,"offset":877},"end":{"line":28,"column":7,"offset":890}},"content":["AUTHOR"]},{"type":"para","id":"gARmq22dSLAliJ9p1CFBC","margin":"","location":{"start":{"line":30,"column":1,"offset":892},"end":{"line":30,"column":37,"offset":928}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"g9G06rlY_uTds3THj9F9M","margin":"","location":{"start":{"line":32,"column":1,"offset":930},"end":{"line":32,"column":104,"offset":1033}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/ValuePair","type":"fcode","name":"L","content":["https://github.com/lizmat/ValuePair"]}," . Comments and Pull Requests are welcome."]},{"type":"para","id":"y7kGRKDgeTvetQ-v3qeVI","margin":"","location":{"start":{"line":34,"column":1,"offset":1035},"end":{"line":34,"column":163,"offset":1197}},"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":"1hDY67k45aH2-pFXh9IVU","margin":"","level":1,"name":"head","location":{"start":{"line":36,"column":1,"offset":1199},"end":{"line":37,"column":22,"offset":1242}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"StZDiTXk0jvsONFE8VeJC","margin":"","location":{"start":{"line":39,"column":1,"offset":1244},"end":{"line":39,"column":35,"offset":1278}},"text":"text","content":["Copyright 2022 Elizabeth Mattijsen"]},{"type":"para","id":"o_HfvLTnxniH7ro0AuAtF","margin":"","location":{"start":{"line":41,"column":1,"offset":1280},"end":{"line":41,"column":104,"offset":1383}},"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/ValuePair/ValuePair-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"Provide an immutable Pair value type","dist":"ValuePair:ver<0.0.1>:auth<zef:lizmat>","license":"Artistic-2.0","name":"ValuePair","path":"V/AL/VALUEPAIR/8605f290a44f796bff75c535e4bc1244e853f16a.tar.gz","perl":"6.d","provides":{"ValuePair":"lib/ValuePair.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/ValuePair.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/ValuePair/ValuePair-0.0.1/README.md","publishUrl":"/mods/zef/ValuePair/ValuePair-0.0.1/README.md"},{"file":"work_mods/zef/ValuePair/ValuePair-0.0.1/lib/ValuePair.rakumod","publishUrl":"/mods/zef/ValuePair/ValuePair-0.0.1/lib/ValuePair.rakumod"}],"src":"zef","url":"/mods/zef/ValuePair"}}}
    =end data
    =end React


root

Provide an immutable Pair value type


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

ValuePair


=begin data
{"type":"page","file":"work_mods/zef/ValueType/ValueType-0.0.4/README.md","sources":[],"node":{"type":"block","id":"lGS8H1Xlram0np3y4Yo4D","margin":"","name":"root","content":[{"type":"para","id":"kZzJMx_DNvn6Kv_t6Y3EH","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":127,"offset":126}},"text":"text","content":[{"meta":"https://github.com/lizmat/ValueType/actions","type":"fcode","name":"L","content":[{"type":"block","id":"8nLwG3ci_jg7ccVoX5Cf1","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":81,"offset":80}},"content":[{"type":"image","src":"https://github.com/lizmat/ValueType/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"BrkEJTUOx8d76ZnvZ5cEE","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":128},"end":{"line":4,"column":5,"offset":137}},"content":["NAME"]},{"type":"para","id":"8nNd1bh_TTcgOhHNSOebl","margin":"","location":{"start":{"line":6,"column":1,"offset":139},"end":{"line":6,"column":48,"offset":186}},"text":"text","content":["ValueType - A role to create Value Type classes"]},{"type":"block","id":"QYQRR6I-22ZN_YJktXrzb","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":188},"end":{"line":9,"column":9,"offset":205}},"content":["SYNOPSIS"]},{"type":"block","id":"-OhF03G5r6qYkSdBjGJcv","margin":"","name":"code","config":[],"location":{"start":{"line":11,"column":1,"offset":207},"end":{"line":24,"column":38,"offset":526}},"content":[{"type":"verbatim","value":"use ValueType;\n\nclass Point does ValueType {\n    has $.x = 0;\n    has $.y = 0;\n}\n\nsay Point.new.WHICH;  # Point|Int|0|Int|0\n\n# fill a bag with random Points\nmy $bag = bag (^1000).map: {\n  Point.new: x => (-10..10).roll, y => (-10..10).roll\n}\nsay $bag.elems;  # less than 1000"}]},{"type":"block","id":"xHzKtptcnOhhxt-ibvkZb","margin":"","level":1,"name":"head","location":{"start":{"line":26,"column":1,"offset":528},"end":{"line":27,"column":12,"offset":551}},"content":["DESCRIPTION"]},{"type":"para","id":"W9nQmDh_IQsGXzcpSTPRg","margin":"","location":{"start":{"line":29,"column":1,"offset":553},"end":{"line":29,"column":313,"offset":865}},"text":"text","content":["The ValueType role mixes the logic of creating a proper ValueType into a class. A class is considered to be a value type if the ",{"type":"fcode","name":"C","content":[".WHICH"]}," method returns an object of the ",{"type":"fcode","name":"C","content":["ValueObjAt"]}," class: that then indicates that objects that return the same ",{"type":"fcode","name":"C","content":["WHICH"]}," value, are in fact identical and can be used interchangeably."]},{"type":"para","id":"7g9flMsoAPz_1Xu7Jq-oJ","margin":"","location":{"start":{"line":31,"column":1,"offset":867},"end":{"line":31,"column":214,"offset":1080}},"text":"text","content":["This is specifically important when using set operators (such as ",{"type":"fcode","name":"C","content":["(elem)"]},", or ",{"type":"fcode","name":"C","content":["Set"]},"s, ",{"type":"fcode","name":"C","content":["Bag"]},"s or ",{"type":"fcode","name":"C","content":["Mix"]},"es, or any other functionality that is based on the ",{"type":"fcode","name":"C","content":["==="]}," operator functionality, such as ",{"type":"fcode","name":"C","content":["unique"]}," and ",{"type":"fcode","name":"C","content":["squish"]},"."]},{"type":"para","id":"ffgtmQ12eqjhZXanXg_H4","margin":"","location":{"start":{"line":33,"column":1,"offset":1082},"end":{"line":33,"column":155,"offset":1236}},"text":"text","content":["The format of the value that is being returned by ",{"type":"fcode","name":"C","content":["WHICH"]}," is only valid during a run of a process. So it should ",{"type":"fcode","name":"B","content":["not"]}," be stored in any permanent medium."]},{"type":"block","id":"tZ-onawBgd1dx7kMg-qSs","margin":"","level":1,"name":"head","location":{"start":{"line":35,"column":1,"offset":1238},"end":{"line":36,"column":20,"offset":1277}},"content":["THEORY OF OPERATION"]},{"type":"para","id":"ew7iBu0rfmE-5THcocqGt","margin":"","location":{"start":{"line":38,"column":1,"offset":1279},"end":{"line":38,"column":356,"offset":1634}},"text":"text","content":["The first time the ",{"type":"fcode","name":"C","content":["WHICH"]}," method (mixed in by this role) is called, it will check all of its attribute values for being a value type. If they all are, then it will construct a ",{"type":"fcode","name":"C","content":["ValueObjAt"]}," object for its ",{"type":"fcode","name":"C","content":["WHICH"]}," value, save it for future reference, and return it. If any of the attribute values are ",{"type":"fcode","name":"B","content":["not"]}," a value type, then an exception will be thrown."]},{"type":"block","id":"9RNql-qdEsHMCbG28PKkT","margin":"","level":1,"name":"head","location":{"start":{"line":40,"column":1,"offset":1636},"end":{"line":41,"column":7,"offset":1649}},"content":["AUTHOR"]},{"type":"para","id":"_yH7mJUmUznZmhyxA18RT","margin":"","location":{"start":{"line":43,"column":1,"offset":1651},"end":{"line":43,"column":37,"offset":1687}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"ezDn_oCKJBIlsA-Dj_Zrz","margin":"","location":{"start":{"line":45,"column":1,"offset":1689},"end":{"line":45,"column":104,"offset":1792}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/ValueType","type":"fcode","name":"L","content":["https://github.com/lizmat/ValueType"]}," . Comments and Pull Requests are welcome."]},{"type":"block","id":"OmKsMGr_dJuieAg4c3oJP","margin":"","level":1,"name":"head","location":{"start":{"line":47,"column":1,"offset":1794},"end":{"line":48,"column":22,"offset":1837}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"lPmsqTSbjPbtJMtbSRHba","margin":"","location":{"start":{"line":50,"column":1,"offset":1839},"end":{"line":50,"column":41,"offset":1879}},"text":"text","content":["Copyright 2020, 2021 Elizabeth Mattijsen"]},{"type":"para","id":"iLrL23oziTGydaqJ5WwE-","margin":"","location":{"start":{"line":52,"column":1,"offset":1881},"end":{"line":52,"column":104,"offset":1984}},"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/ValueType/ValueType-0.0.4/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"A role to create Value Type classes","dist":"ValueType:ver<0.0.4>:auth<zef:lizmat>","license":"Artistic-2.0","name":"ValueType","path":"V/AL/VALUETYPE/5594d645cb435b7bfa28f5b6c802e8559a5a5c82.tar.gz","perl":"6.d","provides":{"ValueType":"lib/ValueType.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/ValueType.git","tags":["UTILS"],"test-depends":[],"version":"0.0.4"},"files":[{"file":"work_mods/zef/ValueType/ValueType-0.0.4/README.md","publishUrl":"/mods/zef/ValueType/ValueType-0.0.4/README.md"},{"file":"work_mods/zef/ValueType/ValueType-0.0.4/lib/ValueType.rakumod","publishUrl":"/mods/zef/ValueType/ValueType-0.0.4/lib/ValueType.rakumod"}],"src":"zef","url":"/mods/zef/ValueType"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/ValueType/ValueType-0.0.4/README.md","sources":[],"node":{"type":"block","id":"lGS8H1Xlram0np3y4Yo4D","margin":"","name":"root","content":[{"type":"para","id":"kZzJMx_DNvn6Kv_t6Y3EH","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":127,"offset":126}},"text":"text","content":[{"meta":"https://github.com/lizmat/ValueType/actions","type":"fcode","name":"L","content":[{"type":"block","id":"8nLwG3ci_jg7ccVoX5Cf1","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":81,"offset":80}},"content":[{"type":"image","src":"https://github.com/lizmat/ValueType/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"BrkEJTUOx8d76ZnvZ5cEE","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":128},"end":{"line":4,"column":5,"offset":137}},"content":["NAME"]},{"type":"para","id":"8nNd1bh_TTcgOhHNSOebl","margin":"","location":{"start":{"line":6,"column":1,"offset":139},"end":{"line":6,"column":48,"offset":186}},"text":"text","content":["ValueType - A role to create Value Type classes"]},{"type":"block","id":"QYQRR6I-22ZN_YJktXrzb","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":188},"end":{"line":9,"column":9,"offset":205}},"content":["SYNOPSIS"]},{"type":"block","id":"-OhF03G5r6qYkSdBjGJcv","margin":"","name":"code","config":[],"location":{"start":{"line":11,"column":1,"offset":207},"end":{"line":24,"column":38,"offset":526}},"content":[{"type":"verbatim","value":"use ValueType;\n\nclass Point does ValueType {\n    has $.x = 0;\n    has $.y = 0;\n}\n\nsay Point.new.WHICH;  # Point|Int|0|Int|0\n\n# fill a bag with random Points\nmy $bag = bag (^1000).map: {\n  Point.new: x => (-10..10).roll, y => (-10..10).roll\n}\nsay $bag.elems;  # less than 1000"}]},{"type":"block","id":"xHzKtptcnOhhxt-ibvkZb","margin":"","level":1,"name":"head","location":{"start":{"line":26,"column":1,"offset":528},"end":{"line":27,"column":12,"offset":551}},"content":["DESCRIPTION"]},{"type":"para","id":"W9nQmDh_IQsGXzcpSTPRg","margin":"","location":{"start":{"line":29,"column":1,"offset":553},"end":{"line":29,"column":313,"offset":865}},"text":"text","content":["The ValueType role mixes the logic of creating a proper ValueType into a class. A class is considered to be a value type if the ",{"type":"fcode","name":"C","content":[".WHICH"]}," method returns an object of the ",{"type":"fcode","name":"C","content":["ValueObjAt"]}," class: that then indicates that objects that return the same ",{"type":"fcode","name":"C","content":["WHICH"]}," value, are in fact identical and can be used interchangeably."]},{"type":"para","id":"7g9flMsoAPz_1Xu7Jq-oJ","margin":"","location":{"start":{"line":31,"column":1,"offset":867},"end":{"line":31,"column":214,"offset":1080}},"text":"text","content":["This is specifically important when using set operators (such as ",{"type":"fcode","name":"C","content":["(elem)"]},", or ",{"type":"fcode","name":"C","content":["Set"]},"s, ",{"type":"fcode","name":"C","content":["Bag"]},"s or ",{"type":"fcode","name":"C","content":["Mix"]},"es, or any other functionality that is based on the ",{"type":"fcode","name":"C","content":["==="]}," operator functionality, such as ",{"type":"fcode","name":"C","content":["unique"]}," and ",{"type":"fcode","name":"C","content":["squish"]},"."]},{"type":"para","id":"ffgtmQ12eqjhZXanXg_H4","margin":"","location":{"start":{"line":33,"column":1,"offset":1082},"end":{"line":33,"column":155,"offset":1236}},"text":"text","content":["The format of the value that is being returned by ",{"type":"fcode","name":"C","content":["WHICH"]}," is only valid during a run of a process. So it should ",{"type":"fcode","name":"B","content":["not"]}," be stored in any permanent medium."]},{"type":"block","id":"tZ-onawBgd1dx7kMg-qSs","margin":"","level":1,"name":"head","location":{"start":{"line":35,"column":1,"offset":1238},"end":{"line":36,"column":20,"offset":1277}},"content":["THEORY OF OPERATION"]},{"type":"para","id":"ew7iBu0rfmE-5THcocqGt","margin":"","location":{"start":{"line":38,"column":1,"offset":1279},"end":{"line":38,"column":356,"offset":1634}},"text":"text","content":["The first time the ",{"type":"fcode","name":"C","content":["WHICH"]}," method (mixed in by this role) is called, it will check all of its attribute values for being a value type. If they all are, then it will construct a ",{"type":"fcode","name":"C","content":["ValueObjAt"]}," object for its ",{"type":"fcode","name":"C","content":["WHICH"]}," value, save it for future reference, and return it. If any of the attribute values are ",{"type":"fcode","name":"B","content":["not"]}," a value type, then an exception will be thrown."]},{"type":"block","id":"9RNql-qdEsHMCbG28PKkT","margin":"","level":1,"name":"head","location":{"start":{"line":40,"column":1,"offset":1636},"end":{"line":41,"column":7,"offset":1649}},"content":["AUTHOR"]},{"type":"para","id":"_yH7mJUmUznZmhyxA18RT","margin":"","location":{"start":{"line":43,"column":1,"offset":1651},"end":{"line":43,"column":37,"offset":1687}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"ezDn_oCKJBIlsA-Dj_Zrz","margin":"","location":{"start":{"line":45,"column":1,"offset":1689},"end":{"line":45,"column":104,"offset":1792}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/ValueType","type":"fcode","name":"L","content":["https://github.com/lizmat/ValueType"]}," . Comments and Pull Requests are welcome."]},{"type":"block","id":"OmKsMGr_dJuieAg4c3oJP","margin":"","level":1,"name":"head","location":{"start":{"line":47,"column":1,"offset":1794},"end":{"line":48,"column":22,"offset":1837}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"lPmsqTSbjPbtJMtbSRHba","margin":"","location":{"start":{"line":50,"column":1,"offset":1839},"end":{"line":50,"column":41,"offset":1879}},"text":"text","content":["Copyright 2020, 2021 Elizabeth Mattijsen"]},{"type":"para","id":"iLrL23oziTGydaqJ5WwE-","margin":"","location":{"start":{"line":52,"column":1,"offset":1881},"end":{"line":52,"column":104,"offset":1984}},"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/ValueType/ValueType-0.0.4/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"A role to create Value Type classes","dist":"ValueType:ver<0.0.4>:auth<zef:lizmat>","license":"Artistic-2.0","name":"ValueType","path":"V/AL/VALUETYPE/5594d645cb435b7bfa28f5b6c802e8559a5a5c82.tar.gz","perl":"6.d","provides":{"ValueType":"lib/ValueType.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/ValueType.git","tags":["UTILS"],"test-depends":[],"version":"0.0.4"},"files":[{"file":"work_mods/zef/ValueType/ValueType-0.0.4/README.md","publishUrl":"/mods/zef/ValueType/ValueType-0.0.4/README.md"},{"file":"work_mods/zef/ValueType/ValueType-0.0.4/lib/ValueType.rakumod","publishUrl":"/mods/zef/ValueType/ValueType-0.0.4/lib/ValueType.rakumod"}],"src":"zef","url":"/mods/zef/ValueType"}}}
    =end data
    =end React


A role to create Value Type classes


ValueType


=begin data
{"type":"page","file":"work_mods/zef/ValueMap/ValueMap-0.0.1/README.md","sources":[],"node":{"type":"block","id":"z6HizXuqSnkxEen4rVhwm","margin":"","name":"root","content":[{"type":"para","id":"q2yOuGOjqfl1xEQEmWUGM","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":125,"offset":124}},"text":"text","content":[{"meta":"https://github.com/lizmat/ValueMap/actions","type":"fcode","name":"L","content":[{"type":"block","id":"VgUaAd5prggC6ajzer0ba","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":80,"offset":79}},"content":[{"type":"image","src":"https://github.com/lizmat/ValueMap/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"GBFNASII51TNWV_Jx4PMX","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":126},"end":{"line":4,"column":5,"offset":135}},"content":["NAME"]},{"type":"para","id":"Ib9YHBplATVg6pD28IXEZ","margin":"","location":{"start":{"line":6,"column":1,"offset":137},"end":{"line":6,"column":47,"offset":183}},"text":"text","content":["ValueMap - Provide an immutable Map value type"]},{"type":"block","id":"c4eb3Du2UIK1T9FxiUxt4","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":185},"end":{"line":9,"column":9,"offset":202}},"content":["SYNOPSIS"]},{"type":"block","id":"29IaSxaCXnc2w8RDYFgUW","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":204},"end":{"line":13,"column":4,"offset":229}},"content":[{"type":"verbatim","value":"use ValueMap;"}]},{"type":"block","id":"4USzY0bErxRXU4Ljkgp8w","margin":"","level":1,"name":"head","location":{"start":{"line":15,"column":1,"offset":231},"end":{"line":16,"column":12,"offset":254}},"content":["DESCRIPTION"]},{"type":"para","id":"dLqAqvtzUc91eD98SuB8S","margin":"","location":{"start":{"line":18,"column":1,"offset":256},"end":{"line":18,"column":186,"offset":441}},"text":"text","content":["The functionality provided by this module, will be provided in language level 6.e and higher. If an implementation of ValueMap is already available, loading this module becomes a no-op."]},{"type":"para","id":"CC7yn8AmGmGFKLrd8VQ5I","margin":"","location":{"start":{"line":20,"column":1,"offset":443},"end":{"line":20,"column":381,"offset":823}},"text":"text","content":["Raku provides a semi-immutable Associative datatype: Map. A Map can not have any elements added or removed from it. However, since a Map can contain containers of which the value can be changed, it is ",{"type":"fcode","name":"B","content":["not"]}," a value type. So you cannot use Maps in data structures such as Sets, because each Map is considered to be different from any other List, because they are not value types."]},{"type":"block","id":"RPrcYM4mXFjcflaX_soed","margin":"","level":1,"name":"head","location":{"start":{"line":22,"column":1,"offset":825},"end":{"line":23,"column":7,"offset":838}},"content":["AUTHOR"]},{"type":"para","id":"CXbemGspmGMTDALUd6xHR","margin":"","location":{"start":{"line":25,"column":1,"offset":840},"end":{"line":25,"column":37,"offset":876}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"block","id":"ROrhuQjq2LlrAfyvzT-xg","margin":"","level":1,"name":"head","location":{"start":{"line":27,"column":1,"offset":878},"end":{"line":28,"column":22,"offset":921}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"AkYs7NY0wZLu8e2-rMYvP","margin":"","location":{"start":{"line":30,"column":1,"offset":923},"end":{"line":30,"column":35,"offset":957}},"text":"text","content":["Copyright 2022 Elizabeth Mattijsen"]},{"type":"para","id":"XoZgkxfRUDunsCRjvyRP_","margin":"","location":{"start":{"line":32,"column":1,"offset":959},"end":{"line":32,"column":104,"offset":1062}},"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/ValueMap/ValueMap-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"Provide an immutable Map value type","dist":"ValueMap:ver<0.0.1>:auth<zef:lizmat>","license":"Artistic-2.0","name":"ValueMap","path":"V/AL/VALUEMAP/a7dc4df14e928be0410ec22c3ed49739a514dfd4.tar.gz","perl":"6.d","provides":{"ValueMap":"lib/ValueMap.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/ValueMap.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/ValueMap/ValueMap-0.0.1/README.md","publishUrl":"/mods/zef/ValueMap/ValueMap-0.0.1/README.md"},{"file":"work_mods/zef/ValueMap/ValueMap-0.0.1/lib/ValueMap.rakumod","publishUrl":"/mods/zef/ValueMap/ValueMap-0.0.1/lib/ValueMap.rakumod"}],"src":"zef","url":"/mods/zef/ValueMap"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/ValueMap/ValueMap-0.0.1/README.md","sources":[],"node":{"type":"block","id":"z6HizXuqSnkxEen4rVhwm","margin":"","name":"root","content":[{"type":"para","id":"q2yOuGOjqfl1xEQEmWUGM","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":125,"offset":124}},"text":"text","content":[{"meta":"https://github.com/lizmat/ValueMap/actions","type":"fcode","name":"L","content":[{"type":"block","id":"VgUaAd5prggC6ajzer0ba","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":80,"offset":79}},"content":[{"type":"image","src":"https://github.com/lizmat/ValueMap/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"GBFNASII51TNWV_Jx4PMX","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":126},"end":{"line":4,"column":5,"offset":135}},"content":["NAME"]},{"type":"para","id":"Ib9YHBplATVg6pD28IXEZ","margin":"","location":{"start":{"line":6,"column":1,"offset":137},"end":{"line":6,"column":47,"offset":183}},"text":"text","content":["ValueMap - Provide an immutable Map value type"]},{"type":"block","id":"c4eb3Du2UIK1T9FxiUxt4","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":185},"end":{"line":9,"column":9,"offset":202}},"content":["SYNOPSIS"]},{"type":"block","id":"29IaSxaCXnc2w8RDYFgUW","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":204},"end":{"line":13,"column":4,"offset":229}},"content":[{"type":"verbatim","value":"use ValueMap;"}]},{"type":"block","id":"4USzY0bErxRXU4Ljkgp8w","margin":"","level":1,"name":"head","location":{"start":{"line":15,"column":1,"offset":231},"end":{"line":16,"column":12,"offset":254}},"content":["DESCRIPTION"]},{"type":"para","id":"dLqAqvtzUc91eD98SuB8S","margin":"","location":{"start":{"line":18,"column":1,"offset":256},"end":{"line":18,"column":186,"offset":441}},"text":"text","content":["The functionality provided by this module, will be provided in language level 6.e and higher. If an implementation of ValueMap is already available, loading this module becomes a no-op."]},{"type":"para","id":"CC7yn8AmGmGFKLrd8VQ5I","margin":"","location":{"start":{"line":20,"column":1,"offset":443},"end":{"line":20,"column":381,"offset":823}},"text":"text","content":["Raku provides a semi-immutable Associative datatype: Map. A Map can not have any elements added or removed from it. However, since a Map can contain containers of which the value can be changed, it is ",{"type":"fcode","name":"B","content":["not"]}," a value type. So you cannot use Maps in data structures such as Sets, because each Map is considered to be different from any other List, because they are not value types."]},{"type":"block","id":"RPrcYM4mXFjcflaX_soed","margin":"","level":1,"name":"head","location":{"start":{"line":22,"column":1,"offset":825},"end":{"line":23,"column":7,"offset":838}},"content":["AUTHOR"]},{"type":"para","id":"CXbemGspmGMTDALUd6xHR","margin":"","location":{"start":{"line":25,"column":1,"offset":840},"end":{"line":25,"column":37,"offset":876}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"block","id":"ROrhuQjq2LlrAfyvzT-xg","margin":"","level":1,"name":"head","location":{"start":{"line":27,"column":1,"offset":878},"end":{"line":28,"column":22,"offset":921}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"AkYs7NY0wZLu8e2-rMYvP","margin":"","location":{"start":{"line":30,"column":1,"offset":923},"end":{"line":30,"column":35,"offset":957}},"text":"text","content":["Copyright 2022 Elizabeth Mattijsen"]},{"type":"para","id":"XoZgkxfRUDunsCRjvyRP_","margin":"","location":{"start":{"line":32,"column":1,"offset":959},"end":{"line":32,"column":104,"offset":1062}},"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/ValueMap/ValueMap-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"Provide an immutable Map value type","dist":"ValueMap:ver<0.0.1>:auth<zef:lizmat>","license":"Artistic-2.0","name":"ValueMap","path":"V/AL/VALUEMAP/a7dc4df14e928be0410ec22c3ed49739a514dfd4.tar.gz","perl":"6.d","provides":{"ValueMap":"lib/ValueMap.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/ValueMap.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/ValueMap/ValueMap-0.0.1/README.md","publishUrl":"/mods/zef/ValueMap/ValueMap-0.0.1/README.md"},{"file":"work_mods/zef/ValueMap/ValueMap-0.0.1/lib/ValueMap.rakumod","publishUrl":"/mods/zef/ValueMap/ValueMap-0.0.1/lib/ValueMap.rakumod"}],"src":"zef","url":"/mods/zef/ValueMap"}}}
    =end data
    =end React


Provide an immutable Map value type


ValueMap


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


ValuePair

NAME

SYNOPSIS

DESCRIPTION

AUTHOR

COPYRIGHT AND LICENSE

ValuePair v0.0.1

Authors

License

Dependencies

Test Dependencies

Provides

Documentation