2010-11-04 1 views
6

Ich lese heute sal.h, die in VS2010 ist.
Ich war ein wenig überrascht.Sollten wir _In_ anstelle von __in verwenden?

// 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  |   |  |   |   |    | 
|   |   |   |  |   |   |    | 
|------------|------------|---------|--------|----------|----------|---------------| 

Ich habe immer diese Anmerkungen verwendet.
Ich kann nicht glauben, dass sie veraltet sind. Ist es wahr?
Wenn ja, warum?
Sollten wir von nun an folgende Anmerkungen verwenden? -Es ist nicht vertraut mir :(

|--------------|----------|----------------|-----------------------------| 
| 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_ |   |    |        | 
|--------------|----------|----------------|-----------------------------| 

By the way, SAL-Tag existiert nicht in SO.
Bitte machen, wenn man könnte.

+0

Eh das sieht aus wie SQL ... welche Sprache beziehen sich auf Windows, Visual Studio, und? Microsoft sind keine Sprachen, ich würde MS SQL erraten, bu t '.h' steht für C oder C++. – mpen

+2

SAL ist keine Sprache. Es ist eine Anmerkung für c/C++. – Benjamin

+4

Mark: SAL ist die Quellcode Annotation Language (http://msdn.microsoft.com/en-us/library/ms235402(VS.100).aspx) die verwendet wird, um Parameter in C/C++ - Funktionen zu kommentieren, so dass der Compiler und andere Tools können bessere Warnungen geben. – Gabe

Antwort