すべてのプロダクト
Search
ドキュメントセンター

OpenSearch:CString

最終更新日:Dec 28, 2024

概要

CStringクラスはcava.langパッケージにカプセル化されています。このクラスは、「opensearch」などの文字列定数を作成するために使用されます。CStringオブジェクトは、作成後に変更することはできません。

コンストラクター

関数

説明

CString(byte[] value, int offset, int count)

特定の文字配列に基づいて文字列を作成します。

CString(CString original)

指定されたCStringオブジェクトに基づいて文字列を作成します。

関数

関数

説明

int length()

文字列の長さを返します。

boolean isEmpty()

文字列が空かどうかを確認します。

byte byteAt(int index)

文字列の指定されたインデックスにある文字を返します。

boolean equals(CString anotherString)

2つの文字列が同じかどうかを確認します。

boolean equalsIgnoreCase(CString anotherString)

大文字と小文字を区別せずに、2つの文字列が同じかどうかを確認します。

int compareTo(CString anotherString)

2つの文字列を比較し、2つの文字列の最初の異なる文字間の辞書式順序の差を返します。

int compareToIgnoreCase(CString anotherString)

大文字と小文字を区別せずに、2つの文字列を比較し、2つの文字列の最初の異なる文字間の辞書式順序の差を返します。

boolean startsWith(CString prefix, int toffset)

文字列が特定のインデックスから特定のプレフィックスで始まるかどうかを確認します。

boolean startsWith(CString prefix)

文字列が特定のプレフィックスで始まるかどうかを確認します。

boolean endsWith(CString suffix)

文字列が特定のサフィックスで終わるかどうかを確認します。

int indexOf(CString str, int fromIndex)

指定されたインデックスから、指定された部分文字列が文字列内に最初に現れるインデックスを返します。

int indexOf(CString str)

指定された部分文字列が文字列内に最初に現れるインデックスを返します。

int lastIndexOf(CString str, int fromIndex)

指定された部分文字列が文字列内に最後に現れるインデックスを返します。この関数は、指定された終了インデックスから文字列を前方に向けて確認します。

int lastIndexOf(CString str)

指定された部分文字列が文字列内に最後に現れるインデックスを返します。

CString substring(int beginIndex, int endIndex)

指定された開始インデックスと終了インデックスに基づいて、文字列の部分文字列を返します。

CString substring(int beginIndex)

指定された開始インデックスから文字列の部分文字列を返します。

CString[] split(CString str)

特定の区切り文字に基づいて文字列を部分文字列に分割します。

CString[] split(CString str, int limit)

特定の区切り文字に基づいて文字列を部分文字列に分割します。

CString trim()

文字列の先頭と末尾のスペースを削除します。

void getChars(byte[] dst, int dstBegin)

文字列からコピー先の文字配列に文字をコピーします。

void getChars(int srcBegin, int srcEnd, byte[] dst, int dstBegin)

文字列からコピー先の文字配列に文字をコピーします。

関数の詳細

CString(byte[] value, int offset, int count)

特定の文字配列に基づいて文字列を作成します。この関数のより簡単な形式は CString test = "abc" です。この形式は、次のステートメントと同じ効果があります。

byte[] value = {(byte)'a', (byte)'b', (byte)'c'};
CString test = new CString(value, 0, 3);

パラメーター: value: 文字列の作成に使用する文字の配列。offset: 作成する文字列の最初の文字のインデックス。このパラメーターの値が 0 未満の場合、エラーが発生します。count: 作成する文字列の長さ。このパラメーターの値が 0 未満の場合、エラーが発生します。

CString(CString original)

特定の CString オブジェクトに基づいて文字列を作成します。パラメーター: original: コピーする CString オブジェクト。

サンプルコード:

CString a = "abc";
CString b = new CString(a);

長さ ()

文字列の長さを返します。戻り値: 文字列の長さ。値は0以上です。

サンプルコード:

CString a = "abc";
if (a.length() > 5) {
    // 何らかの処理を行う
}

CString(byte[] value, int offset, int count)

文字列が空かどうかを確認します。戻り値: 文字列の長さが0の場合はtrueを返します。それ以外の場合はfalseを返します。

サンプルコード:

CString a = "abc";
if (!a.empty()) {
    // 何らかの処理を行う
}

byte byteAt(int index)

文字列の特定のインデックスにある文字を返します。index パラメーターの値は [0,length()-1] の範囲内である必要があります。指定されたインデックスが文字列の長さより大きい場合、エラーが発生します。パラメーター: index: 返される文字のインデックス。戻り値: 特定のインデックスにある文字。

サンプルコード:

CString a = "abc";
byte b = a.byteAt(1);
byte b = a.byteAt(3); //無効です

boolean equals(CString anotherString)

2 つの文字列が同じかどうかを確認します。2 つの文字列が同じ場合は true を返します。それ以外の場合は false を返します。anotherString パラメーターの値が null 文字列の場合、null ポインター例外がトリガーされます。パラメーター: anotherString: 比較対象の文字列。戻り値: 2 つの文字列が同じ場合は true。それ以外の場合は false。

サンプルコード:

CString a = "abc";
CString b = "abc";
if (a.equals(b)) {
    // 何らかの処理を実行
}

boolean equalsIgnoreCase(CString anotherString)

大文字と小文字を区別せずに、2 つの文字列が同じかどうかを確認します。すべての文字を大文字または小文字に変換した後に 2 つの文字列が同じであれば、この関数は true を返します。それ以外の場合は、この関数は false を返します。 anotherString パラメーターの値が null 文字列の場合、null ポインター例外がトリガーされます。パラメーター: anotherString: 比較対象の文字列。戻り値: 2 つの文字列が同じ場合は、戻り値は true です。それ以外の場合は、戻り値は false です。

サンプルコード:

CString a = "abc";
CString b = "abc";
if (a.equalsIgnoreCase(b)) {
    // 何らかの処理を実行
}

int compareTo(CString anotherString)

2 つの文字列を比較し、2 つの文字列の最初の異なる文字間の辞書順序の差を返します。パラメーター: anotherString: 比較対象の文字列。戻り値: 2 つの文字列の最初の異なる文字間の辞書順序の差。2 つの文字列が同じ場合、戻り値は 0 です。2 つの文字列のいずれかがもう一方の文字列のプレフィックスである場合、戻り値は 2 つの文字列の長さの差です。

サンプルコード:

CString a = "abcde";
CString b = "abc";
CString c = "efg";
int v1 = a.compareTo(b); // v1 の値は、文字列 a の長さから文字列 b の長さを引いたものです。
int v2 = a.compareTo(c); // v2 の値は、文字 'a' と文字 'e' の辞書順の差です。
int v3 = a.compareTo("abcde"); // v3 の値は 0 です。

int compareToIgnoreCase(CString anotherString)

2 つの文字列を比較し、大文字と小文字を区別せずに、2 つの文字列の最初に異なる文字間の辞書順序の差を返します。この関数は、比較前に 2 つの文字列のすべての文字を大文字または小文字に変換します。パラメーター: anotherString: 比較対象の文字列。戻り値: 2 つの文字列の最初に異なる文字間の辞書順序の差。2 つの文字列が同じ場合、戻り値は 0 です。2 つの文字列のいずれか一方がもう一方の文字列のプレフィックスである場合、戻り値は 2 つの文字列の長さの差です。

サンプルコード:

CString a = "abcde";
int v1 = a.compareToIgnoreCase("AbcDe"); // v1 の値は 0 です。

boolean startsWith(CString prefix, int toffset)

文字列が特定のインデックスから特定のプレフィックスで始まるかどうかを確認します。パラメーター: prefix: 一致させる部分文字列。toffset: 部分文字列の照合を開始するインデックス。戻り値: 文字列が指定されたインデックスから指定されたプレフィックスで始まる場合、戻り値は true です。それ以外の場合、戻り値は false です。

サンプルコード:

CString a = "abcde";
boolean v1 = a.startsWith("bcd", 1); // v1 の値は true です。
boolean v2 = a.startsWith("bcd", 2); // v2 の値は false です。

boolean startsWith(CString prefix)

文字列が特定のプレフィックスで始まるかどうかを確認します。この関数は、`boolean startsWith(CString prefix, int toffset)` 関数の toffset パラメーターを 0 に設定するのと同じ効果があります。パラメーター: prefix: 一致させる部分文字列。戻り値: 文字列が指定されたプレフィックスで始まる場合、戻り値は true です。それ以外の場合、戻り値は false です。

サンプルコード:

CString a = "abcde";
boolean v1 = a.startsWith("abc"); // v1 の値は true です。
boolean v2 = a.startsWith("bcd"); // v2 の値は false です。

boolean endsWith(CString suffix)

文字列が特定の接尾辞で終わるかどうかを確認します。パラメーター: suffix: 一致させる部分文字列。戻り値: 文字列が指定された接尾辞で始まる場合、戻り値は true です。それ以外の場合、戻り値は false です。

サンプルコード:

CString a = "abcde";
boolean v1 = a.endsWith("de"); // v1 の値は true です。
boolean v2 = a.endsWith("cd"); // v2 の値は false です。

int indexOf(CString str, int fromIndex)

指定されたインデックスから、指定された部分文字列が文字列内で最初に出現するインデックスを返します。パラメーター: str: 一致させる部分文字列。fromIndex: 部分文字列の一致を開始する開始インデックス。戻り値: 指定されたインデックスから、指定された部分文字列が文字列内で最初に出現するインデックス。部分文字列が出現しない場合、戻り値は -1 です。

サンプルコード:

CString a = "abcdede";
int v1 = a.indexOf("de", 1); // v1 の値は 3 です。
int v2 = a.indexOf("de", 6); // v2 の値は -1 です。

CString::indexOf(CString str)

指定された部分文字列が文字列内で最初に出現するインデックスを返します。パラメーター: str: 一致させる部分文字列。戻り値: 指定された部分文字列が文字列内で最初に出現するインデックス。部分文字列が出現しない場合、戻り値は -1 です。

サンプルコード:

CString a = "abcdede";
int v1 = a.indexOf("de"); // v1の値は3です。
int v2 = a.indexOf("fg"); // v2の値は-1です。

int lastIndexOf(CString str, int fromIndex)

指定された部分文字列が最後に現れる文字列内のインデックスを返します。この関数は、指定された終了インデックスから前方へ文字列をチェックします。パラメーター: str: 一致させる部分文字列。fromIndex: 部分文字列の一致を開始するインデックス。戻り値: 指定された部分文字列が最後に現れる文字列内のインデックス。部分文字列が現れない場合、戻り値は -1 です。

サンプルコード:

CString a = "abcdede";
int v1 = a.lastIndexOf("de", 5); // v1 の値は 3 です。
int v2 = a.lastIndexOf("de", 2); // v2 の値は -1 です。

CString::lastIndexOf(CString str)

指定された部分文字列が最後に現れる文字列内のインデックスを返します。この関数は、指定された終了インデックスから前方に向かって文字列をチェックします。パラメーター: str: 一致させる部分文字列。fromIndex: 部分文字列の一致を開始するインデックス。戻り値: 指定された部分文字列が最後に現れる文字列内のインデックス。部分文字列が現れない場合は、戻り値は -1 です。

サンプルコード:

CString a = "abcdede";
int v1 = a.lastIndexOf("de"); // v1 の値は 5 です。
int v2 = a.lastIndexOf("fg"); // v2 の値は -1 です。

CString のサブストリング (int beginIndex)

指定された開始インデックスから文字列の部分文字列を返します。パラメーター: beginIndex: 返される部分文字列の開始インデックス。戻り値: 指定された開始インデックスからの文字列の部分文字列。指定された開始インデックスが 0 未満または文字列の長さより大きい場合、戻り値は null です。

サンプルコード:

CString a = "hello";
CString b = a.substring(3); // b の値は "lo" です。
CString c = a.substring(-1); // c の値は null です。
CString d = a.substring(7); // d の値は null です。

CString substring(int beginIndex, int endIndex)

指定された開始インデックスと終了インデックスに基づいて、文字列の部分文字列を返します。パラメーター: beginIndex: 返される部分文字列の開始インデックス。endIndex: 返される部分文字列の終了インデックス。戻り値: 指定された開始インデックスと終了インデックスに基づく文字列の部分文字列。指定された開始インデックスまたは終了インデックスが無効な場合、戻り値は null です。

サンプルコード:

CString a = "hello";
CString b = a.substring(3, 5); // b の値は "lo" です。
CString c = a.substring(-1, 3); // b の値は null です。
CString d = a.substring(0, 7); // d の値は null です。

CString[] split(CString str)

特定の区切り文字に基づいて文字列を部分文字列に分割します。結果配列の末尾にある空の文字列は削除されます。パラメーター: str: 文字列の分割に使用する区切り文字。戻り値: 指定された区切り文字に基づいて分割された部分文字列の配列。

サンプルコード:

CString a = "baaaab";
CString b = "baaaa";
CString c = "aaaab";
CString[] subA = a.split("aa"); // 結果の配列 subA には、3 つの部分文字列 "b"、""、および "b" が含まれます。
CString[] subB = b.split("aa"); // 結果の配列 subB には、1 つの部分文字列 "b" が含まれます。
CString[] subC = c.split("aa"); // 結果の配列 subC には、3 つの部分文字列 ""、""、および "b" が含まれます。

CString[] split(CString str, int limit)

文字列を指定された区切り文字に基づいて部分文字列に分割します。結果の配列内の部分文字列の数は、指定された制限を超えることはできません。指定された制限が 0 の場合、結果の配列の末尾にある空の文字列は削除されます。パラメーター: str: 区切り文字。limit: 結果の配列内の部分文字列の最大数。戻り値: 指定された区切り文字に基づいて分割された部分文字列の配列。

サンプルコード:

CString a = "hello";
CString[] b = a.split("l", 1); // 結果の配列 b には、1 つの文字列 "l" が含まれます。

CString::Trim()

文字列の先頭と末尾のスペースを削除します。戻り値: 先頭と末尾のスペースが削除された後の文字列。

サンプルコード:

CString a = " hello  ";
CString b = a.trim(); // 結果の文字列 b は "hello" です。

void getChars(byte[] dst, int dstBegin)

文字列からコピー先の文字配列に文字をコピーします。この関数は有効性チェックを実行しません。コピー先の文字配列の長さが、文字列の長さ以上であることを確認してください。パラメーター: dst: コピー先の文字配列。dstBegin: 文字列のコピーを開始するコピー先の文字配列内のインデックス。

サンプルコード:

byte[] dst = new byte[10];
CString a = "abc";
a.getChars(dst, 0);

void getChars(int srcBegin, int srcEnd, byte[] dst, int dstBegin)

指定された開始インデックスと終了インデックスに基づいて、文字列からコピー先の文字配列に文字をコピーします。パラメーター: srcBegin: コピーする文字列の最初の文字。srcEnd: コピーする文字列の最後の文字。dst: コピー先の文字配列。dstBegin: 文字列のコピーを開始するコピー先文字配列内のインデックス。

サンプルコード:

byte[] dst = new byte[10];
CString a = "abc";
a.getChars(0, 1, dst, 0);