You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@commons.apache.org by "tza (Jira)" <ji...@apache.org> on 2025/07/23 12:31:00 UTC

[jira] [Updated] (LANG-1780) Javadoc of new Strings API

     [ https://issues.apache.org/jira/browse/LANG-1780?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

tza updated LANG-1780:
----------------------
    Description: 
Several Javadoc of the new Strings-API was created with old method calls - where you had xx and xxIgnoreCase in StringUtils. Like contains and containsIgnoreCase looking at the new javadoc of Strings.CS/CI.contains:

 
{code:java}
* Strings.CI.containsIgnoreCase("abc", "A") = true     
* Strings.CI.containsIgnoreCase("abc", "Z") = false     
* </pre>     
*     
* @param seq       the CharSequence to check, may be null     
* @param searchSeq the CharSequence to find, may be null     
* @return true if the CharSequence contains the search CharSequence, false if not or {@code null} string input     */    
public abstract boolean contains(CharSequence seq, CharSequence searchSeq);{code}
 

but CS/CI only supports the method contains (containsIgnoreCase was the old name from StringUtils). I would expect Strings.CI.contains() here in the examples.

  was:
Several Javadoc of the new Strings-API was created with old method calls - where you had xx and xxIgnoreCase. Like contains and containsIgnoreCase looking at the new javadoc:

 

 
{code:java}
Strings.CI.containsIgnoreCase(null, *)    = false     Strings.CI.containsIgnoreCase(*, null)    = false       Strings.CI.containsIgnoreCase("", "")     = true       Strings.CI.containsIgnoreCase("abc", "")  = true       Strings.CI.containsIgnoreCase("abc", "a") = true      Strings.CI.containsIgnoreCase("abc", "z") = false       Strings.CI.containsIgnoreCase("abc", "A") = true       Strings.CI.containsIgnoreCase("abc", "Z") = false
{code}
 

 

but CS/CI only supports the method contains (containsIgnoreCase was the old name from StringUtils).


> Javadoc of new Strings API
> --------------------------
>
>                 Key: LANG-1780
>                 URL: https://issues.apache.org/jira/browse/LANG-1780
>             Project: Commons Lang
>          Issue Type: Improvement
>          Components: lang.*
>    Affects Versions: 3.18.0
>            Reporter: tza
>            Priority: Minor
>
> Several Javadoc of the new Strings-API was created with old method calls - where you had xx and xxIgnoreCase in StringUtils. Like contains and containsIgnoreCase looking at the new javadoc of Strings.CS/CI.contains:
>  
> {code:java}
> * Strings.CI.containsIgnoreCase("abc", "A") = true     
> * Strings.CI.containsIgnoreCase("abc", "Z") = false     
> * </pre>     
> *     
> * @param seq       the CharSequence to check, may be null     
> * @param searchSeq the CharSequence to find, may be null     
> * @return true if the CharSequence contains the search CharSequence, false if not or {@code null} string input     */    
> public abstract boolean contains(CharSequence seq, CharSequence searchSeq);{code}
>  
> but CS/CI only supports the method contains (containsIgnoreCase was the old name from StringUtils). I would expect Strings.CI.contains() here in the examples.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)