Declarar un literal de cadena de una sola línea

• encerrando la cadena entre comillas dobles.
• Novedad versión 2024
  encerrando la cadena entre caracteres de acento grave ( ` ), también conocidos como "tildes invertidas".

Ejemplos

// Single-line string literal with double quotation marks
MySingleLineString is string
MySingleLineString = "Example line of text"

// String with double double quotation marks
MySingleLineString2 is string
MySingleLineString 2 = "The ""General Terms and Conditions"" option must be checked"
// Displays: The "General conditions" option must be checked

Novedad versión 2024

// Single-line string literal with backticks ( ` )
MySingleLineString is string
MySingleLineString = `Example line of text`

Declarar un literal de cadena de varias líneas

• los signos [ y ].
• las comillas dobles.
• Novedad versión 2024
  los caracteres de acento grave ( ` ).
• el carácter "CR" (Carriage Return) entre las distintas líneas de la cadena multilínea.

Ejemplos

// Use square brackets to write a multiline string
MyString is string
MyString = [
	Example of 
	multiline string
	]

MyString is string
MyString = [
	Example of 
	multiline string
	]

// Use Carriage Return to write a multiline string
MyString is string
MyString = "This is a " + CR + "multiline string"

• Resaltado de sintaxis: de forma predeterminada, las cadenas de varias líneas se muestran en color morado (como cualquier otra cadena entre comillas dobles en WLanguage) y se resaltan en color malva.
  Puede utilizar el resaltado de sintaxis predeterminado de WLanguage (opción "Resaltado de sintaxis .. WLanguage" del menú contextual de la cadena de varias líneas). Esta opción permite verificar el código introducido cuando se utiliza una cadena de varias líneas para la compilación dinámica (función Compile).
• Posibilidad de contraer y expandir una cadena de varias líneas
  Contraer cadenas de varias líneas libera espacio en el editor de código. El código se vuelve más claro y legible. Cuando se contrae la cadena, el contenido se muestra en un tooltip.
• Ventaja adicional de la sintaxis 2
  Las comillas dobles hacen que las cadenas sean más fáciles de leer, independientemente de que sean de una o varias líneas.

Limitaciones

• El número máximo de líneas en una cadena es de 1000.
• No se pueden utilizar cadenas de varias líneas dentro de cadenas de varias líneas. El siguiente código genera un error WLanguage:
  
  sCode is string = [
  sMultilineString is string = [
  Test on the multiline strings
  Attempt on the multiline strings
  ]
  ]

• Método 1: Dividir el literal de cadena para incluir la variable.
  Ejemplos:
  

  sCode is string = "The " + sVar + " string is a string"

  
  

  s is string = [
  	the string
  	] + var + [
  	is multiline
  	]

  
  

  s is string = "
  	the string
  	" + var + "
  	is multiline
  	"

  
  Esta solución no se recomienda, sobre todo si la cadena debe traducirse.

• Método 2: Utilizar la función StringBuild. Los valores que pueden tomar parámetros deben sustituirse por %1, %2, %n, etc., en el literal de cadena.
  Ejemplos:
  

  sCode is string = "The %1 string is a string"
  sCode = StringBuild(sCode, MyVariable)

  
  

  sString is string = [
  	the %1 string
  	is multiline
  	]
  sString = StringBuild(sString, MyVariable)

  
  

  sString is string = "
  	the %1 string
  	is multiline
  	"
  sString = StringBuild(sString, MyVariable)

• Método 3: Utilizar la opción "Permitir '[% %]' en las cadenas".
  • En la ventana de descripción del proyecto, en la pestaña "Compilación", seleccione la opción Permitir "[% %]" en las cadenas.
  • Utilice la siguiente sintaxis para indicar la expresión a utilizar:
    
    [%VariableName or Expression%]
    Por ejemplo:
    

    // Ask for customer confirmation
    IF YesNo(Yes, "Do you confirm the creation of customer [%sCustomerName%]") = No THEN
    	RETURN
    END

  Observaciones:
  • Novedad versión 2024
    Si utiliza literales de cadena de varias líneas con caracteres de acento grave ( ` ), las expresiones que utilizan "[% %]" se interpretan automáticamente. No es necesario seleccionar la opción correspondiente en la pestaña "Compilación".
  • Si la opción no está seleccionada en la pestaña "Compilación" de la ventana de descripción del proyecto, la cadena aparece tal cual: el nombre de la variable (o expresión) aparece en la cadena.
  • Utilice "-%" antes de los caracteres "[% %]" para que no se interpreten. Algunas funciones WLanguage requieren esta sintaxis específica. Ejemplo:
    

    grTooltip(GR_Deadline, grTooltipFormat, "[%CATEGORY%]" + CR + CR+ "[%VALUE%]" + " H")

    cambia a

    grTooltip(GR_Deadline, grTooltipFormat, -%"[%CATEGORY%]" + CR + CR + -%"[%VALUE%]" + " H")

  • Al traducir este tipo de cadenas, el nombre de la variable (o expresión) dentro de [% %] no debe traducirse. Sin embargo, puede mover la etiqueta [%VariableName or Expression%] dentro de la cadena.