<div dir="ltr"><div>Works like a charm!<br><br>Yamler (Erlang yaml file loader) now constructs yaml mappings as erlang maps.  I updated the README examples to show these maps in action:<br><br><a href="https://github.com/goertzenator/yamler/tree/mapping_as_map">https://github.com/goertzenator/yamler/tree/mapping_as_map</a><br>
<br></div><div><br></div><div>Thanks for maps!<br></div>Dan.<br></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Fri, Oct 25, 2013 at 11:37 AM, Björn-Egil Dahlberg <span dir="ltr"><<a href="mailto:egil@erlang.org" target="_blank">egil@erlang.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
  

    
  
  <div bgcolor="#FFFFFF" text="#000000">
    Hi!<br>
    <br>
    Here you go, Maps!<br>
    <br>
    I've pushed a Maps branch to Erlang/OTPs repository at GitHub.<br>
    <br>
    To get the branch,<br>
    <br>
    <tt>  git fetch <a href="mailto:git@github.com:erlang/otp.git" target="_blank">git@github.com:erlang/otp.git</a>
      egil/maps/eep-implementation</tt><br>
    <br>
    or find it at
    <a href="https://github.com/erlang/otp/tree/egil/maps/eep-implementation" target="_blank">https://github.com/erlang/otp/tree/egil/maps/eep-implementation</a><br>
    <br>
    I want to state the following so there is no room for uncertainty:<br>
    - This branch contains a <b>development stage</b> of the <b>experimental</b>
    Maps feature for Erlang.<br>
    <br>
    This means:<br>
     - Do not use it in production since it is not stable,<br>
     - Do not base any git branch on this branch since it will most
    likely be rebased,<br>
     - and finally, we reserve the right to change any API or interfaces
    to Maps currently implemented.<br>
    <br>
    The implementation is based on EEP 43 - Maps, see
    <a href="http://github.com/erlang/eep/blob/master/eeps/eep-0043.md" target="_blank">http://github.com/erlang/eep/blob/master/eeps/eep-0043.md</a>, for
    details.<br>
    <br>
    <u>What is implemented?</u><br>
    <br>
    The maps module API and erlang guard BIFs as defined in the EEP are
    implemented. There are however some sematic mismatches with the EEP.
    I think those are where the definition contradict itself. For
    instance maps:is_key/1 compares with =:= as stated first in the
    definition but the later example uses lists:keymember which compares
    with ==.<br>
    <br>
    The syntax and all what that entails is implemented. The compiler
    will handle the map syntax and produce loadable beam-code. I believe
    this is what people want to test and is what I want people to test.
    Test the usability that is.<br>
    <br>
    I recommend people look at the EEP for information and also the
    testsuite located at <tt>erts/emulator/test/map_SUITE.erl</tt> for
    information on how to use Maps since no other documentation is
    available.<br>
    <br>
    Roughly, <br>
    <tt>  </tt><tt>M0 = #{ key => Value1, "key" => Value2}, % for
      construction.</tt><tt><br>
    </tt><tt>  M1 = M1#{  "key" := Value3, <<"key">> =>
      Value4 }, % for updates</tt><tt><br>
    </tt><tt>  #{ "key" := V } = M1. % for matching</tt><tt><br>
    </tt><br>
    Where the operator '=>' (assoc operator) is used for extending
    and creating new Maps and the operator ':=' is used to update
    existing key/values. The ':=' operator is the only operator allowed
    in patterns. I'm guessing some confusion will arise from these two
    types of operators on where you can and/or should use them.<br>
    <br>
    Look at the tests and EEP for details and inspiration.<br>
    <br>
    A major difference from the EEP are variables in keys. Variables in
    keys are not allowed at all. This is because we want to reduce the
    scope for this first stage. Plenty to do besides that.<br>
    <br>
    Here are some additional disclaimers to make people sad.<br>
    <br>
    <u>What is not implemented?</u><br>
    <br>
    - No variable keys.<br>
    - No single value access.<br>
    - No map comprehensions.<br>
    - No datastructure to handle large Maps.<br>
    - No MatchSpecs which uses the Maps syntax will work.<br>
    <br>
    <u>Known issues</u><br>
    <br>
    - Dialyzer will not work with maps in the code, this include PLT
    building with erts and stdlib.<br>
    - HiPE, the native compiler, will not with maps code.<br>
    - EDoc will not work with maps.<br>
    <br>
    I'm sure there are other issues as well, it is a development branch
    after all. =)<br>
    <br>
    I would also like to point out that no optimizations are done either
    with respect to the generated code. This means that the instruction
    set may change. We know of several optimization we want to do before
    R17, especially for the match compiler so keep that in mind.<br>
    <br>
    We will continue stabilizing the Maps implementation as we move
    forward towards R17 and take appropriate action depending on the
    feedback you give us.<br>
    <br>
    I would like to continue with saying a few words about possible
    changes that we are thinking about.<br>
    <br>
    <u>Variables in Keys</u><br>
    <br>
    This feature is actually furthest down on the work prio list. We
    want to stabilize the current features before moving forward and
    variable keys is the one most likely to be dropped if we get pressed
    for time. Meaning, it might not be implemented for R17 but instead
    implemented for R18. The plan right now is to keep it though. <br>
    <br>
    <u>The External Format</u><br>
    <br>
    The current external format <i>needs</i> ordered keys as input for
    binary_to_term/1 and in distribution.<br>
    <br>
    This is of course an inconvinience when dealing with other language
    interfaces which has no idea of what the erlang term order is. I
    instead propose that the external format should handle unordered
    input of key-value pairs. The trade off is a more complicated
    decoding which will take longer.<br>
    <br>
    The distribution format should also be extended to be able cache
    keys. This is similar to the atom cache except we<br>
    cache the entire key array for maps. This has been the intention all
    along but it not mentioned in the EEP.<br>
    <br>
    <u>Term order and sorting</u><br>
    <br>
    Finally the term order. This has been a sore point from the get go.<br>
    <br>
    Maps currently respects the Erlang term order for it's keys.<br>
    <br>
    The Erlang term order is what I call arithmetic term order. I
    propose that we extend Erlang with true term order where integer
    compares less then float, i.e. total term order.<br>
    <br>
    This would allowing newer ordered data structures, like maps, to be
    more useful. We don't have to take<br>
    special care for the odd cases like keys 1.0 and 1 inhabiting the
    same slot in the data structure. gb_trees and such structures could
    also be extended to use this as those structures has the same
    limitations.<br>
    <br>
    With this type ordering we could have maps with this type of keys,
    #{ 1 => "integer", 1.0 => "float" } without causing confusion.<br>
    <br>
    I've been told that ETS ordered sets tables used to have this
    behaviour. Distinguishing between floats and integers. This was
    supposedly before the open source era, way back when dinosaurs
    roamed the planet .. I'm not clear on the details on why this
    behaviour was removed. Probably because of inconsistencies.<br>
    <br>
    For maps to work with this I only need two things. First, a compare
    operation in the runtime that can distinguish between floats and
    integers, very easy. Secondly, a BIF that sort a list of terms with
    this new compare operation which will be used in the compiler.<br>
    <br>
    But for completness, the following operators should also be
    implemented:<br>
    <br>
        =:=         term exact equal to, already implemented<br>
        =/=         term not equal to, already implemented<br>
        =:<         term less or equal than<br>
        >:=         term greater or equal than<br>
        <:<         term less than<br>
        >:>         term greater than<br>
    <br>
    So, true = 1 <:< 1.0.<br>
    <br>
    I don't know prolog but perhaps these sematics should mimic prolog
    to respect Erlangs heritage. I have no strong opinion on this.<br>
    <br>
    This syntax would mimic the already present =:= and =/= relational
    operators hower this syntax is another topic and should be a
    seperate EEP.<br>
    <br>
    Happy testing!<br>
    <br>
    Regards,<br>
    Björn-Egil Dahlberg<br>
    Erlang/OTP<br>
  </div>

<br>_______________________________________________<br>
erlang-questions mailing list<br>
<a href="mailto:erlang-questions@erlang.org">erlang-questions@erlang.org</a><br>
<a href="http://erlang.org/mailman/listinfo/erlang-questions" target="_blank">http://erlang.org/mailman/listinfo/erlang-questions</a><br>
<br></blockquote></div><br></div>