Ver el código de «Comandos/function»

{{Infobox comando
|name=function
|oplevel=
* 2 {{Solo|java|short=1}}
* 1 {{Solo|bedrock|short=1}}
|others=[[Opciones|Truco]] solamente{{Solo|bedrock|short=1}}
}}
Ejecuta comandos encontrados en el archivo de función correspondiente con el contexto de ejecución del comando (ejecutor, posición de ejecución, ángulos, etc.) del comando /function.

{{EN|java}}, ejecuta una [[Función (Java Edition)|función]] o todas las funciones en una [[Etiqueta (técnico)|etiqueta]] desde un [[paquete de datos]].<br>
{{EN|bedrock}}, Ejecuta una [[Función (Bedrock Edition)|función]] desde un [[paquete de comportamientos]].

== Sintaxis ==
* '''Java Edition'''
: <code>function <name> [<arguments>|with (block <sourcePos>|entity <source>|storage <source>) [<path>]]</code>

* '''Bedrock Edition'''
: <code>function <name: filepath></code>

== Argumentos ==
{{Argumento|name|function|name: filepath|CommandFilePath}}
: {{arg desc|je=function|be=commandfilepath}}
{{el|je|short=1}}: {{Argumento|arguments|nbt_compound_tag}}
: {{Arg desc|je=nbt_compound_tag}}
{{el|je|short=1}}: {{Argumento|sourcePos|block_pos}}
: {{arg desc|je=block_pos}}
{{el|je|short=1}}: {{Argumento|source|entity}} (EN <code>entity <target></code> mode)
: {{arg desc|je=entity}}
{{el|je|short=1}}: {{Argumento|source|resource_location}} (EN <code>storage <target></code> mode)
: {{arg desc|je=resource_location}}
{{el|je|short=1}}: {{Argumento|path|nbt_path}}
: {{arg desc|je=nbt_path}}

== Resultado ==
{{Tabla de resultados}}
{{Tabla de resultados|los argumentos no están especificados correctamente|unparseable|unparseable}}
{{Tabla de resultados|las funciones especificadas o etiquetas de función no existen|fail|fail}}
{{Tabla de resultados|éxito}}
{{Tabla de resultados}}

== Salida ==
{{Tabla de salida}}
{{Tabla de salida|edition=je|En caso de fallo|0|0|0}}
{{Tabla de salida|En caso de éxito cuando se ejecuta no mediante una función|el número de todos los comandos ejecutados en la(s) función(es) '''más''' 1 (este comando en sí)|1|el número de comandos ejecutados (ya sea con éxito o no) '' 'más''' el número de funciones integradas.}}
{{Tabla de salida|Sobre el éxito al ejecutarse en una función|N/A|1|0}}
{{Tabla de salida|edition=be|En caso de fallo|0}}
{{Tabla de salida|En éxito|1}}
{{Tabla de salida}}

{{EN|java}}:<ref>{{Error|MC-148612}}</ref><ref>{{Error|MC-135636}}</ref>
: El recuento de éxitos es la suma de los recuentos de éxito de todos los comandos ejecutados en la función/funciones más 1 (este comando en sí).
:Por ejemplo,
::<samp>'''foo:bar1'''</samp>
:::<code>function foo:bar2</code>
::<samp>'''foo:bar2'''</samp>
:::<code>function foo:bar3</code>
::<samp>'''foo:bar3'''</samp>
:::<code>say hi</code>
::El recuento de éxito de {{cmd|function foo:bar3|link=none}} es 1 (un comando en foo:bar3) + 1 (este comando en sí) = 2.
::El recuento de éxito de {{cmd|function foo:bar2|link=none}} es 2 (desde arriba) + 1 (este comando en sí) = 3.
::El recuento de éxito de {{cmd|function foo:bar1|link=none}} es 3 (desde arriba) + 1 (este comando en sí) = 4.
:El mensaje de salida que se muestra en el chat devuelve la cantidad de comandos ejecutados (no la cantidad de comandos que tuvieron éxito) más la cantidad de funciones integradas llamadas por una función.
::El recuento de salida del chat de {{cmd|function foo:bar3|link=none}} es 1 (un comando en foo:bar3).
::El recuento de salida del chat de {{cmd|function foo:bar2|link=none}} es 1 (un comando en foo:bar2) + 1 (un comando en foo:bar3) + 1 (una función integrada) = 3 .
::El recuento de salida del chat de {{cmd|function foo:bar1|link=none}} es 1 (un comando en foo:bar1) + 1 (un comando en foo:bar2) + 1 (un comando en foo:bar3 ) + 2 (dos funciones integradas) = 5.
:Si tiene éxito, {{cmd|execute store Success|link=none}} siempre devuelve 1. De lo contrario, devuelve 0.
:Si tiene éxito, el valor de retorno de {{cmd|ejecutar resultado de la tienda|link=none}} es el mismo que el recuento de salida del chat. De lo contrario, devuelve 0.

== Ejemplos==
* {{EN|java}}:
** Para ejecutar una función ubicada en <code>data/custom/functions/example/test.mcfunction</code> en un paquete de datos cargado: {{cmd|function custom:example/test|link=none}}
** Para ejecutar todas las funciones en una [[etiqueta]] de función ubicada en <code>data/custom/tags/functions/example/test.json</code>: {{cmd|function #custom:example/test |enlace=ninguno}}
** Para ejecutar una función si hay una oveja dentro de un radio de 2 cuadras: <code>/ejecutar si entidad @e[tipo=oveja,distancia=..2] ejecutar función personalizada:ejemplo/prueba</code>
** Para ejecutar una función a menos que el ejecutor sea un jugador: <code>/ejecutar a menos que la entidad @s[tipo=jugador] ejecute la función personalizada:ejemplo/prueba</code>
** Para ejecutar una macro de función con argumentos a=42, b="ejemplo": <code>/función personalizada:ejemplo/prueba {a: 42, b: "ejemplo"}</code>
** Para ejecutar una macro de función con argumentos del almacenamiento
 <code>custom:storage</code>: <code>/function custom:example/test with custom:storage</code>

== Historial ==
{{Historial|java}}
{{Historial||1.12|snap=pre1|Se agregó {{cmd|function|link=none}}.}}
{{Historial||1.13|snap=17w49b|{{cmd|function|link=none}} ahora acepte las [[Etiqueta (técnico)|etiquetas]] de función como argumento.|Se eliminaron los argumentos {{cd|[if/unless]}} a favor de {{cmd|execute [if/unless]}}.}}
{{Historial|Java Edition Próximamente}}
{{Historial||1.20.2|snap=23w31a|Se agregaron argumentos de función.}}
{{Historial|bedrock}}
{{Historial||1.8.0|snap=beta 1.8.0.8|Se agregó {{cmd|function|link=none}}.}}
{{Historial|foot}}

== Ver también ==
* {{cmd|tag}} – Para ejecutar la función por lotes, cada tic o en la (re)carga del servidor.

== Referencias ==
{{Lista de referencias}}

{{Comandos}}

[[de:Befehl/function]]
[[en:Commands/function]]
[[ja:コマンド/function]]
[[pt:Comandos/function]]
[[ru:Команды консоли/function]]
[[uk:Команди консолі/function]]
[[zh:命令/function]]