@eval ile belgeleme içinde meta programlama

Question

Bir docstring'i bir @eval makrosu ile tanımlanan bir işlevle ilişkilendirmeyi deniyorum; Ayrıca, dinamik olarak docstrings oluşturmak için sembolleri kullanmak istiyorum. Ben başarıyla @eval deyimi içinden $name başvuruda mümkün olmakla birlikte

for (f, name) in ((:add, :addition), ...) 
    @eval begin 
     @doc "Documentation for $name" -> 
     function f(args) 
      ## FUNCTION BODY 
     end 
    end 
end 

, ben docstringe kendi içinde $name başvuramaz. UndefVarError: name not defined hatasını verir.

1) Bunu çalışması için bir yolu var mı? @doc kapsamından çıkmak ve çevreleyen alandaki değişkenlere erişmek için birçok yol denedim, ancak başarılı olmadım.

2) -> sözdiziminin yapısı nedir?
Github'dan -> sözdizimini aldım, ancak Julia belgelerinde bundan bahsetmiyorum ve Julia'yı terbiyeli bir süre kullandım, daha önce hiç karşılaşmadım.

Answer 1

@jverzani tarafından bağlı olarak, gereken tüm ek bir $ olduğunu. İfade enterpolasyonu için bir $'a ihtiyaç vardır ve diğeri string enterpolasyonu için gereklidir. @scls bu biraz Julia 0.5 için değiştirilmesi gereken kaydetti

for (f, name) in ((:add, "addition"), (:sub, "subtraction"), ...) 
    @eval begin 
     @doc """ 
     This is the function $($name) 
     """ 
     function $f() 
      ## FUNCTION BODY 
     end 
    end 
end 

Cevabı biliyor kez Süper basit ...

Answer 2

olarak şöyledir: nihai kodudur. dokümanlarınızdan Advanced Usage bölümünden Yukarıdaki örnek şimdi bu yardımcı olabilecek

for (f,n) in ((:foo, "foo"), (:bar, "bar")) 
    @eval begin 
       @doc "This is the function $($n)" $f 
     function $f() 
      println($n) 
     end 
    end 
end 

`` `