Functions -
lang.value
clone |
Returns a clone of
v .
|
cloneReadOnly |
Returns a clone of
v that is read-only, i.
|
fromJsonString |
Parses a string in JSON format and returns the the value that it represents.
|
isReadOnly |
Tests whether
v is read-only, i.
|
mergeJson |
Merges two json values.
|
toJsonString |
Returns the string that represents
v in JSON format.
|
toString |
Performs a minimal conversion of a value to a string.
|
v
.
A clone is a deep copy that does not copy immutable subtrees.
A clone can therefore safely be used concurrently with the original.
It corresponds to the Clone(v) abstract operation,
defined in the Ballerina Language Specification.
Parameters
- v null
-
source value
-
Return Type
(null) clone of
v
v
that is read-only, i.e. immutable.
It corresponds to the ImmutableClone(v) abstract operation,
defined in the Ballerina Language Specification.
Parameters
- v null
-
source value
-
Return Type
(null) immutable clone of
v
Parameters
- str string
-
string representation of json
-
Return Type
(json | error) str
parsed to json or error
v
is read-only, i.e. immutable
Returns true if read-only, false otherwise.
Parameters
- v anydata
-
source value
-
Return Type
(boolean) true if read-only, false otherwise
Parameters
- j1 json
-
json value
- j2 json
-
json value
-
Return Type
(json | error) the merge of
j1
withj2
or an error if the merge failsThe merge of
j1
withj2
is defined as follows:- if
j1
is()
, then the result isj2
- if
j2
is()
, then the result isj1
- if
j1
is a mapping andj2
is a mapping, then for each entry [k, j] in j2, setj1[k]
to the merge ofj1[k]
withj
- if
j1[k]
is undefined, then setj1[k]
toj
- if any merge fails, then the merge of
j1
withj2
fails - otherwise, the result is
j1
.
- if
- otherwise, the merge fails
If the merge fails, then
j1
is unchanged.
- if
v
in JSON format.
Parameters
- v json
-
json value
-
Return Type
(string) string representation of json
Parameters
- v any | error
-
the value to be converted to a string
-
Return Type
(string) a string resulting from the conversion
The result of
toString(v)
is as follows:- if
v
is a string, then returnsv
- if
v
is()
, then returns an empty string - if
v
is boolean, then the stringtrue
orfalse
- if
v
is an int, then returnv
represented as a decimal string - if
v
is a float or decimal, then returnv
represented as a decimal string, with a decimal point only if necessary, but without any suffix indicating the type ofv
; returnNaN
,Infinity
for positive infinity, and-Infinity
for negative infinity - if
v
is a list, then returns the results toString on each member of the list separated by a space character - if
v
is a map, then returns key=value for each member separated by a space character - if
v
is xml, then returnsv
in XML format (as if it occurred within an XML element) - if
v
is table, TBD - if
v
is an error, then a string consisting of the following in order- the string
error
- a space character
- the reason string
- if the detail record is non-empty
- a space character
- the result of calling toString on the detail record
- the string
- if
v
is an object, then- if
v
provides atoString
method with a string return type and no required methods, then the result of calling that method onv
- otherwise,
object
followed by some implementation-dependent string
- if
- if
v
is any other behavioral type, then the identifier for the behavioral type (function
,future
,service
,typedesc
orhandle
) followed by some implementation-dependent string
Note that
toString
may produce the same string for two Ballerina values that are not equal (in the sense of the==
operator).- if