String literal

Sintaxis

Explicación

En los tipos listados en la tabla anterior, N es el número de unidades de código codificadas, el cual se determina a continuación .

Los literales de cadena ordinarios y UTF-8 (desde C++11) se denominan colectivamente literales de cadena estrecha.

La evaluación de un string literal resulta en un objeto de string literal con duración de almacenamiento estática . Si todos los string literals se almacenan en objetos no superpuestos y si evaluaciones sucesivas de un string literal producen el mismo objeto o uno diferente no está especificado.

El efecto de intentar modificar un objeto de cadena literal es indefinido.

bool b = "bar" == 3 + "foobar"; // puede ser verdadero o falso, no especificado
const char* pc = "Hello";
char* p = const_cast<char*>(pc);
p[0] = 'M'; // comportamiento indefinido

// OK: contiene una barra invertida,
// equivalente a "\\"
R"(\)";
// OK: contiene cuatro pares \n,
// equivalente a "\\n\\n\\n\\n"
R"(\n\n\n\n)";
// OK: contiene un paréntesis de cierre, dos comillas dobles y un paréntesis de apertura,
// equivalente a ")\"\"("
R"-()""()-";
// OK: equivalente a "\n)\\\na\"\"\n"
R"a(
)\
a""
)a";
// OK: equivalente a "x = \"\"\\y\"\""
R"(x = ""\y"")";
// R"<<(-_-)>>"; // Error: los delimitadores inicial y final no coinciden
// R"-()-"-()-"; // Error: )-" aparece en el medio y termina el literal

Inicialización

Los objetos de cadena literal se inicializan con la secuencia de valores de unidad de código correspondientes a la secuencia de s-char s y r-char s (desde C++11) , más un carácter nulo terminador (U+0000), en orden como sigue:

Concatenación

Los literales de cadena adyacentes se concatenan en la fase de traducción 6 (después del preprocesamiento):

• Si los dos literales de cadena son del mismo tipo , el literal de cadena concatenado también es de ese tipo.

"Hello, " "world!" // en la fase 6, los 2 literales de cadena forman "Hello, world!"
L"Δx = %" PRId16   // en la fase 4, PRId16 se expande a "d"
                   // en la fase 6, L"Δx = %" y "d" forman L"Δx = %d"

1. ↑ Ninguna implementación conocida admite dicha concatenación.

Cadenas no evaluadas

Los siguientes contextos esperan un literal de cadena, pero no lo evalúan:

• language linkage especificación

Notas

Los literales de cadena pueden utilizarse para inicializar arrays de caracteres . Si un array se inicializa como char str [ ] = "foo" ; , str contendrá una copia de la cadena "foo" .

Un literal de cadena no es necesariamente una secuencia de caracteres terminada en nulo: si un literal de cadena tiene caracteres nulos incrustados, representa un array que contiene más de una cadena.

const char* p = "abc\0def"; // std::strlen(p) == 3, pero el array tiene tamaño 8

Si un dígito hexadecimal válido sigue a una secuencia de escape hexadecimal en un literal de cadena, fallaría al compilar como una secuencia de escape inválida. La concatenación de cadenas puede usarse como solución alternativa:

//const char* p = "\xfff"; // error: secuencia de escape hexadecimal fuera de rango
const char* p = "\xff""f"; // OK: el literal es const char[3] que contiene {'\xff','f','\0'}

Ejemplo

#include <iostream>
// array1 y array2 contienen los mismos valores:
char array1[] = "Foo" "bar";
char array2[] = {'F', 'o', 'o', 'b', 'a', 'r', '\0'};
const char* s1 = R"foo(
Hello
  World
)foo";
// igual que
const char* s2 = "\nHello\n  World\n";
// igual que
const char* s3 = "\n"
                 "Hello\n"
                 "  World\n";
const wchar_t* s4 = L"ABC" L"DEF"; // OK, igual que
const wchar_t* s5 = L"ABCDEF";
const char32_t* s6 = U"GHI" "JKL"; // OK, igual que
const char32_t* s7 = U"GHIJKL";
const char16_t* s9 = "MN" u"OP" "QR"; // OK, igual que
const char16_t* sA = u"MNOPQR";
// const auto* sB = u"Mixed" U"Types";
        // antes de C++23 puede o no ser compatible con
        // la implementación; mal formado desde C++23
const wchar_t* sC = LR"--(STUV)--"; // OK, literal de cadena cruda
int main()
{
    std::cout << array1 << ' ' << array2 << '\n'
              << s1 << s2 << s3 << std::endl;
    std::wcout << s4 << ' ' << s5 << ' ' << sC
               << std::endl;
}

Foobar Foobar
Hello
  World
Hello
  World
Hello
  World
ABCDEF ABCDEF STUV

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

1. ↑ P1854R4 fue aceptado como un DR posteriormente, anulando esta resolución.

Referencias

Véase también