(60) Small Basic v0.8~ API リファレンス : Text
Textオブジェクトは、文字列を操作する機能を提供します。
Append
オペレーション : Append ( text1 , text2 )
2つのテキストを結合した結果を1つのテキストとして取得します。
この操作は数値としても扱えるテキストが間違って数値として扱われ、結合ではなく加算されてしまうおそれがある場合に効果があります。
| text1 | 文字列 | 結合するテキストの最初の部分。 |
| text2 | 文字列 | 結合するテキストの2番目の部分。 |
| 戻り値 | 文字列 | 指定した2つのテキストを結合したテキスト。 |
| 対応バージョン | v0.8~ | |
ConvertToLowerCase
オペレーション : ConvertToLowerCase ( text )
指定したテキストを小文字に変換します。
| text | 文字列 | 小文字に変換するテキスト。 |
| 戻り値 | 文字列 | 小文字に変換したテキスト。 |
| 対応バージョン | v0.8~ | |
ConvertToUpperCase
オペレーション : ConvertToUpperCase ( text )
指定したテキストを大文字に変換します。
| text | 文字列 | 大文字に変換するテキスト。 |
| 戻り値 | 文字列 | 大文字に変換したテキスト。 |
| 対応バージョン | v0.8~ | |
EndsWith
オペレーション : EndsWith ( text , subText )
指定したテキストの最後が、指定したサブテキストかどうかを取得します。
| text | 文字列 | 検索する対象のテキスト。 |
| subText | 文字列 | テキストの中を検索するサブテキスト。 |
| 戻り値 | 文字列 | 指定したテキストの最後が指定したサブテキストの場合は"True"、そうではない場合は"False"。 |
| 対応バージョン | v0.8~ | |
GetCharacter
オペレーション : GetCharacter ( characterCode )
指定したUnicodeの文字コードに対応する文字を取得します。
| characterCode | 数値 | Unicodeの文字コード。 |
| 戻り値 | 文字列 | 指定したUnicodeの文字コードに対応する文字。 |
| 対応バージョン | v0.8~ | |
GetCharacterCode
オペレーション : GetCharacterCode ( character )
指定した文字に対応するUnicodeの文字コードを取得します。
| character | 数値 | 文字。 |
| 戻り値 | 文字列 | 指定した文字に対応するUnicodeの文字コード。 |
| 対応バージョン | v0.8~ | |
GetIndexOf
オペレーション : GetIndexOf ( text , start )
指定したテキストの中からサブテキストを検索し、何文字目にあるかを取得します。
| text | 文字列 | 検索する対象のテキスト。 |
| start | 数値 | 検索するサブテキスト。 |
| 戻り値 | 数値 | 指定したテキスト中のサブテキストの位置。サブテキストが見つからなかった場合は、0を返します。 |
| 対応バージョン | v0.8~ | |
- v0.8 では、GetIndexOf オペレーションの動作は、サブテキストが見つからなかった場合は 0 を返します。
( 原文では、「-1」を返すと記載されています。 )
詳しくは (78) Text.GetIndexOf の戻り値が説明と異なる を参照してください。
GetLength
オペレーション : GetLength ( text )
指定したテキストの文字数を取得します。
| text | 文字列 | 文字数を取得するテキスト。 |
| 戻り値 | 数値 | 指定したテキストの文字数。 |
| 対応バージョン | v0.8~ | |
GetSubText
オペレーション : GetSubText ( text , start , length )
指定したテキストから、指定した開始位置から文字数分をサブテキスト(部分文字列)として取得します。
| text | 文字列 | サブテキストを取得する元のテキスト。 |
| start | 数値 | 取得を開始する位置。 何文字目から取得し始めるかを指定します。 |
| length | 数値 | 取得する文字数。 |
| 戻り値 | 数値 | 指定した開始位置から文字数分のサブテキスト(部分文字列)。 |
| 対応バージョン | v0.8~ | |
GetSubTextToEnd
オペレーション : GetSubTextToEnd ( text , start )
指定したテキストから、指定した開始位置から最後までをサブテキスト(部分文字列)として取得します。
| text | 文字列 | サブテキストを取得する元のテキスト。 |
| start | 数値 | 取得を開始する位置。 何文字目から取得し始めるかを指定します。 |
| 戻り値 | 数値 | 指定した開始位置から最後までのサブテキスト(部分文字列)。 |
| 対応バージョン | v0.8~ | |
IsSubText
オペレーション : IsSubText ( text , subText )
指定したテキストの中からサブテキストを検索し、あるかどうかを取得します。
| text | 文字列 | 検索する対象のテキスト。 |
| subText | 文字列 | テキストの中を検索するサブテキスト。 |
| 戻り値 | 文字列 | サブテキストが、指定したテキストの中に発見された場合は"True"、発見されなかった場合は"False"。 |
| 対応バージョン | v0.8~ | |
StartsWith
オペレーション : StartsWith ( text , subText )
指定したテキストの最初が、指定したサブテキストかどうかを取得します。
| text | 文字列 | 検索する対象のテキスト。 |
| subText | 文字列 | テキストの中を検索するサブテキスト。 |
| 戻り値 | 文字列 | 指定したテキストの最初が指定したサブテキストの場合は"True"、そうではない場合は"False"。 |
| 対応バージョン | v0.8~ | |
