En esta página

Funciones de sustitución

qmake proporciona funciones para procesar el contenido de las variables durante el proceso de configuración. Estas funciones se denominan «funciones de sustitución». Normalmente, devuelven valores que se pueden asignar a otras variables. Estos valores se pueden obtener anteponiendo a la función el operador « $$ ». Las funciones de sustitución se pueden dividir en funciones integradas y bibliotecas de funciones.

Véase también Funciones de prueba.

Funciones de sustitución integradas

Las funciones de sustitución básicas se implementan como funciones integradas.

absolute_path(path[, base])

Devuelve la ruta absoluta de path.

Si no se especifica base, utiliza el directorio actual como directorio base. Si se trata de una ruta relativa, se resuelve en relación con el directorio actual antes de su uso.

Por ejemplo, la siguiente llamada devuelve la cadena "/home/johndoe/myproject/readme.txt":

message($$absolute_path("readme.txt", "/home/johndoe/myproject"))

Esta función se introdujo en Qt 5.0.

Véase también clean_path(), relative_path().

basename(nombre_variable)

Devuelve el nombre base del archivo especificado en variablename.

Por ejemplo:

FILE = /etc/passwd
FILENAME = $$basename(FILE) #passwd

cat(nombre_archivo[, modo])

Devuelve el contenido de filename. Se pueden especificar las siguientes opciones para mode:

  • blob devuelve todo el contenido del archivo como un único valor
  • lines devuelve cada línea como un valor independiente (sin caracteres de fin de línea)
  • true (valor por defecto) y ` false ` devuelven el contenido del archivo como valores separados, divididos según las reglas de división de listas de valores de qmake (como en las asignaciones de variables). Si ` mode ` es ` false`, se insertan en la lista los valores que contienen únicamente un carácter de nueva línea para indicar dónde se encontraban los saltos de línea en el archivo.

clean_path(path)

Devuelve path con los separadores de directorios normalizados (convertidos a «/») y los redundantes eliminados, y los «.» y «..» resueltos (en la medida de lo posible). Esta función es una envoltura de QDir::cleanPath.

Esta función se introdujo en Qt 5.0.

Véase también absolute_path(), relative_path(), shell_path(), system_path().

dirname(file)

Devuelve la parte del nombre del directorio del archivo especificado. Por ejemplo:

FILE = /etc/X11R6/XF86Config
DIRNAME = $$dirname(FILE) #/etc/X11R6

enumerate_vars

Devuelve una lista con todos los nombres de variables definidas.

Esta función se introdujo en Qt 5.0.

escape_expand(arg1 [, arg2 ..., argn])

Acepta un número arbitrario de argumentos. Expande las secuencias de escape \n, \r y \t para cada argumento y devuelve los argumentos como una lista.

Nota: Si se especifica la cadena que se va a expandir literalmente, es necesario escapar las barras invertidas, tal y como se ilustra en el siguiente fragmento de código:

message("First line$$escape_expand(\\n)Second line")

find(nombre_variable, substr)

Devuelve todos los valores de variablename que coincidan con la expresión regular substr.

MY_VAR = one two three four
MY_VAR2 = $$join(MY_VAR, " -L", -L) -Lfive
MY_VAR3 = $$member(MY_VAR, 2) $$find(MY_VAR, t.*)

MY_VAR2 contendrá «-Lone -Ltwo -Lthree -Lfour -Lfive», y MY_VAR3 contendrá «three two three».

files(patrón[, recursivo=false])

Expande el patrón comodín especificado y devuelve una lista de nombres de archivo. Si recursive es verdadero, esta función recorre los subdirectorios.

first(nombre_de_variable)

Devuelve el primer valor de variablename.

Por ejemplo, la siguiente llamada devuelve firstname:

CONTACT = firstname middlename surname phone
message($$first(CONTACT))

Véase también take_first(), last().

format_number(número[, opciones...])

Devuelve number en el formato especificado por options. Se pueden especificar las siguientes opciones:

  • ibase=n establece la base de la entrada en n
  • obase=n establece la base de la salida en n
  • width=n establece la anchura mínima de la salida en ` n`. Si la salida es más corta que ` width`, se rellena con espacios
  • zeropad rellena la salida con ceros en lugar de espacios
  • padsign añade un espacio al principio de los valores positivos de la salida
  • alwayssign añade un signo más delante de los valores positivos de la salida
  • leftalign coloca el relleno a la derecha del valor en la salida

Actualmente no se admiten números de coma flotante.

Por ejemplo, la siguiente llamada convierte el número hexadecimal BAD en 002989:

message($$format_number(BAD, ibase=16 width=6 zeropad))

Esta función se introdujo en Qt 5.0.

fromfile(nombre_archivo, nombre_variable)

Evalúa filename como un archivo de proyecto de qmake y devuelve el valor asignado a variablename.

Véase también infile().

getenv(nombre_variable)

Devuelve el valor de la variable de entorno variablename. Esto es prácticamente equivalente a la sintaxis $$(variablename). Sin embargo, la función getenv admite variables de entorno con paréntesis en su nombre.

Esta función se introdujo en Qt 5.12.

join(nombre_variable, separador, antes, después)

Une el valor de ` variablename ` con ` glue`. Si este valor no está vacío, la función antepone al valor ` before ` y le añade al final ` after`. ` variablename ` es el único campo obligatorio; los demás adoptan por defecto cadenas vacías. Si necesitas codificar espacios en ` glue`, ` before` o ` after`, debes ponerlos entre comillas.

last(nombre_de_variable)

Devuelve el último valor de variablename.

Por ejemplo, la siguiente llamada devuelve phone:

CONTACT = firstname middlename surname phone
message($$last(CONTACT))

Véase también take_last(), first().

list(arg1 [, arg2 ..., argn])

Acepta un número arbitrario de argumentos. Crea una variable con un nombre único que contiene una lista de los argumentos y devuelve el nombre de dicha variable. Puedes utilizar la variable para escribir un bucle, tal y como se ilustra en el siguiente fragmento de código

for(var, $$list(foo bar baz)) {
    ...
}

en lugar de:

values = foo bar baz
for(var, values) {
    ...
}

lower(arg1 [, arg2 ..., argn])

Acepta un número arbitrario de argumentos y los convierte a minúsculas.

Véase también upper().

member(nombre_variable [, inicio [, fin]])

Devuelve el fragmento del valor de lista de variablename con índices de elementos, contados a partir de cero, comprendidos entre start y end (ambos incluidos).

Si no se especifica ` start `, el valor por defecto es cero. Este uso es equivalente a ` $$first(variablename)`.

Si no se especifica end, el valor por defecto es start. Este uso representa una indexación simple de la matriz, ya que se devolverá exactamente un elemento.

También es posible especificar el inicio y el final en un único argumento, con los números separados por dos puntos.

Los números negativos representan índices que comienzan desde el final de la lista, siendo -1 el último elemento.

Si alguno de los índices está fuera de rango, se devuelve una lista vacía.

Si end es menor que start, los elementos se devuelven en orden inverso.

Nota: El hecho de que el índice final sea inclusivo y no esté ordenado implica que solo se devolverá una lista vacía cuando un índice sea inválido (lo cual se deduce de que la variable de entrada esté vacía).

Véase también str_member().

num_add(arg1 [, arg2 ..., argn])

Toma un número arbitrario de argumentos numéricos y los suma, devolviendo la suma.

La resta se admite de forma implícita, ya que basta con anteponer un signo menos a un valor numérico para negarlo:

sum = $$num_add($$first, -$$second)

Si el operando ya es negativo, es necesario un paso adicional para normalizar el número:

second_neg = -$$second
second_neg ~= s/^--//
sum = $$num_add($$first, $$second_neg)

Esta función se introdujo en Qt 5.8.

prompt(question [, decorate])

Muestra el mensaje de solicitud especificado question y devuelve un valor leído desde stdin.

Si decorate es verdadero (por defecto), la pregunta recibe un prefijo y un sufijo genéricos que la identifican como una solicitud de entrada.

quote(cadena)

Convierte una « string » completa en una única entidad y devuelve el resultado. Se trata simplemente de una forma elegante de encerrar la cadena entre comillas dobles.

re_escape(cadena)

Devuelve la « string » con todos los caracteres especiales de expresiones regulares escapados con una barra invertida. Esta función es una envoltura de QRegularExpression::escape.

read_registry(árbol, clave[, indicador])

Devuelve el valor de la clave de registro key dentro del árbol tree.

Solo se admiten los árboles HKEY_CURRENT_USER (HKCU) y HKEY_LOCAL_MACHINE (HKLM).

El flag puede ser WOW64_32KEY (32) o WOW64_64KEY (64).

Nota: Esta función solo está disponible en sistemas Windows.

Esta función se introdujo en Qt 5.12.1.

relative_path(filePath[, base])

Devuelve la ruta a filePath relativa a base.

Si no se especifica base, se toma como tal el directorio del proyecto actual. Si es relativa, se resuelve en relación con el directorio del proyecto actual antes de su uso.

Si filePath es relativa, se resuelve primero con respecto al directorio base; en ese caso, esta función actúa efectivamente como $$clean_path().

Esta función se introdujo en Qt 5.0.

Véase también absolute_path(), clean_path().

replace(string, old_string, new_string)

Sustituye cada instancia de ` old_string ` por ` new_string ` en el contenido de la variable proporcionada como ` string`. Por ejemplo, el código

MESSAGE = This is a tent.
message($$replace(MESSAGE, tent, test))

imprime el mensaje:

This is a test.

resolve_depends(nombre_de_variable, prefijo)

Se trata de una función interna que, por lo general, no necesitarás.

Esta función se introdujo en Qt 5.0.

reverse(nombre_de_variable)

Devuelve los valores de « variablename » en orden inverso.

Esta función se introdujo en Qt 5.0.

section(nombre_variable, separador, inicio, fin)

Devuelve una sección del valor de ` variablename`. Esta función es una envoltura de ` QString::section`.

Por ejemplo, la siguiente llamada muestra el resultado de ` surname`:

CONTACT = firstname:middlename:surname:phone
message($$section(CONTACT, :, 2, 2))

shadowed(path)

Asigna la ruta desde el directorio de fuentes del proyecto al directorio de compilación. Esta función devuelve ` path ` para compilaciones dentro del árbol de fuentes. Devuelve una cadena vacía si ` path ` apunta fuera del árbol de fuentes.

Esta función se introdujo en Qt 5.0.

shell_path(path)

Convierte todos los separadores de directorios dentro de « path » en separadores compatibles con el shell que se utiliza al compilar el proyecto (es decir, el shell que invoca la herramienta «make»). Por ejemplo, las barras se convierten en barras invertidas cuando se utiliza el shell de Windows.

Esta función se introdujo en Qt 5.0.

Véase también system_path().

shell_quote(arg)

Encerra entre comillas arg para el shell que se utiliza al compilar el proyecto.

Esta función se introdujo en Qt 5.0.

Véase también system_quote().

size(nombre_de_variable)

Devuelve el número de valores de ` variablename`.

Véase también str_size().

sort_depends(nombre_variable, prefijo)

Se trata de una función interna que, por lo general, no necesitarás.

Esta función se introdujo en Qt 5.0.

sorted(nombre_variable)

Devuelve la lista de valores de ` variablename `, con las entradas ordenadas en orden ASCII ascendente.

La ordenación numérica se puede realizar rellenando los valores con ceros hasta una longitud fija mediante la función format_number().

Esta función se introdujo en Qt 5.8.

split(nombre_variable, separador)

Divide el valor de ` variablename ` en valores separados y los devuelve como una lista. Esta función es una envoltura de ` QString::split`.

Por ejemplo:

CONTACT = firstname:middlename:surname:phone
message($$split(CONTACT, :))

sprintf(cadena, argumentos...)

Sustituye %1-%9 en string por los argumentos pasados en la lista separada por comas de la función arguments y devuelve la cadena procesada.

str_member(arg [, start [, end]])

Esta función es idéntica a member(), salvo que opera sobre un valor de cadena en lugar de una variable de lista y, por consiguiente, los índices se refieren a posiciones de caracteres.

Esta función se puede utilizar para implementar muchas operaciones comunes de segmentación de cadenas:

# $$left(VAR, len)
left = $$str_member(VAR, 0, $$num_add($$len, -1))

# $$right(VAR, len)
right = $$str_member(VAR, -$$num, -1)

# $$mid(VAR, off, len)
mid = $$str_member(VAR, $$off, $$num_add($$off, $$len, -1))

# $$mid(VAR, off)
mid = $$str_member(VAR, $$off, -1)

# $$reverse(VAR)
reverse = $$str_member(VAR, -1, 0)

Nota: En estas implementaciones, un argumento « len » con valor cero debe tratarse por separado.

Véase también member(), num_add().

Esta función se introdujo en Qt 5.8.

str_size(arg)

Devuelve el número de caracteres del argumento.

Véase también size().

Esta función se introdujo en Qt 5.8.

system(comando[, modo[, stsvar]])

Puedes utilizar esta variante de la función « system » para obtener la salida estándar (stdout) del comando y asignarla a una variable.

Por ejemplo:

UNAME = $$system(uname -s)
contains( UNAME, [lL]inux ):message( This looks like Linux ($$UNAME) to me )

Al igual que $$cat(), el argumento de mode admite como valor blob, lines, true y false. Sin embargo, las reglas heredadas de división de palabras (es decir, vacío o true y false) difieren ligeramente.

Si se pasa stsvar, el estado de salida del comando se almacenará en esa variable. Si el comando falla, el estado será -1; en caso contrario, será un código de salida no negativo elegido por el propio comando. Por lo general, basta con comparar el estado con cero (éxito).

Véase también la variante de prueba de system().

system_path(path)

Convierte todos los separadores de directorios de path a separadores compatibles con el shell que utilizan las funciones system() para ejecutar comandos. Por ejemplo, las barras se convierten en barras invertidas para el shell de Windows.

Esta función se introdujo en Qt 5.0.

Véase también shell_path().

system_quote(arg)

Encierra entre comillas « arg » para el shell que utilizan las funciones « system() ».

Esta función se introdujo en Qt 5.0.

Véase también shell_quote().

take_first(nombre_de_variable)

Devuelve el primer valor de ` variablename ` y lo elimina de la variable de origen.

Esto resulta muy útil, por ejemplo, a la hora de implementar colas.

Esta función se introdujo en Qt 5.8.

Véase también take_last(), first().

take_last(nombre_de_variable)

Devuelve el último valor de ` variablename ` y lo elimina de la variable de origen.

Esto facilita, por ejemplo, la implementación de pilas.

Esta función se introdujo en Qt 5.8.

Véase también take_first(), last().

unique(nombre_variable)

Devuelve la lista de valores de ` variablename ` tras eliminar las entradas duplicadas. Por ejemplo:

ARGS = 1 2 3 2 5 1
ARGS = $$unique(ARGS) #1 2 3 5

upper(arg1 [, arg2 ..., argn])

Toma un número arbitrario de argumentos y los convierte a mayúsculas.

Véase también lower().

val_escape(nombre_variable)

Escapa los valores de variablename de forma que puedan analizarse como código qmake.

Esta función se introdujo en Qt 5.0.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.