JavaAPIのドキュメトの読み方に関して

Question

２点質問があります。
以下２つの画像は、クラスStringから抜粋したものです。

上記画像の、 Comparator<String>ってどういう意味ですか？
過去、以下みたいなコードをよく書いた記憶はあるのですが、、、上記の意味が全くわかりません。
String a ="ああああ"

過去、以下のようなコードは書いたことがあるのですが、上記画像のように　int length()と書かれているのはなぜですか？
変数名.length()

ご多用の中、大変恐縮でございますが、ご教示のほどよろしくお願い致します。

Comments

[m.ts10806]

それぞれの参照先URLをご提示ください。
前後関係もなしに答えられるものでもないように思います。
（１つ目は明らかですが）

[asdfrgthyj]

お疲れ様です。いつもありがとうございます。

以下がURLです。
https://docs.oracle.com/javase/jp/8/docs/api/

Answer 1

過去、以下みたいなコードをよく書いた記憶はあるのですが、、、上記の意味が全くわかりません。

String a ="ああああ"

「以下のコード」には全く無関係です。全くわからないのであれば、おそらく使ったこともないかと思います。

上記画像のように　int length()と書かれているのはなぜですか？

返り値の型がint、という意味です。

Comments

[asdfrgthyj]

なるほど。いつもありがとうございます☺️

Answer 2

自分も分からなかったので、調べてみました。
結論としてはこれは比較のロジックを定義していて、大文字小文字を無視して比較します。
例えば以下のように使います。

//StringのListを大文字小文字を無視してソートする
List list = Arrays.asList("b", "A", "c");
Collections.sort(list, String.CASE_INSENSITIVE_ORDER); // "A","b","c"

ひとつずつ読み解いていきます。

static Comparator<String> CASE_INSENSITIVE_ORDER

Stringクラスのフィールドに 静的に Comparator<String>型 で CASE_INSENSITIVE_ORDER という名前で定義してます。
Comparator<String> というのは ジェネリック型にStringを設定したComparatorインターフェースです。
型によって比較のロジックが異なるのでジェネリック型を使ってるようですね。
ちなみにComparatorインターフェースの実装はStringクラス内にCaseInsensitiveComparatorという名前でありました。

compareToIgnoreCaseの場合と同じようにStringオブジェクトを順序付けるComparatorです。

compareToIgnoreCase は同じStringクラスのメソッドです。

書かれているように、大文字小文字の区別せず比較するメソッドで、
CASE_INSENSITIVE_ORDERはComparatorクラスで同様の比較をするために指定するパラメータだそうです。
以下のように使います。

String str = "AAA";
str.compareToIgnoreCase("BBB"); // -1
str.compareToIgnoreCase("aaa"); // 0

つまりソート処理 Collections.sort で繰り返し比較する際にcompareToIgnoreCaseメソッドと同等の処理がされている、ということです。

いろいろな用語が出てきてしまいました。
特に、おそらくジェネリクス（総称型）の理解が難しいかと思いますので、そちらは別途調べて頂ければと思います。