Permitir tipos que admiten valores Null

1. Abra la ventana de descripción del proyecto: en la pestaña "Proyecto", en el grupo "Proyecto", haga clic en "Descripción".
2. En la pestaña "Compilación", seleccione la opción "Permitir tipos que admiten valores NULL".
3. Un mensaje con las implicaciones de activar esta opción se abre. Haga clic en "Activar".
4. Valide la ventana de descripción del proyecto.

Funcionalidades asociadas a la activación de tipos que admiten valores Null

• Almacenar valores Null en una variable: definir un tipo que admite valores Null.
• Determinar si un elemento es Null.
• Obtener el valor de un elemento que permite valores Null.
• Utilizar valores Null en funciones WLanguage.
• Utilizar valores Null en los procedimientos.
• Operaciones disponibles en variables que permiten valores Null.
• Gestionar valores Null en campos HFSQL.

Presentación

Tipos simples que admiten valores Null

• agregue un signo de interrogación ("?") después del nombre del tipo.
  
  <Variable name> is <Type>?
  Por ejemplo:
  

  n is int?
  s is UNICODE string?
  n1 is 8-byte int?

• utilice el atributo de extensión <nullable>.
  
  <Variable name> is <Type> <nullable>
  Por ejemplo:
  

  n is int <nullable>

• Estas sintaxis solo están disponibles si la opción "Permitir tipos que admiten valores NULL" está activada.
• El valor predeterminado de un tipo que admite Null es NULL (y no el valor inicial del tipo).
• La inferencia de tipos está disponible para los tipos que admiten valores Null. Por ejemplo:
  
  LET x = ProcedureReturnNullableInteger()

• los tipos simples que no admiten valores Null pueden compararse con la constante Null: el resultado siempre es False.
• los tipos simples que admiten valores Null pueden compararse con la constante Null: el resultado es True si el valor es Null, de lo contrario, el resultado es False.
• los tipos complejos (object, array, etc.) que admitían valores Null en versiones anteriores no cambian de comportamiento: siempre pueden compararse con valores Null.

• Campo HFSQL: Si un archivo de datos y un campo admiten valores Null, es posible determinar si un campo HFSQL contiene un valor Null comparándolo directamente con la constante Null. Ejemplo:
  

  IF Queue.ItemWithNullValue = Null THEN
  	// Process ...
  END

• Control Campo de entrada: Si se selecciona la opción "Devolver NULL si está vacío" para el control, es posible determinar si un control Campo de entrada devolvió Null.

Operador?!

IF Queue.ItemWithNull <> Null THEN
	s is string = Queue.ItemWithNull?!
END

• en elementos que no pueden determinarse en tiempo de compilación: resultados de consultas, indirecciones, etc.
• en determinadas sintaxis condicionales. Por ejemplo:
  

  IF Queue.ItemWithNull <> Null THEN
  	s is string = Queue.ItemWithNull	//?! operator automatically added
  END

Operador??

• el valor de un elemento que admite valores Null si este valor no es Null,
• un valor de sustitución, si el valor del elemento es Null.

// The string will contain "N/A" if the item is Null
s is string = Queue.ItemWithNull?? "N/A"

Operador??*

• el valor de un elemento que admite valores Null si este valor no es Null.
• el valor predeterminado del tipo, si el valor del elemento es Null.

// The string will be empty if the item is Null
s is string = Queue.ItemWithNull??*

Operador ??=

nullable_value is string?
nullable_value = ProcedureToBeExecuted()
nullable_value??= "N/A"

nullable_value is string?
nullable_value = ProcedureToBeExecuted()
IF nullable_value = Null THEN
	nullable_value = "N/A"
END

Operador ??=*

nullable_value is string?
	nullable_value = ProcedureToBeExecuted()
	nullable_value??=*

nullable_value is string?
nullable_value = ProcedureToBeExecuted()
IF nullable_Value = Null THEN
	nullable_value??*
END

• si el valor es Null, se muestra la cadena "<Null>".
• si el tipo es nullable pero no contiene un valor Nulo, se muestra la cadena "" junto al valor.

Caso especial: Serializar/Deserializar

• En una deserialización binaria, los miembros que admiten valores Null se establecen en Null si no existen en el búfer serializado.
• En una serialización XML, los miembros que admiten valores Null y que contienen el valor Null no se serializan. Durante la deserialización, los miembros se establecen en Null si no existen en el contenido XML.
• En una serialización JSON, los miembros que admiten valores Null y que contienen el valor Null no se serializan. Durante la deserialización, los miembros se establecen en Null si no existen en el contenido JSON.

Caso especial: Sintaxis con prefijo

• Si nullable_element no es Null, se llama a la función.
• Si el valor de nullable_element es Null, no se llama a la función y el resultado es Null.

full_string_or_Null is string? = ...
first_ten_characters_or_Null is string? = full_string_or_Null?. Left s(10)

first_ten_characters is string = full_string_or_Null?. Left s(10)?? ""

Pasar parámetros por valor

Valor de retorno

Operaciones aritméticas

Operaciones de comparación

• True si ambos valores son Null;
• False si un valor es Null y el otro no.

• True si un valor es Null y el otro no;
• False si ambos valores son Null.

Operaciones booleanas

• NOT
  • NOT Null = Null
  • NOT False = True
  • NOT True = False
• OR
  

  	Null	False	True
  Null	Null	Null	True
  False	Null	False	True
  True	True	True	True

• AND
  

  	Null	False	True
  Null	Null	False	Null
  False	False	False	False
  True	Null	False	True

Condiciones