matlab.unittest.constraints.StartsWithSubstring クラス

名前空間: matlab.unittest.constraints
スーパークラス: matlab.unittest.constraints.BooleanConstraint

値が指定の文字列で始まっているかどうかをテスト

説明

matlab.unittest.constraints.StartsWithSubstring クラスは、値が指定の文字列で始まっているかどうかをテストするための制約を提供します。

作成

説明

c = matlab.unittest.constraints.StartsWithSubstring(prefix) は、値が指定の文字列で始まっているかどうかをテストするための制約を作成します。この制約は、prefix で始まる string スカラーまたは文字ベクトルで満たされます。

c = matlab.unittest.constraints.StartsWithSubstring(prefix,Name,Value) は、1 つ以上の名前と値の引数を使用して追加のオプションを設定します。たとえば、c = matlab.unittest.constraints.StartsWithSubstring(prefix,"IgnoringCase",true) は大文字と小文字を区別しない制約を作成します。

入力引数

prefix — 期待される接頭辞

string スカラー | 文字ベクトル

期待される接頭辞。空でない string スカラーまたは文字ベクトルとして指定します。

この引数は Prefix プロパティを設定します。

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

例: c = matlab.unittest.constraints.StartsWithSubstring(prefix,IgnoringCase=true)

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: c = matlab.unittest.constraints.StartsWithSubstring(prefix,"IgnoringCase",true)

IgnoringCase — 大文字小文字の区別を無視するかどうか

false または 0 (既定値) | true または 1

大文字小文字の区別を無視するかどうか。数値または logical 0 (false) または 1 (true) として指定します。既定では、制約で大文字と小文字が区別されます。

この引数は IgnoreCase プロパティを設定します。

IgnoringWhitespace — 空白を無視するかどうか

false または 0 (既定値) | true または 1

空白を無視するかどうか。数値または logical 0 (false) または 1 (true) として指定します。既定では、制約で空白文字が区別されます。空白文字は、スペース (' ')、フォーム フィード ('\f')、改行 ('\n')、キャリッジ リターン ('\r')、水平タブ ('\t')、垂直タブ ('\v') です。

この引数は IgnoreWhitespace プロパティを設定します。

メモ

IgnoringWhitespace が true の場合、prefix に空白以外の文字が少なくとも 1 つ含まれていなければなりません。

プロパティ

Prefix — 期待される接頭辞

string スカラー | 文字ベクトル

期待される接頭辞。string スカラーまたは文字ベクトルとして返されます。

このプロパティは入力引数 prefix によって設定されます。

属性:

GetAccess	public
SetAccess	immutable

IgnoreCase — 大文字小文字の区別を無視するかどうか

false または 0 (既定値) | true または 1

大文字小文字の区別を無視するかどうか。logical 0 (false) または 1 (true) として返されます。既定では、制約で大文字と小文字が区別されます。

このプロパティは名前と値の引数 IgnoringCase によって設定されます。

属性:

GetAccess	public
SetAccess	private

IgnoreWhitespace — 空白を無視するかどうか

false または 0 (既定値) | true または 1

空白を無視するかどうか。logical 0 (false) または 1 (true) として返されます。既定では、制約で空白文字が区別されます。

このプロパティは名前と値の引数 IgnoringWhitespace によって設定されます。

属性:

GetAccess	public
SetAccess	private

例

値が指定の文字列で始まっているかどうかをテスト

StartsWithSubstring 制約を使用して、文字列が指定の接頭辞で始まっているかどうかをテストします。

最初に、この例で使用するクラスをインポートします。

import matlab.unittest.TestCase
import matlab.unittest.constraints.StartsWithSubstring

対話型テスト用にテスト ケースを作成します。

testCase = TestCase.forInteractiveUse;

実際の値を指定します。

str = "This Is One Long Message!";

str が "This" で始まっていることを検証します。

testCase.verifyThat(str,StartsWithSubstring("This"))

Verification passed.

str が部分文字列 "This is" で始まっているかどうかをテストします。制約で大文字と小文字が区別されるため、テストは失敗します。

testCase.verifyThat(str,StartsWithSubstring("This is"))

Verification failed.
    ---------------------
    Framework Diagnostic:
    ---------------------
    StartsWithSubstring failed.
    --> The value does not start with the supplied prefix.
    
    Actual Value:
        "This Is One Long Message!"
    Expected Prefix:
        "This is"

str が部分文字列 "thisisone" で始まっているかどうかをテストします。テストにパスするように、大文字小文字の区別および空白文字を無視します。

testCase.verifyThat(str,StartsWithSubstring("thisisone", ...
    "IgnoringCase",true,"IgnoringWhitespace",true))

Verification passed.

str が "Long" で始まっていないことを検証します。

testCase.verifyThat(str,~StartsWithSubstring("Long"))

Verification passed.

バージョン履歴

R2013a で導入

参考

matlab.unittest.constraints.ContainsSubstring | matlab.unittest.constraints.EndsWithSubstring | matlab.unittest.constraints.IsSubstringOf | matlab.unittest.constraints.Matches | verifyThat