You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@commons.apache.org by "Duncan Jones (JIRA)" <ji...@apache.org> on 2014/11/25 13:37:13 UTC
[jira] [Created] (LANG-1069) CharSet.getInstance documentation does
not clearly explain how to include negation character in set
Duncan Jones created LANG-1069:
----------------------------------
Summary: CharSet.getInstance documentation does not clearly explain how to include negation character in set
Key: LANG-1069
URL: https://issues.apache.org/jira/browse/LANG-1069
Project: Commons Lang
Issue Type: Bug
Components: lang.*
Affects Versions: 3.3.2
Reporter: Duncan Jones
Priority: Minor
Fix For: Patch Needed
As discussed in [this Stack Overflow question|http://stackoverflow.com/questions/27070515/how-can-i-include-the-caret-character-in-an-apache-commons-charset], the documentation for {{CharSet.getInstance()}} don't explain clearly how to include the negation character ({{^}}) as a literal character.
The two solutions suggested in the SO question are:
{code:java}
// Add the '^' on its own
CharSet.getInstance("^", "otherlettershere");
// Add the '^' as the last character
CharSet.getInstance("otherlettershere^")
{code}
If those are the best options, we should add a line to the Javadoc to indicate this. If there is a better way, clearly that should be documented instead.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)