Plantilla:dcl end

Esta es una de las familias de plantillas utilizadas para la creación de listas de declaraciones.

{{dcl begin}}

Inicia la lista de declaraciones.

{{dcl end}}

Finaliza la lista de declaraciones. Esta plantilla agrega automáticamente {{dcl sep}} encima del elemento.

{{dcl rev begin|num=num (opcional)}}

Inicia la lista de declaraciones versionadas.

• num (opcional) puede usarse para fines de numeración (anula el parámetro num de las plantillas {{dcl}} utilizadas dentro de la lista versionada (es decir, hasta {{dcl rev end}}).

{{dcl rev end}}

Finaliza la lista de declaraciones versionadas.

{{dcl header|header }}

Agrega una explicación de qué encabezado proviene la característica.

{{dcl sep}}

Agrega un separador.

{{dcl h|heading }}

Agrega un encabezado pequeño. Útil para dividir y describir grandes grupos de declaraciones relacionadas.

{{dcl|declaration |notes=notes (opcional)|num=num (opcional)|since=since-std (opcional)|until=until-std (opcional)|deprecated=deprecated-std (opcional)|removed=removed-std (opcional)}}

Agrega un elemento a la lista de declaraciones. Esta plantilla agrega automáticamente {{dcl sep}} sobre el elemento.

• declaration es la declaración de la característica.
• notes (opcional) se puede usar para agregar notas sobre la característica.
• num (opcional) se puede usar para fines de numeración.
• since (opcional) especifica el primer estándar en el que aparece la definición
• until (opcional) especifica el primer estándar que no incluye esta definición
• deprecated (opcional) especifica el primer estándar que hizo obsoleta esta definición o es igual a yes, en cuyo caso especifica que la definición siempre ha estado obsoleta.
• removed (opcional) se puede usar de una de dos maneras:
  • Cuando se especifica since, especifica si el marcador "hasta" se debe representar como "eliminado en" en su lugar, y puede ser yes o no.
  • Si falta, el valor predeterminado es yes si se especifica deprecated y no en caso contrario.
  • Cuando no se especifica until, removed=x es equivalente a hasta=x|removed=yes.

{{dcla|parameters of  |anchor=name-or-no (opcional)|noexcept=noexcept-std (opcional)|constexpr=constexpr-std (opcional)|expos=yes (opcional)}}

Igual que {{dcl}}, con un conjunto de parámetros extendido y con una capacidad adicional para generar un ancla HTML interna.

• anchor (opcional)
  • Cuando se especifica y su valor es no - no hace nada. De lo contrario, inserta en la fila actual el ancla con el nombre proporcionado.
  • Cuando no se especifica, el ancla se inserta solo si se especifica el parámetro num. En tal caso, el nombre del ancla sigue el patrón: "Versión num" donde num es igual al valor de num, p. ej., si num=1 entonces el nombre del ancla es "Versión 1". La dependencia del parámetro num simplifica la conexión ancla/enlace cuando se usa junto con p. ej. {{vl}} o {{eq impl}} que también esperan el patrón de nombre del enlace "Versión n".
• noexcept (opcional)
  • Cuando se especifica, utiliza su valor, p. ej. c++11, para agregar la etiqueta de revisión "noexcept" (es decir, (noexcept desde C++11) en este caso), al área de control de versiones.
• constexpr (opcional)
  • Cuando se especifica, utiliza su valor, p. ej. c++20, para agregar la etiqueta de revisión "constexpr" (es decir, (constexpr desde C++20) en este caso), al área de control de versiones.
• expos (opcional)
  • Cuando se especifica con el valor yes, agrega la nota (solo de exposición*) al área de control de versiones.

{{ddcl|header=header (opcional)|parámetros de  }}

Una abreviatura conveniente para la combinación: {{dcl header}} + {{dcl begin}} + {{dcl ...}} + {{dcl end}} cuando solo es necesario describir una declaración.

{{ddcla|header=header (opcional)|parámetros de  }}

Una abreviatura conveniente para la combinación: {{dcl header}} + {{dcl begin}} + {{dcla ...}} + {{dcl end}} cuando solo es necesario describir una declaración.

{{dcl rev multi|num=num (opcional)|anchor=num (opcional)|notes=notes (opcional)|since1=since-std1 |until1=until-std1 |dcl1=declaration1 |... }}

Lista de declaraciones versionadas de una sola plantilla; se admiten hasta 7 versiones. El valor predeterminado para sinceX es untilX-1 y el valor predeterminado para untilX es sinceX+1.

Cuando se especifica anchor, {{dcl rev multi}} genera un ancla HTML interna con el nombre "Version anchor ", p. ej., dado anchor=X3, el nombre del ancla sería "Version X3". Por lo general, el valor de anchor es el mismo que el valor de num. El ancla generada es útil para vincularla desde, p. ej., la sección Posible implementación.

Ejemplo

 
    {{dcl header | abcd.h}}
    {{dcl | notes=Faster than {{c|foo_slow}} | num=1 |
    int foo( char a );
    }}
    {{dcl | since=c++11 | num=2 |
    int foo( char a, int b );
    }}
    {{dcl rev begin | num=3}}
    {{dcl | until=c++11 | 1=
    int foo( char a, char b = 'a' );
    }}
    {{dcl | since=c++11 | until=c++14 | 1=
    int foo( char a, char b = 'b' );
    }}
    {{dcl | since=c++14 | 1=
    int foo( char a, char b = 'c' );
    }}
    {{dcl rev end}}
    {{dcl rev begin}}
    {{dcl | until=c++11 | num=4 | 1=
    int foo( char a, char b = 'a' );
    }}
    {{dcl | since=c++11 | until=c++14 | num=5 | 1=
    int foo( char a, char b = 'b' );
    }}
    {{dcl | since=c++14 | num=6 | 1=
    int foo( char a, char b = 'c' );
    }}
    {{dcl rev end}}
    {{dcl rev multi | num=7 | dcl1=
    int foo( char a, char b = 'a' );
    |since2=c++11 | dcl2=
    int foo( char a, char b = 'b' );
    |since3=c++14 | dcl3=
    int foo( char a, char b = 'c' );
    |since4=c++17 | dcl4=
    int foo( char a, char b = 'd' );
    }}
  

Lo anterior da como resultado lo siguiente:

<tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

Definido en el archivo de encabezado <abcd.h>
int foo( char a );	(1)	Faster than foo_slow
int foo( char a, int b );	(2)	(desde C++11)
	(3)
int foo( char a, char b = 'a' );			(hasta C++11)
int foo( char a, char b = 'b' );			(desde C++11) (hasta C++14)
int foo( char a, char b = 'c' );			(desde C++14)
int foo( char a, char b = 'a' );		(4)	(hasta C++11)
int foo( char a, char b = 'b' );		(5)	(desde C++11) (hasta C++14)
int foo( char a, char b = 'c' );		(6)	(desde C++14)
		(7)
int foo( char a, char b = 'a' );				(hasta C++11)
int foo( char a, char b = 'b' );				(desde C++11) (hasta C++14)
int foo( char a, char b = 'c' );				(desde C++14) (hasta C++17)
int foo( char a, char b = 'd' );				(desde C++17)

Ejemplo

 
   {{ddcl | header=mutex | since=c++11 | 1=
   template< class Lockable1, class Lockable2, class... LockableN >
   void lock( Lockable1& lock1, Lockable2& lock2, LockableN&... lockn );
   }}
  

Lo anterior da como resultado lo siguiente:

<tbody> </tbody>

Definido en el archivo de encabezado <mutex>
template< class Lockable1, class Lockable2, class... LockableN > void lock( Lockable1& lock1, Lockable2& lock2, LockableN&... lockn );		(desde C++11)