Hey Thomas,<br><br><div class="gmail_quote">On Thu, Jul 14, 2011 at 8:21 PM, Thomas Chust <span dir="ltr">&lt;<a href="mailto:chust@web.de">chust@web.de</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
Markku Rontu wrote:<br>
&gt; [...]<br>
<div class="im">&gt; I&#39;m sure the section 11 does go through the relevant issues, but doesn&#39;t<br>
&gt; feel like a good introduction to the matter. I can theorise that I can<br>
&gt; manipulate these syntax objects with plain old functions but nowhere<br>
&gt; does it seem to show a complete useful case. What I&#39;m missing is an<br>
&gt; example that contains all the bits but that is not as complicated like<br>
&gt; the Racket sources themselves. Maybe I just didn&#39;t find it?<br>
&gt; [...]<br>
<br>
</div>Hello Markku,<br>
<br>
as others have already written it is easier and more rewarding to use<br>
syntax-case and other syntax related libraries available in Racket to<br>
write complex macros rather than to manipulate syntax objects by hand.<br>
Probably that is the case why the former functionality is more<br>
prominently featured in the documentation and the latter is left for the<br>
experts that are able to understand everything after glancing once at a<br>
dry reference document ;-)<br>
<br></blockquote><div>Thanks, I&#39;m very much against dry reference documents as marketing :-) Overall, I&#39;m very happy with the documentation in Racket, though I often wish there were more short examples scattered around.<br>
<br>I think the problem is the step between basic macrology and mastery. I&#39;m somewhere in there wandering. And wondering why it&#39;s so difficult when it should not be?<br> </div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">

Anyway, there is nothing magic about syntax objects, they are just<br>
wrappers around regular S-expression datums that add context<br>
information. To unwrap the data in a syntax object you use syntax-e.<br>
However, the data structure you get is likely to contain more syntax<br>
objects since context information is attached to every cons cell, every<br>
vector entry, every hash table value, etc.<br>
<br></blockquote><div>Well one problem is that all these syntax objects have introduced a new language, with accessors and functions that are completely new that must be learnt. And programs using these new functions look quite different to standard data structure (i.e., cons cell) manipulation. At least so far it looks like that to me. Clojure gives me vectors and hash-maps, so no new data structure but untyped data which I can manipulate trivially. There is no reason why it can&#39;t contain all the properties, source location, certificate etc. information. Just a different approach. I can&#39;t say approach which is better :-)<br>
 </div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
Therefore there are additional handy tools to access syntax objects: If<br>
you want to discard lexical context entirely and just turn a syntax<br>
object into data you can use syntax-&gt;datum, if you want to turn syntax<br>
representing a list into a list of syntax objects you can use syntax-&gt;list.<br>
<br>
For the other direction, to wrap some data into a syntax object, you use<br>
datum-&gt;syntax and supply an existing syntax object to provide the<br>
context for the new synthetic expression. In addition there is a<br>
quasiquote analogue for syntax objects that you can use.<br>
<br>
Using the syntax quasiquote notation respects hygiene by default, but<br>
unquoting some manually constructed object with the right context you<br>
can selectively break hygiene. Since you don&#39;t have to bother about<br>
manual generation of fresh identifiers and proper namespace references<br>
at all and still get hygienic behaviour by default, you can focus on the<br>
few points where you want to break hygiene. Therefore I even claim that<br>
this programming style will still be easier and less cluttered with<br>
boilerplate code in Racket than in Common Lisp or Clojure unless you<br>
disregard hygiene issues entirely.<br>
<br>
I&#39;ll give you an example implementation of the classical anaphoric if<br>
macro that selectively introduces an identifier called `it&#39; bound to the<br>
result of the test expression into the lexical context of the<br>
conditional&#39;s then branch and apart from that behaves just like the<br>
normal `if&#39;:<br>
<br>
  #lang racket/base<br>
  (require<br>
   (for-syntax racket/base))<br>
<br>
  (define-syntax (aif stx)<br>
    (cond<br>
      ;; We need one &quot;special&quot; command to unwrap the syntax object<br>
      ;; holding the whole statement ...<br>
      [(syntax-&gt;list stx)<br>
       =&gt; (lambda (forms)<br>
            (if (= (length forms) 4)<br>
                (let ([test-expr (cadr forms)]<br>
                      [then-expr (caddr forms)]<br>
                      [else-expr (cadddr forms)])<br>
                  ;; ... and one &quot;special&quot; command to introduce the<br>
                  ;; identifier `it&#39; into the correct context ...<br>
                  (let ([$it (datum-&gt;syntax then-expr &#39;it)])<br>
                    ;; ... however other languages would need a bunch<br>
                    ;; of magical incantations to make cond, else and<br>
                    ;; ë refer to the right things reliably, which we<br>
                    ;; get for free.<br>
                    #`(cond<br>
                        [#,test-expr =&gt; (ë (#,$it) #,then-expr)]<br>
                        [else #,else-expr])))<br>
                (raise-syntax-error<br>
                 #f &quot;expected test, then and else clauses&quot; stx)))]<br>
      [else<br>
       (raise-syntax-error #f &quot;expected list of expressions&quot; stx)]))<br>
<br>
  (provide<br>
   aif)<br>
<br>
For comparison, I also include an implementation to the same effect but<br>
using a nicer encapsulation of the break of hygiene, thanks to a helper<br>
module provided with Racket:<br>
<br>
  #lang racket/base<br>
  (require<br>
   (for-syntax racket/base srfi/26)<br>
   racket/stxparam)<br>
<br>
  ;; We declare the identifier of the special variable explicitly and<br>
  ;; we also export it later<br>
  (define-syntax-parameter it<br>
    (cut raise-syntax-error<br>
     #f &quot;implicit value used outside anaphoric if&quot; &lt;&gt;))<br>
<br>
  (define-syntax aif<br>
    (syntax-rules ()<br>
      [(aif test-expr then-expr else-expr)<br>
       (cond<br>
         [test-expr<br>
          =&gt; (ë (v)<br>
               ;; The syntax-parameterize form takes care of making the<br>
               ;; special variable refer to the right thing in the<br>
               ;; context of the macro expasion<br>
               (syntax-parameterize ([it (syntax-id-rules () [it v])])<br>
                 then-expr))]<br>
         [else<br>
          else-expr])]))<br>
<br>
  (provide<br>
   it aif)<br>
<br>
I hope the quick summary and examples are helpful :-)<br>
<div><div></div><div class="h5"><br>
Ciao,<br>
Thomas<br>
<br>
<br>
--<br>
When C++ is your hammer, every problem looks like your thumb.<br>
</div></div></blockquote></div><br><br>Thanks, I&#39;ll have a look later for the details. I&#39;m familiar with syntax-case because I often break hygiene in my macros to reduce repetition or to make the interaction in a DSL more state-machine -like. I&#39;m however sure that somebody else will find these discussions and examples useful too :-)<br>
<br>-Markku<br>