Source Insight使用

发表于2024-05-06更新于2025-09-28阅读次数

快速上手

  1. 左上角，Project，New Project，新建一个工程。出现以下界面：
  2. Source Insight的工程文件夹和源码根文件夹需要并列在一起。可以在源码根文件夹之外创建一个"Insight"（名字自定）的文件夹。
  3. 将Insight的目录地址拷贝到第1步的第2个空内。点击OK。
  4. 出现New Project Settings窗口，默认不改变设置。继续OK。
  5. 出现Add and Remove Project Files窗口，点击源码根文件夹，再点击右侧边的Add Tree按钮。添加完成后，Close此窗口即可。
  6. 添加完工程文件后。接着，左上角，Project，Synchronize Files。同步以后，在Source Insight中编辑时可以同时同步磁盘上的文件。（不同步其实也可以，麻烦之处就是如果稍微改动一下代码它就总会提示是否保存）
  7. 同步完后，即可点击工具栏中的圆圈带P的按钮，打开菜单，查看文件。

配置

如果文件后缀名不是常规的，比如Cpp的.cpp扩展名写作了.cc，那么就需要人为配置。

  1. 左上方，Options，File Type Options
  2. 左侧栏选择某一语言的文件类型，在右侧最上方的File Filter中详细加规则，如图：
  3. 配置完后，需要再次Add Tree，需要点击Project，Add and Remove Project Files

快捷键配置

Options，Key Assignments。可以配置代码高亮的快捷键。

Cpp_Concepts

发表于2024-04-24更新于2024-04-24阅读次数

Concepts

意为概念，用于限定类型是哪些子类型。

Concepts中的requires约束

1
2
3
4
5
6
7
8
9
10
11
12
13
#include<iostream>
#include<concepts>
template <typename T>
T add<T a, T b>
{
    return a + b;
}

int main()
{
    auto c = add(1, 2);
    return 0;
}

以上，会自动推断出1、2为int，返回值3亦为int。
目前有需求，仅仅想要add进行int的计算，比如禁止浮点型的计算。则可用requires约束

1
2
3
4
5
6
7
8
9
10
11
12
13
#include<iostream>
#include<concepts>
template <typename T> requires(std::integral<T>)
T add(T a, T b)
{
    return a + b;
}

int main()
{
    auto c = add(1, 2);
    return 0;
}

如果main函数调用add时传入浮点型：则编译不通过

报错：
no instance of function template “add” matches the argument list
argument types are: (double, double)

1
2
3
4
5
int main()
{
    auto c = add(1.0, 2.0);   // error
    return 0;
}

如果想要接受浮点型数据，可以在requires中加入||

1
2
3
4
5
6
7
8
9
10
11
template <typename T> requires(std::integral<T> || std::floating_point<T>)
T add(T a, T b)
{
    return a + b;
}

int main()
{
    auto c = add(1.0, 2.0);     // ok
    return 0;
}

type_traits

Type Traits就是在编译期把各种情况列举出来，根据不同的种类去判断T是不是属于某种情况。然后就可以用在concept中。

std::is_integral

Member types:

member type definition
value_type bool
type either true_type or false_type

Member constants:

member constant definition
value either true or false

std::is_integral后面往往要加<T>::value以取出真假值，或者可以用std::is_integral_v<T>代替。

1
2
3
// concepts 文件 中 std::integral<T>的原型
_EXPORT_STD template <class _Ty>
concept integral = is_integral_v<_Ty>;

有好多种写法：

  1. std::integral<T>
  2. std::is_integral<T>::value
  3. std::is_integral_v<T>

自定义concept

针对某种类型进行约束：

1
2
template<typename T>
concept my_concept = std::integral<T> || std::floating_point<T>;

如此，requires后面使用约束条件就更加方便了：

1
2
3
4
5
template<typename T> requires(my_concept<T>)
T add(T a, T b)
{
    return a + b;
}

更复杂的concept

requires不仅可以直接使用concept，也可以用于定义新的concept。
如：template<typename T> concept my_concept = requires(T t) { // ... }
或template<typename T> concept my_concept = requires(bool参数)
第一种是使用一些类型参数，大括号内会去匹配你规定的形式，这些形式需要遵循官方规定的写法。

限制 类必须有 某个限定函数

如下定义，表达的是：t是否有名为get_v、无参数的方法，并且返回的是不是bool类型。

1
2
3
4
5
template<typename T>
concept my_concept = requires(T t)
{
    { t.get_v() } -> std::same_as<bool>;
}; // 记得加;

使用如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
class Test
{
public:
    bool get_v(void)
    {
        return true;
    }
};
template<typename T> requires(my_concept<T>)
void show(T t)
{
    auto r = t.get_v();
    std::cout << r << std::endl;
}
int main()
{
    Test test;
    show(test);
}

如果把Test类中的get_v方法改名为get_v2，让show函数调用t.get_v2。最后编译不通过。因为模板参数T对应的Test类中没有名为get_v、无参数且返回值为bool的方法。

报错：
no instance of function template “show” matches the argument list
argument types are: (Test)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
template<typename T>
concept my_concept = requires(T t)
{
    { t.get_v() } -> std::same_as<bool>;
};
class Test
{
public:
    bool get_v2(void)
    {
        return true;
    }
};
template<typename T> requires(my_concept<T>)
void show(T t)
{
    auto r = t.get_v2();  // 不报错，但main函数中的show(test)报错
    std::cout << r << std::endl;
}
int main()
{
    Test test;
    show(test);    // error
}

对成员方法的const修饰符忽略

bool get_v(void) const虽然加了const，但可以通过

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
template<typename T>
concept my_concept = requires(T t)
{
    { t.get_v() } -> std::same_as<bool>;
};
class Test
{
public:
    bool get_v(void) const // 虽然加了const 但可以通过
    {
        return true;
    }
};
template<typename T> requires(my_concept<T>)
void show(T t)
{
    auto r = t.get_v();
    std::cout << r << std::endl;
}
int main()
{
    Test test;
    show(test);   // ok
}

复合

  1. T类型有名为get_v、无参数的方法，并且返回bool类型。
    1. 必须有{ } -> type的形式
  2. T类型有名为read的方法，且参数必须是u的类型std::string const &。没有规定返回值类型
  3. T类型必须有名为val的成员变量
    1. 发现如果定义val为private（甚至static private）是不可以通过的，必须是可以从外部访问的。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
template <typename T>
concept my_concept = requires(T t, std::string const& u)
{
    { t.get_v() } -> std::same_as<bool>;
    t.read(u);
    T::val;  // 或者写成t.val;
};

class Test
{
public:
    bool get_v(void) const // 虽然加了const 但可以通过
    {
        return true;
    }
    void read(std::string const& str) const
    {
    }
public:
    int val{ 5 }; // ok
/*
private:
    static int val;  //error
*/
};

嵌套requires

可以用来限定某一个成员变量的类型

requires的内容是：T类型中要有val，而且val的类型要和float一样。

1
2
3
4
5
template <typename T>
concept my_concept = requires(T t)
{
    requires std::same_as<decltype(t.val), float>;
};

应用

通过concepts约束迭代器类型

在没有concept之前，编程时乱用不匹配的迭代器编译时是不知道对错的，运行的时候才报错。
而Modern C++之后随着模板和concept的发展，可以约束迭代器的行为。比如规定此迭代器类必须支持++、--操作，从而此迭代器是Bidirectional。
有了concepts，在编译期就能知道程序的对错了。

通过concepts约束谓词类

  1. 首先编写针对Unary Predicate的concept
  2. 再加到find_if这个模板函数后限定：
    1. “模板参数1 UnaryPredicate”符合UnaryPredicateConcept中T的要求。（T有t(*u)且返回bool的方法）
  3. 注意，t(*u)中u前必须有*，不然t()的参数将被限定为InputIterator。那么bool operator () (int const& v)由于参数是int将无法通过。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
template <typename T, typename U>
concept UnaryPredicateConcept = requires(T t, U u)
{
    { t(*u) } -> std::same_as<bool>;
};

template <class InputIterator, class UnaryPredicate>
    requires(UnaryPredicateConcept
        <UnaryPredicate, InputIterator>)
InputIterator find_if(InputIterator first, InputIterator last, UnaryPredicate pred)
{
    while (first != last)
    {
        if (pred(*first))
            return first;
        else
            ++first;
    }
    return last;
}

class IsOdd
{
public:
    bool operator () (int const& v)
    {
        return v % 2 != 0;
    }
};

int main()
{
    std::vector<int> vec{ 0, 1, 2, 3, 4, 5, 6, 7, 8 };
    IsOdd is_odd_functor;
    // 此find_if目前受UnaryPredicateConcept的制约。
    auto it = ::find_if(vec.begin(), vec.end(), is_odd_functor);
    while (it != vec.end())
    {
        std::cout << *it << std::endl;
        it = ::find_if(it + 1, vec.end(), is_odd_functor);
    }
}

此find_if目前受UnaryPredicateConcept的制约。
现在，find_if的参数3必须是：“包含t(*u)且返回bool的函数”的类型。

升级模板库

把一个算法升级为通用算法，放到库中支持所有类型。
首先升级为模板函数。再用concept对模板类型做限制，从而在编译期就可以做相关检查。