suzanne.soy/lens
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

document nested clauses and update example

Browse Source
This commit is contained in:
AlexKnauth 2015-12-05 00:33:32 -05:00
parent 67b5ae5421
commit a00bc4bf55
1 changed files with 25 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
unstable/lens/define-nested.scrbl
View File

@ -5,7 +5,9 @@
@title{Lenses for nested data} @title{Lenses for nested data}
@defform[(define-nested-lenses [base-id base-lens-expr] clause ...) @defform[(define-nested-lenses [base-id base-lens-expr] clause ...)
#:grammar ([clause [sub-id sub-lens-expr]])]{ #:grammar ([clause [sub-id sub-lens-expr
clause
...]])]{
A shorthand for defining composed lenses for nested data structures. A shorthand for defining composed lenses for nested data structures.
For example, if there is a @racket[top] struct containing a For example, if there is a @racket[top] struct containing a
@ -19,16 +21,27 @@ Will define @racket[top-middle-x-lens] and @racket[top-middle-y-lens]
as @racket[(lens-thrush top-middle-lens middle-x-lens)] and as @racket[(lens-thrush top-middle-lens middle-x-lens)] and
@racket[(lens-thrush top-middle-lens middle-y-lens)]. @racket[(lens-thrush top-middle-lens middle-y-lens)].
Clauses can be nested within other clauses as well:
@lens-unstable-examples[ @lens-unstable-examples[
(struct/lens ball (mass position velocity) #:transparent) (struct/lens game (player1 player2))
(struct/lens position (x y) #:transparent) (struct/lens player (position score))
(struct/lens velocity (x y) #:transparent) (struct/lens position (x y))
(define-nested-lenses [ball-pos ball-position-lens] (define-nested-lenses [game-player1 game-player1-lens]
[x position-x-lens] [score player-score-lens]
[y position-y-lens]) [position player-position-lens
(define-nested-lenses [ball-vel ball-velocity-lens] [x position-x-lens]
[x velocity-x-lens] [y position-y-lens]])
[y velocity-y-lens]) (define-nested-lenses [game-player2 game-player2-lens]
(lens-view ball-vel-x-lens (ball 1 (position 2 3) (velocity 4 5))) [score player-score-lens]
(lens-set ball-vel-x-lens (ball 1 (position 2 3) (velocity 4 5)) 1004) [position player-position-lens
[x position-x-lens]
[y position-y-lens]])
(define the-game (game (player (position 1 2) 5) (player (position 3 4) 6)))
(lens-view game-player1-score-lens the-game)
(lens-view game-player1-position-lens the-game)
(lens-view game-player1-position-x-lens the-game)
(lens-set game-player1-score-lens the-game 9005)
(lens-set game-player1-position-lens the-game (position 2 0))
(lens-set game-player1-position-x-lens the-game 3)
]} ]}