Module.string オブジェクト

文字列データを扱うメソッドを提供するオブジェクト。


メソッドの概要
static String browse(String target [,String exclusion])
HTML特殊文字を変換します。
static Array chars(String target)
文字配列を取得します。
static String from(Object target)
文字列を取得します。
static Boolean isASCII(String target)
ASCIIコードチェックをします。
static Number quantity(String target ,String searchWord)
部分文字列の個数を取得します。
static Number refer(String target ,String piece ,String condition)
キーワードの個数の取得をします。
static Number size(String target)
文字列長を取得します。

メソッドの詳細
browse

static String browse(String target [,String exclusion])

HTML特殊文字を変換します。

HTML形式でブラウザに表示するための特殊文字の変換をします。 変換される文字は以下の通りです。
 < → &lt;
 > → &gt;
 & → &amp;
 " → &quot;
 半角スペース → &nbsp;
 改行・復帰 → <BR>
 
特定の文字を変換対象から除去したい場合は、除去対象の文字列を引数 exclusion に指定して下さい。
たとえば、半角スペースと『"』を変換しないようにする場合は以下のように指定します。
       Module.string.browse(targetString, " \"");
 
パラメータ
target String 対象データ
exclusion String 変換対象から除外する文字列 (省略可能)
返却値
String 変換結果文字列

chars

static Array chars(String target)

文字配列を取得します。

引数で指定された文字列内の各文字が要素となる配列を生成して 返却します。
返却される配列の要素数は、引数で指定された文字列内の文字数に 等しくなります。
パラメータ
target String 文字列データ
返却値
Array 文字配列

from

static String from(Object target)

文字列を取得します。

指定のデータを文字列に変換して返却します。
文字列および数値データは文字列変換して返却します。
それ以外の型のデータである場合、長さが 0 の文字列を返却します。

パラメータ
target Object 対象データ
返却値
String 変換結果文字列

isASCII

static Boolean isASCII(String target)

ASCIIコードチェックをします。

指定の文字列が ASCII コードのみで構成されているかどうかを チェックして結果を返却します。
返却値が false であった場合、指定の文字列ないにはダブルバイト文字 が含まれている可能性があります。
パラメータ
target String 対象データ
返却値
Boolean 真値:ASCII コードのみで構成されている / 偽値:ASCII コード以外の文字データが含まれている

quantity

static Number quantity(String target ,String searchWord)

部分文字列の個数を取得します。

指定文字列(target)内の部分文字列(piece)の個数を返します。
返却値は、0 以上の正整数になります。
指定文字列内に部分文字列が1つも検索できなかった場合には、0 を 返します。

パラメータ
target String 文字列データ
searchWord String 検索キーワード
返却値
Number 個数

refer

static Number refer(String target ,String piece ,String condition)

キーワードの個数の取得をします。

文字列から指定キーワードの個数を条件検索します。
検索キーワードは複数指定可能です。その場合、各キーワード を半角スペースで区切って指定してください。
引数 condition には、文字列定数として "AND" または "OR" を指定してください(大文字小文字は問いません)。 "AND" を指定した場合には、AND 条件でキーワード検索します。
"OR" を指定した場合には、OR 条件でキーワード検索します。
指定が正しくない場合には、デフォルトで AND 条件が適応されます。
返却値は、0 以上の正整数になります。
指定文字列内に部分文字列が1つも検索できなかった場合には、0 を返します。
パラメータ
target String 文字列データ
piece String 検索する部分文字列群
condition String パターンマッチ条件キーワード("AND" or "OR")
返却値
Number 個数

size

static Number size(String target)

文字列長を取得します。

Unicode で扱われている文字列を [install_directory]/conf/imart.xml の server-charset で指定されているローカルの文字コード体系に変換した結果の文字列長を 返却します。
パラメータ
target String 文字列データ
返却値
Number 文字列のバイト数(単位は byte)