为什么有些有些类的方法无法在API手册中找到?
在看ruby api文档的时候总是觉得它的API文档怪怪的,不太适应。
就说API的组织形式吧,都不太明白每个窗口的含义。比如在标准库API文档里边,右边的窗口都不同步,比如点某个类,右上角的method中并不是该类的所有方法,这点就不太使用。
最近在查一个socket编程的问题,
server = TCPServer.new(PORT)
while ( session = server.accept )
mystr=session.recv(20)
发现使用recv方法接收指定大小的内容时会发生错误。然后在API手册中找不到这个recv方法究竟是哪个类定义的。
最后在源码socket.c中发现有这么一段:
rb_define_method(rb_cBasicSocket, "recv", bsock_recv, -1);
rb_define_method(rb_cBasicSocket, "recv_nonblock", bsock_recv_nonblock, -1);
我对源码不太了解,但是推测应该是basicsocket中定义的recv方法,可是遍历整个socket编程类,也没有在API文档中发现这个方法的说明。
请问究竟是我查找API手册的方法不对,没有找到位置呢,还是API手册本身就没有完全覆盖所有方法?
rdoc生成的帮助文件已经很好了,如果不够,就去 看test case,ruby就是这点好,源码和test是放在一起的。 ruby的设计是以开发人员导向的,我还没有见过比这个更加友好的工具了 :D
如果API的功能都要自己悟 哪学习曲线该多么高
同感,API文档似乎很简洁,便于查找,但层次不太清晰,而且用法也说得不是太明白,需要悟的地方太多...这难道是初学者才遇到的问题吗?
你看到的还是 basicsocket.recv_nonblock(maxlen) => mesg basicsocket.recv_nonblock(maxlen, flags) => mesg
这2个函数的解释
---------------------------------------------- BasicSocket#recv_nonblock basicsocket.recv_nonblock(maxlen) => mesg basicsocket.recv_nonblock(maxlen, flags) => mesg
这是我在网上找到的一个说明,为什么ruby本身的文档反而找不到这么详细的呢