cpp_utils

C++のユーティリティー集

Embedded Binaries

Linked Frameworks

Accelerate.framework

yas_boolean

boolをvectorで扱うためのクラス。1要素のサイズをsizeof(bool)で確保できる。

std::vector<yas::boolean> vec{true, false};

vec[0]; // -> true
vec[1]; // -> false
sizeof(vec[0]); // -> sizeof(bool)

yas_cf_ref

CFオブジェクトを保持するためのクラス。yas::baseを継承している。

通常の生成ではオーナーシップを移動しないが、make_cf_refではオーナーシップを移動する。

// オーナーシップを移動しないで生成する場合
auto arrayObj = CFArrayCreate(nullptr, nullptr, 0, nullptr);
cf_ref<CFArrayRef> cf_obj(arrayObj);
CFRelease(arrayObj)

// オーナーシップを移動して生成する場合
auto cf_obj = make_cf_ref(CFArrayCreate(nullptr, nullptr, 0, nullptr));

yas_cf_utils

CoreFoundation関連のユーティリティ集。

CFStringRefとstd::stringの変換
CFArrayRefとstd::vectorの変換
数値とCFNumberの変換

yas_delaying_caller

実行したい処理をスタックして遅らせることができるクラス。

delaying_caller caller;

caller.push(); // カウントを1上げる

caller.request([](){
    // 処理
});

caller.pop(); // カウントが1下がって0になる。リクエストされた処理が呼ばれ、処理はクリアされる

caller.request([](){
    // 処理
}); // カウントが0なので、この時点ですぐに処理が呼ばれる

yas_each_data

インターリーブ・非インターリーブの違いを吸収してバイトデータを走査するためのクラス。

std::array<int8_t, 4> array_a{1, 2, 5, 6};
std::array<int8_t, 4> array_b{3, 4, 7, 8};
std::array<int8_t *, 2> array{array_a.data(), array_b.data()};

auto each_data = yas::make_each_data(array.data(), 2, 2, 2);

while (yas_each_data_next(each_data)) {
    std::cout << "idx:" << std::to_string(yas_each_data_index(each_data));
    std::cout << " value:" << std::to_string(yas_each_data_value(each_data)) << std::endl;
}

yas_each_dictionary

CFDirectoryRefをiteratorで扱えるようにするクラス。

NSDictionary *dict = @{ @"a": @"1", @"b": @"2", @"c": @"3" };

for (auto &pair : yas::each_dictionary{(__bridge CFDictionaryRef)dict}) {
    // 要素に対する処理
}

yas_each_index

iteratorで整数のインデックスを扱えるようにするクラス。

yas_exception

例外を発生させる関数群。

raise_with_reason -> 文字列を指定して例外を発生させる
raise_if_main_thread -> メインスレッドで呼ばれたら例外を発生させる
raise_if_sub_thread -> メインでないスレッドで呼ばれたら例外を発生させる

yas_flagset

テンプレートパラメータで指定したenum型の要素を持つbitsetを持つクラス。enumには要素の数と同じ値となるcountを宣言しておく。

enum class test_enum : std::size_t {
    flag_a,
    flag_b,

    count,
};

yas::flagset<test_enum> flagset;
flagset.set(test_enum::flag_a);

yas::flagset<test_enum> flagset2;
flagset2.set(test_enum::flag_a);

yas::flagset<test_enum> flagset3;
flagset3.set(test_enum::flag_b);

// 指定した値のビットが立っているか調べる
flagset.test(test_enum::flag_a); // trueを返す
flagset.test(test_enum::flag_b); // falseを返す

// 引数に渡したflagsetとAND演算をしてビットが立っているかを調べる
flagset.and_test(flagset2); // trueを返す
flagset.and_test(flagset3); // falseを返す

yas_flex_ptr

deprecated

どの数値のポインタ型としても扱えるようにするクラス。

yas_objc_cast

Objective-Cのオブジェクトに対してisKindOfClass:を呼んでテンプレートパラメータの型にキャストできればその型のオブジェクトとして返す。キャストできなければnilを返す。

NSMutableArray *array = [NSMutableArray array];

auto castedObj1 = objc_cast<NSArray>(array); // -> NSArrayのオブジェクトを返す
auto castedObj2 = objc_cast<NSString>(array); // -> nilを返す

yas_objc_ptr

Objective-Cのオブジェクトを保持するためのクラス。yas::baseを継承している。

通常の生成ではオーナーシップを移動しないが、make_objc_ptrではオーナーシップを移動する。

make_objc_ptrのstd::functionを引数に取るバージョンではautoreleaseを剥がしてObjective-Cのオブジェクトを保持する。

// オーナーシップを移動して生成
auto objc_obj1 = make_objc_ptr([[NSObject alloc] init]);

// autoreleaseを剥がしてオーナーシップを持ち生成
auto objc_obj2 = yas::make_objc_ptr([](){ return [NSArray array]; });

yas_fast_each

インデックスやポインタを走査するためのクラス。高速に処理するために値のアクセスやインデックスの移動はマクロを使う。

// インデックスを走査する場合
auto each = make_fast_each(5);

while (yas_fast_each_next(each)) {
    std::cout << "idx:" << yas_fast_each_index(each) << std::endl;
}

// ポインタを走査する場合
int array[3] = {2, 4, 6};

auto each = make_fast_each(array, 3);

while (yas_fast_each_next(each)) {
    std::cout << "idx:" << yas_fast_each_index(each) << " value:" << yas_fast_each_value(each) << std::endl;
}

yas_result

成功か失敗かを表すクラス。テンプレートパラメータの1つめが成功の型、2つめが失敗の型となる。2つの型は違っている必要がある。

成功の場合はvalue()に値があり、失敗の場合はerror()に値がある。両方に値を持つことはない。

operator bool()は成功ならばtrueを返し、失敗ならばfalseを返す。

std::string value("success");

yas::result<std::string, int> result1(value);

if (result1) { // 通る
    std::cout << "result1.value=" << result1.value() << std::endl; // -> result1.value=success
}

int error = 1;

yas::result<std::string, int> result2(error);

if (!result2) { // 通る
    std::cout << "result2.error=" << result2.error() << std::endl; // -> result2.error=1
}

yas_stl_utils

STLをサポートする関数群。

min_empty_key -> mapのkeyで使われていない最小の整数を返す。keyは整数型のみ。
index -> vectorの要素のインデックスを返す。見つからなければnulloptを返す。
filter -> predicateでtrueを返した要素だけのコレクションを返す。predicateの引数は要素の値そのもの。
erase_if -> predicateでtrueを返した要素をコレクションから削除する。predicateの引数はイテレータ。
erase_if_exists -> keyに一致するmapの要素を削除する。
for_each -> functionを要素の数だけ繰り返す。functionの引数はイテレータ。
connect -> 2つのvectorを合体したvectorを返す。
move_back_insert -> 第2引数のvectorを第1引数のvectorの後ろにmoveして連結する。
move_insert -> 要素をコレクションにmoveしてinsertする。第3引数
pull -> unordered_mapの要素を取得して削除する。
replace -> mapの要素を置き換える。
to_vector -> コレクションの要素を元にvectorを作る
to_unordered_set -> vectorからunordered_setを作る。
to_map -> vectorからmapを作る。functionでは要素からkeyを返す。
to_lower -> 小文字にした文字列を返す。
replaced -> sourceに含まれるtargetをreplacementに置き換えた文字列を返す。
joined -> componentsをseparatorでつなげた文字列を返す。
to_weak -> std::shared_ptrをstd::weak_ptrに変換する。

yas_to_bool

enumの値をboolに変換する。数値的に0であればfalse、0以外であればtrueを返す。

enum class test_enum {
    zero,
    one,
};

yas::to_bool(test_enum::zero); // -> false
yas::to_bool(test_enum::one); // -> true

yas_type_traits

has_operator_bool -> 型にoperator bool()が実装されているか調べる。

yas_unless

boolの判定を逆にするクラス。

yas::unless(false) // -> true
yas::unless(true) // -> false

yas_version

バージョンを表すクラス。

yas::version version{"1.2.3"};

version.str() // -> "1.2.3"
version.numbers() // -> {1, 2, 3}

yas_to_string

to_string -> yasのnamespaceでそのままstd::to_stringを呼ぶ関数。

yas_data

生データを扱うクラス。Accelerate.Frameworkが必要。

data -> 書き込み可能なデータ
const_data -> 書き込み不可のデータ
data_copy -> const_dataからdataへコピーをする

std::vector<float> src_vec{2.0f, 4.0f, 8.0f};
std::vector<float> dst_vec{0, 0, 0};

data_copy<float> data_copy{
  // const_dataの生成
  .src_data = make_const_data(src_vec),
  // dataの生成
  .dst_data = make_data(dst_vec),
  // コピーする長さ
  .length = 3
};

auto const result = data_copy.execute();

result.is_success(); // -> コピー成功ならtrueを返す

objective-audio / cpp_utils