我们应该使用_In_而不是__in吗?

时间:2010-11-04 01:01:41

标签: windows visual-studio-2010 visual-c++ annotations

我今天读到了VS2010中的sal.h 我有点意外。

// This section contains the deprecated annotations
|------------|------------|---------|--------|----------|----------|---------------|
|   Level    |   Usage    |  Size   | Output | NullTerm | Optional |  Parameters   |
|------------|------------|---------|--------|----------|----------|---------------|
| <>         | <>         | <>      | <>     | _z       | <>       | <>            |
| _deref     | _in        | _ecount | _full  | _nz      | _opt     | (size)        |
| _deref_opt | _out       | _bcount | _part  |          |          | (size,length) |
|            | _inout     |         |        |          |          |               |
|            |            |         |        |          |          |               |
|------------|------------|---------|--------|----------|----------|---------------|

我总是使用这些注释 我不敢相信他们被弃用了。这是真的吗? 如果是这样,为什么? 从现在开始我们应该使用以下注释吗? - 我不熟悉:(

|--------------|----------|----------------|-----------------------------|
|   Usage      | Nullness | ZeroTerminated |  Extent                     |
|--------------|----------|----------------|-----------------------------|
| _In_         | <>       | <>             | <>                          |
| _Out_        | opt_     | z_             | [byte]cap_[c_|x_]( size )   |
| _Inout_      |          |                | [byte]count_[c_|x_]( size ) |
| _Deref_out_  |          |                | ptrdiff_cap_( ptr )         |
|--------------|          |                | ptrdiff_count_( ptr )       |
| _Ret_        |          |                |                             |
| _Deref_ret_  |          |                |                             |
|--------------|          |                |                             |
| _Pre_        |          |                |                             |
| _Post_       |          |                |                             |
| _Deref_pre_  |          |                |                             |
| _Deref_post_ |          |                |                             |
|--------------|----------|----------------|-----------------------------|

顺便说一下,SO标签中不存在SAL标签 如果可以,请制作它。

1 个答案:

答案 0 :(得分:7)

您似乎应该习惯新的“属性”SAL格式,请参阅本文中间的红色注释:

http://blogs.msdn.com/b/michael_howard/archive/2006/05/19/602077.aspx

相关问题