+/* Converts TEXT to a value.
+
+ VAL will be initialised and filled by this function.
+ It is the caller's responsibility to destroy VAL when no longer needed.
+ VAR must be the variable with which VAL is associated.
+
+ On success, VAL is returned, NULL otherwise.
+*/
+union value *
+text_to_value (const gchar *text,
+ const struct variable *var,
+ union value *val)
+{
+ return text_to_value__ (text, var_get_print_format (var),
+ var_get_encoding (var), val);
+}
+
+/* Converts TEXT, which contains a value in the given FORMAT encoding in
+ ENCODING, into a value.