Aprender

Cómo corregir "a function-definition is not allowed here before '{' token"

Principiante

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
Arduino Uno: una perilla en A0, lista para romperseen vivo0.000 s 0.00x
Haz clic para abrirlo en el editor
Gira la perilla y la lectura cambia. Ábrelo, borra el } al final de setup() y presiona Ejecutar para ver el error.

Este error significa que una función empieza dentro de otra función, lo cual C++ no permite. Cuando el compilador encuentra void loop() { mientras todavía cree estar dentro de setup(), se detiene ahí. La causa casi siempre es un } que falta en alguna línea más arriba: el cierre de la función anterior, o el de un if, for o else dentro de ella. Busca la llave de apertura que no tiene pareja, agrega su }, y tanto este error como el "expected '}'" que lo acompaña desaparecen.

Mokxi compila con clang, que lo redacta function definition is not allowed here. El circuito de arriba es un potenciómetro en A0 de un Uno, que imprime "A0 = 512 (2502 mV)" cinco veces por segundo con la perilla a la mitad. Ábrelo, borra el } al final de setup() y presiona Ejecutar: el error cae en la línea del void loop(), y la pestaña Compilación dice: "Una función empieza dentro de otra. Normalmente falta un } al final de la función de arriba."

El error está en la siguiente función, el error está más arriba

Aquí hay un sketch corto al que le falta la llave de cierre de setup(). Clang dio dos errores: function definition is not allowed here en la línea 7, columna 13, el { de void loop(), y expected '}' al final del archivo, con una nota, to match this '{', en la línea 3, donde abre setup(). GCC da el mismo par: a function-definition is not allowed here before '{' token y expected '}' at end of input.

Lee la nota, no el primer error. La nota señala la llave que nunca se cerró, y el } que falta va al final de ese bloque. La pestaña de compilación de Mokxi dice "The { on line 3 is never closed". Coloca el } después de la última línea de setup(), que es donde corresponde. Si agregaras una llave al final del archivo, loop() quedaría dentro de setup(), y el primer error seguiría apareciendo.

Roto: setup() nunca se cierra
const int SENSOR_PIN = A0;

void setup() {
  Serial.begin(9600);
  Serial.println("reading A0");

void loop() {
  int raw = analogRead(SENSOR_PIN);
  Serial.println(raw);
  delay(200);
}

Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.

Una llave que falta dentro de la función de arriba

La llave que falta muchas veces no es la de la propia función. En un loop() cuyo else { digitalWrite(13, LOW); nunca se cerró, el } destinado a loop() cerró el else en su lugar, así que loop() quedó abierto. El error cayó en la línea 15, en la siguiente función, void blinkTwice(), y la nota señaló la línea 6, el { de loop(), aunque la llave que de verdad faltaba era la del else de la línea 10.

Así que cuando la nota te diga qué función quedó abierta, busca dentro de ella el bloque interno que nunca se cerró. El código indentado lo hace fácil de ver: cada } debe quedar justo debajo de la línea donde empieza su bloque. Auto Format hace la indentación por ti, con Ctrl+T (Cmd+T en Mac) en el Arduino IDE y en el editor de código de Mokxi, y una llave que falta se nota porque las últimas líneas de una función quedan empujadas un paso hacia la derecha.

Una llave dentro de un comentario

Un } en un comentario no es código, así que no cierra nada. Eso sorprende a quienes comentan unas líneas para probar algo y se llevan la llave de cierre con ellas. En un sketch cuyo if (digitalRead(2) == HIGH) { en setup() terminaba en // }, la compilación se detuvo con el mismo par: function definition is not allowed here en la línea 8, el { de void loop(), y expected '}', con la nota en la línea 1, donde abre setup(). La nota menciona setup() y no el if, porque el } destinado a setup() cerró el if en su lugar.

Así que cuando el error aparece justo después de comentar algo, revisa primero las líneas que comentaste. Quita el // a la llave, o comenta también la línea del if, y las llaves vuelven a emparejarse.

Una función escrita dentro de loop() a propósito

Algunos lenguajes te dejan escribir una función dentro de otra. C++ no. Un void flash() { ... } escrito dentro de loop() detuvo la compilación con function definition is not allowed here en su línea, y luego use of undeclared identifier 'flash' donde loop() la llamaba, porque la función nunca se creó.

Escribe la función afuera, debajo de loop() o arriba de setup(), y llámala desde adentro. El IDE de Arduino y Mokxi escriben la declaración que permite que loop() llame a una función escrita más abajo, así que el orden no importa.

Si un pequeño ayudante de verdad pertenece junto a su único uso, C++ tiene una forma de escribirlo ahí: una lambda. auto flash = []() { digitalWrite(13, HIGH); delay(100); digitalWrite(13, LOW); }; dentro de loop(), luego flash();, compiló sin queja alguna. Una lambda es una variable que guarda una función, así que termina con punto y coma, y solo se puede llamar dentro de la función que la crea.

flash() escrita fuera de loop(), y llamada desde adentro
void setup() {
  pinMode(13, OUTPUT);
}

void loop() {
  flash();
  delay(900);
}

void flash() {
  digitalWrite(13, HIGH);
  delay(100);
  digitalWrite(13, LOW);
}

Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.

Abre este circuito en el editor. Arduino Uno: una perilla en A0, lista para romperse, conectada como se ejecuta al principio de esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Abrir el circuito

Preguntas

¿Qué significa "a function-definition is not allowed here before '{' token"?

Una función empieza dentro de otra. Casi siempre falta una } arriba: al final de la función anterior, o al final de un if, for o else dentro de ella. Agrega la llave que falta.

¿Por qué el error aparece en void loop() si loop() está bien?

El compilador solo nota la llave que falta cuando empieza la siguiente función. El error está arriba de esa línea, en setup() o en la función que venga primero.

¿Puedo poner una función dentro de loop()?

No. Escríbela fuera de toda función y llámala desde loop(). El IDE de Arduino y Mokxi te dejan llamar a una función que está escrita más abajo en el sketch.

¿"function definition is not allowed here" es el mismo error?

Sí. Es el texto de clang; GCC, que usa el IDE de Arduino, dice "a function-definition is not allowed here before '{' token". Mokxi compila con clang, así que su pestaña de compilación muestra las palabras de clang.

¿Es un error de Arduino o de C++?

De C++. Todo compilador de C++ rechaza una función escrita dentro de otra, así que la solución es la misma en cualquier programa de C++. GCC lo expresa como a function-definition is not allowed here before '{' token, y clang como function definition is not allowed here.

¿Hay alguna forma de escribir una función dentro de loop()?

Una forma sí se permite dentro de una función: una lambda. `auto twice = [](int x) { return x * 2; };` dentro de setup() compiló, y `twice(21)` imprimió 42. Para algo más largo, escribe una función normal fuera de toda función y llámala.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.