org.apache.commons.lang
クラス CharSetUtils

java.lang.Object
  org.apache.commons.lang.CharSetUtils

public class CharSetUtils

extends Object

文字のセットを処理する多くのルーチン。

Numerous routines to manipulate a character set.

バージョン:

$Id: CharSetUtils.java,v 1.1.1.1 2004/02/13 10:02:04 hioki Exp $

作成者:

Henri Yandell, Stephen Colebourne

翻訳者:

日置 聡

翻訳状況:

初稿(校正者募集中)

翻訳更新日:

2003/08/11

コンストラクタの概要

CharSetUtils()
CharSetUtils のインスタンスは一般的なプログラムからは生成すべきではありません。

メソッドの概要

static int	count(String str, String set) 指定された文字列の中にある指定された文字セット (evaluateSet を参照) に該当する文字の数を返します。
static int	count(String str, String[] set) 指定された文字列の中にある指定された文字セット (evaluateSet を参照) に該当する文字の数を返します。
static String	delete(String str, String set) 指定された文字列の中にある指定された文字セット (evaluateSet を参照) に該当する文字を削除します。
static String	delete(String str, String[] set) 指定された文字列の中にある指定された文字セット (evaluateSet を参照) に該当する文字を削除します。
static CharSet	evaluateSet(String[] set) 以下の文法に従って文字のセットを取り扱う CharSetUtil のオブジェクトを生成します。
static String	squeeze(String str, String set) 指定されたセットに該当する連続する文字を圧縮します。
static String	squeeze(String str, String[] set) 指定されたセットに該当する連続する文字を圧縮します。
static String	translate(String target, String repl, String with) 指定された文字列の中の文字の置き換えを行います。

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

CharSetUtils

public CharSetUtils()

CharSetUtils のインスタンスは一般的なプログラムからは生成すべきではありません。 代わりに CharSetUtils.evaluateSet(null); というように使用すべきです。 このコンストラクタは、処理のために JavaBean インスタンスを必要とするツールのために public になっています。

CharSetUtils instances should NOT be constructed in standard programming. Instead, the class should be used as CharSetUtils.evaluateSet(null);. This constructor is public to permit tools that require a JavaBean instance to operate.

メソッドの詳細

evaluateSet

public static CharSet evaluateSet(String[] set)

以下の文法に従って文字のセットを取り扱う CharSetUtil のオブジェクトを生成します。 "aeio" の記述は 'a','e',.. を含める事を意味します。 "^e" の記述は e 以外を含める事を意味します。 しかしこれは指定された文字を否定するだけで、セットのサイズを大きくすることはありません。 "ej-m" の記述は e と j から m までを含める(e,j,k,l,m)を意味します。

Creates a CharSetUtils object which allows a certain amount of set logic to be performed upon the following syntax: "aeio" which implies 'a','e',.. "^e" implies not e. However it only negates, it's not a set in itself due to the size of that set in unicode. "ej-m" implies e,j->m. e,j,k,l,m.

パラメータ:

set -

set

戻り値:

CharSet

CharSet

例外:

NullPointerException - set[i] のどれか、または set 自身が null の場合

if any of set[i] is null or if set is null

squeeze

public static String squeeze(String str,
                             String set)

指定されたセットに該当する連続する文字を圧縮します。 例えば squeeze("hello", "el") は(セットに含まれる l が圧縮されて) "helo" になります。 セットの記述方法に関しては evaluateSet に記述されている文法を参照してください。

Squeezes any repititions of a character that is mentioned in the supplied set. An example is: squeeze("hello", "el") => "helo" See evaluateSet for set-syntax.

パラメータ:

str - 作業の対象となる文字列

the string to work from

set - 処理に使用される文字セット

the character set to use for manipulation

squeeze

public static String squeeze(String str,
                             String[] set)

指定されたセットに該当する連続する文字を圧縮します。 例えば squeeze("hello", {"el"}) は(セットに含まれる l が圧縮されて) "helo" になります。 セットの記述方法に関しては evaluateSet に記述されている文法を参照してください。

Squeezes any repititions of a character that is mentioned in the supplied set. An example is: squeeze("hello", {"el"}) => "helo" See evaluateSet for set-syntax.

パラメータ:

str - 作業の対象となる文字列

the string to work from

set - 処理に使用される文字セット

the character set to use for manipulation

例外:

NullPointerException - str が null だった場合

if str is null

count

public static int count(String str,
                        String set)

指定された文字列の中にある指定された文字セット (evaluateSet を参照) に該当する文字の数を返します。 例えば count("hello", {"c-f","o"}) は 2 を返します。

Takes an argument in set-syntax, see evaluateSet, and returns the number of characters present in the specified string. An example would be: count("hello", {"c-f","o"}) returns 2.

パラメータ:

str - 文字の数を数える対象となる文字列

String target to count characters in

set - 数える文字セットを定義する文字列

String set of characters to count

count

public static int count(String str,
                        String[] set)

指定された文字列の中にある指定された文字セット (evaluateSet を参照) に該当する文字の数を返します。 例えば count("hello", {"c-f","o"}) は 2 を返します。

Takes an argument in set-syntax, see evaluateSet, and returns the number of characters present in the specified string. An example would be: count("hello", {"c-f","o"}) returns 2.

パラメータ:

str - 文字の数を数える対象となる文字列

String target to count characters in

set - 数える文字セットを定義する文字列の配列

String[] set of characters to count

delete

public static String delete(String str,
                            String set)

指定された文字列の中にある指定された文字セット (evaluateSet を参照) に該当する文字を削除します。 例えば delete("hello", {"c-f","o"}) は "hll" を返します。

Takes an argument in set-syntax, see evaluateSet, and deletes any of characters present in the specified string. An example would be: delete("hello", {"c-f","o"}) returns "hll"

パラメータ:

str - 文字を削除する対象となる文字列

String target to delete characters from

set - 削除する文字セットを定義する文字列

String set of characters to delete

delete

public static String delete(String str,
                            String[] set)

指定された文字列の中にある指定された文字セット (evaluateSet を参照) に該当する文字を削除します。 例えば delete("hello", {"c-f","o"}) は "hll" を返します。

Takes an argument in set-syntax, see evaluateSet, and deletes any of characters present in the specified string. An example would be: delete("hello", {"c-f","o"}) returns "hll"

パラメータ:

str - 文字を削除する対象となる文字列

String target to delete characters from

set - 削除する文字セットを定義する文字列の配列

String[] set of characters to delete

例外:

NullPointerException - str が null の場合

of str is null

translate

public static String translate(String target,
                               String repl,
                               String with)

指定された文字列の中の文字の置き換えを行います。 例えば translate("hello", "ho", "jy") は "jelly" を返します。 置き換えられる文字の定義数が置き換える文字の定義数より大きい場合には 最後に定義されている文字が使用されます。

Translate characters in a String. An example is: translate("hello", "ho", "jy") => jelly If the length of characters to search for is greater than the length of characters to replace, then the last character is used.

パラメータ:

target - 文字を置き換える対象となる文字列

String to replace characters in

repl - 置き換えられる文字を定義する文字列

String to find that will be replaced

with - 置き換える文字を定義する文字列

String to put into the target String

例外:

NullPointerException - target、with、repl のどれかが null だった場合

if target, with or repl is null