Main Content

matlab::data::CharArray

MATLAB 文字配列にアクセスするための C++ クラス

説明

CharArray オブジェクトを使用して、MATLAB® 文字配列を操作します。CharArray を作成するには、ArrayFactory クラスの createCharArray を呼び出します。

クラスの詳細

名前空間:

matlab::data

基底クラス:

TypedArray<char16_t>

インクルード:

CharArray.hpp

コンストラクター

コピー コンストラクター

CharArray(const CharArray& rhs)

CharArray(const Array& rhs)

説明

CharArray オブジェクトの共有データ コピーを作成します。

パラメーター

const CharArray& rhs

コピーする値。

const Array& rhs

ArrayType::CHAR オブジェクトとして指定される値。

スロー

matlab::data::InvalidArrayTypeException

入力 Array の型が ArrayType::CHAR ではありません。

#include "MatlabDataArray.hpp"

int main() {
    using namespace matlab::data;
    ArrayFactory factory;
    CharArray A = factory.createCharArray("This is a char array");
    CharArray B(A);
    return 0;
}
関連するトピック

createCharArray

代入演算子のコピー

CharArray& operator=(const CharArray& rhs)

CharArray& operator=(const Array& rhs)

説明

CharArray オブジェクトに共有データ コピーを代入します。

パラメーター

const CharArray& rhs

コピーする値。

const Array& rhs

ArrayType::CHAR オブジェクトとして指定される値。

戻り値

CharArray&

更新されたインスタンス。

スロー

matlab::data::InvalidArrayTypeException

入力 Array の型が ArrayType::CHAR ではありません。

#include "MatlabDataArray.hpp"

int main() {
    using namespace matlab::data;
    ArrayFactory factory;
    CharArray A = factory.createCharArray("This is a char array");
    CharArray C = factory.createCharArray("");

    // Arrays A and C refer to the same data.
    C = A;

    return 0;
}

移動コンストラクター

CharArray(CharArray&& rhs)

CharArray(Array&& rhs)

説明

CharArray オブジェクトの内容を新しいインスタンスに移動させます。

パラメーター

CharArray&& rhs

移動させる値。

Array&& rhs

ArrayType::CHAR オブジェクトとして指定される値。

スロー

matlab::data::InvalidArrayTypeException

入力 Array の型が ArrayType::CHAR ではありません。

#include "MatlabDataArray.hpp"

int main() {
    using namespace matlab::data;
    ArrayFactory factory;
    CharArray A = factory.createCharArray("This is a char array");

    // Move constructor - Creates B, copies data from A. A not valid.
    CharArray B(std::move(A));

    return 0;
}

移動代入演算子

CharArray& operator=(CharArray&& rhs)

CharArray& operator=(Array&& rhs)

説明

この CharArray オブジェクトに入力を代入します。

パラメーター

CharArray&& rhs

移動させる値。

Array&& rhs

ArrayType::CHAR オブジェクトとして指定される値。

戻り値

CharArray&

更新されたインスタンス。

スロー

matlab::data::InvalidArrayTypeException

入力 Array の型が ArrayType::CHAR ではありません。

#include "MatlabDataArray.hpp"

int main() {
    using namespace matlab::data;
    ArrayFactory factory;
    CharArray A = factory.createCharArray("This is a char array");

    // Move assignment - Data from A moved to C. A no longer valid.
    CharArray C = factory.createCharArray("");
    C = std::move(A);

    return 0;
}

メンバー関数

toUTF16

String toUTF16() const
戻り値

matlab::data::String

matlab::data::String である CharArray の内容。

スロー

なし

toAscii

std::string toAscii() const
戻り値

std::string

ASCII 文字列である CharArray の内容。

スロー

matlab::data::NonAsciiCharInRequestedAsciiOutputException

データには非 ASCII 文字が含まれています。

#include "MatlabDataArray.hpp"

int main()
{
	using namespace matlab::data;
	ArrayFactory f;
	auto arr = f.createCharArray("helloworld");
	std::string s = arr.toAscii();

	return 0;
}
関連するトピック

MATLAB での数学関数の評価

バージョン履歴

R2017b で導入