如何在JavaDocs中引用"*/"

我需要*/在我的JavaDoc评论中包含这些内容.问题是这也是关闭评论的顺序.引用/逃避这个的正确方法是什么？

例:

/**
 * Returns true if the specified string contains "*/".
 */
public boolean containsSpecialSequence(String str)

跟进:似乎我可以使用/斜线.唯一的缺点是,在文本编辑器中直接查看代码时,这并非完全可读.

/**
 * Returns true if the specified string contains "*/".
 */

Randolpho.. 37

使用HTML转义.

所以在你的例子中:

/**
 * Returns true if the specified string contains "*/".
 */
public boolean containsSpecialSequence(String str)

/ 以"/"字符转义.

Javadoc应该将未经过修改的转义序列插入到它生成的HTML中,并且应该在浏览器中呈现为"*/".

如果你想要非常小心,你可以逃避两个角色:*/转换为*/

编辑:

跟进:似乎我可以使用/ 为斜线.唯一的缺点是,在直接查看代码时,这并非完全可读.

所以？关键不在于您的代码是可读的,关键是您的代码文档是可读的.大多数Javadoc评论都嵌入了复杂的HTML来进行解释.地狱,C#的等价物提供了一个完整的XML标签库.我在那里看到了一些相当错综复杂的结构,让我告诉你.

编辑2: 如果它太困扰你,你可能会嵌入一个解释编码的非javadoc内联注释:

/**
 * Returns true if the specified string contains "*/".
 */
// returns true if the specified string contains "*/"
public boolean containsSpecialSequence(String str)

我已经去了B. (2认同)

除了我之外,这会打扰别人吗？现在它在javadoc中看起来很不错但是当你只是查看源代码时它是不可读的...... (2认同)

Lyubomyr Sha.. 9

没人提到{@literal}.这是另一种方式:

/**
 * Returns true if the specified string contains "*{@literal /}".
 */

/**
 * Returns true if the specified string contains "*/".
 */

/**
 * Returns true if the string contains an asterisk followed by slash.
 */

*/ 

/**
 * Returns true if the specified string contains "*/".
 */
public boolean containsSpecialSequence(String str)

/**
 * Returns true if the specified string contains "*/".
 */
// returns true if the specified string contains "*/"
public boolean containsSpecialSequence(String str)

/**
 * Returns true if the specified string contains "*{@literal /}".
 */

/**
 * Returns true if the specified string contains "*/".
 */

/**
 * Returns true if the string contains an asterisk followed by slash.
 */

*/ 

  /**
   * */
   */

// */ is html for */