-------------------------------------------------------------------------------- /*! @function getitemingroup @abstract gets a bagitem of a given group and a given position @param groupno int - the delivery group ordinal position in the bag @param pos int - the position of the bagitem within the group @result object - the bagitem in a given position of given group or -1 if it could not be found */ --------------------------------------------------------------------------------
-------------------------------------------------------------------------------- /*! @var idsession string - an unique session identifier */ var $idsession; -------------------------------------------------------------------------------- 最后接触 -------------------------------------------------------------------------------- /*! @header myprojectname @abstract a virtual store to shop on mars @discussion the difference [...] */ -------------------------------------------------------------------------------- @header标记用来提供一些关于被文档化的项目或类组的一般性信息。@header标记本身跟着项目的名字 ,而且可以用@abstract标记和@discussion标记来补充说明。因为类通常存在于不同的文件中(一个文件一个类,且用类的名字给文件名字是一种好的想法),你可能想知道应该将@header 标记放在什么地方。答案很让人吃惊,哪都可以。我的建议是:如果它比较长就把它放在一个独立的文件中,或如果是一个简短的说明就把它放在最重要的类的前面。