如何将with-out-str与集合一起使用?

时间:2013-09-03 18:16:57

标签: clojure

我可以使用with-out-str(doc func)获取字符串值。

=> (with-out-str (doc first))
"-------------------------\nclojure.core/first\n([coll])\n  Returns the first item in the collection. Calls seq on its\n    argument. If coll is nil, returns nil.\n"    

但是,如果我尝试用函数集合做同样的事情,我只能为每个函数返回空字符串:

=> (map #(with-out-str (doc %)) [first rest])
("" "")

我在哪里错了?

1 个答案:

答案 0 :(得分:6)

不幸的是doc是一个宏,因此它不是clojure中的头等公民,因为你不能将它用作高阶函数。

user> (doc doc)
-------------------------
clojure.repl/doc
([name])
Macro
  Prints documentation for a var or special form given its name 

您所看到的是查找%两次文档的输出。

user> (doc %)
nil

user> (with-out-str (doc %))
""

因为在调用map之前(在运行时),在宏扩展时间内调用doc已完成运行。但是,您可以直接从包含函数的var的元数据中获取文档字符串

user> (map #(:doc (meta (resolve %))) '[first rest])
("Returns the first item in the collection. Calls seq on its\n    argument. If coll is nil, returns nil." 
 "Returns a possibly empty seq of the items after the first. Calls seq on its\n  argument.")