Functions
string	Qore::Json::makeFormattedJSONRPC11ErrorString (softint code, string error, auto id, auto error_msg)
	Creates a JSON-RPC 1.1 error response string from the parameters passed, formatted with line breaks for easier readability.
string	Qore::Json::makeFormattedJSONRPCErrorString (auto version, auto id, auto error_msg)
	Creates a generic JSON-RPC error response string from the parameters passed, formatted with line breaks for easier readability.
string	Qore::Json::makeFormattedJSONRPCRequestString (string method_name, auto version, auto id, auto request_msg)
	Creates a JSON-RPC request string from the parameters passed, formatted with line breaks for easier readability.
string	Qore::Json::makeFormattedJSONRPCResponseString (auto version, auto id, auto response_msg)
	Creates a JSON-RPC response string from the parameters passed, formatted with line breaks for easier readability.
string	Qore::Json::makeJSONRPC11ErrorString (softint code, string error, auto id, auto error_msg)
	Creates a JSON-RPC 1.1 error response string from the parameters passed, without any line breaks.
string	Qore::Json::makeJSONRPCErrorString (auto version, auto id, auto error_msg)
	Creates a generic JSON-RPC error response string from the parameters passed, without any line breaks.
string	Qore::Json::makeJSONRPCRequestString (string method_name, auto version, auto id, auto request_msg)
	Creates a JSON-RPC request string from the parameters passed, without any line breaks.
string	Qore::Json::makeJSONRPCResponseString (auto version, auto id, auto response_msg)
	Creates a JSON-RPC response string from the parameters passed, without any line breaks.
string	Qore::Json::make_jsonrpc11_error (softint code, string error, auto id, auto error_msg, *int format)
	Creates a JSON-RPC 1.1 error response string from the parameters passed, without any line breaks.
string	Qore::Json::make_jsonrpc_error (auto version, auto id, auto error_msg, *int format)
	Creates a generic JSON-RPC error response string from the parameters passed, without any line breaks.
string	Qore::Json::make_jsonrpc_request (string method_name, auto version, auto id, auto request_msg, *int format)
	Creates a JSON-RPC request string from the parameters passed, without any line breaks.
string	Qore::Json::make_jsonrpc_response (auto version, auto id, auto response_msg, *int format)
	Creates a JSON-RPC response string from the parameters passed, without any line breaks.

Detailed Description

Function Documentation

◆ make_jsonrpc11_error()

string Qore::Json::make_jsonrpc11_error	(	softint	code,
		string	error,
		auto	id,
		auto	error_msg,
		*int	format )

Creates a JSON-RPC 1.1 error response string from the parameters passed, without any line breaks.

Code Flags:: RET_VALUE_ONLY, DEPRECATED

Parameters

code	the error code to return
error	a string error message
id	the ID of the call
error_msg	the parameters for the error response message/message payload
format	optional formatting flags; see JSON Generation Constants for more information

Returns: a JSON string in UTF-8 encoding representing the JSON-RPC 1.1 error response, without any line breaks

Exceptions

MAKE-JSONRPC11-ERROR-STRING-ERROR	the error code is not between 100-999 or empty error message string
JSON-SERIALIZATION-ERROR	cannot serialize value passed (ex: binary, object)

Example:: string json = make_jsonrpc11_error(200, msg, id, error);

Qore::Json::make_jsonrpc11_error
string make_jsonrpc11_error(softint code, string error, auto id, auto error_msg, *int format)
Creates a JSON-RPC 1.1 error response string from the parameters passed, without any line breaks.

Since: json 1.5 as a replacement for deprecated camel-case makeJSONRPC11ErrorString() and makeFormattedJSONRPC11ErrorString()

Deprecated: do not use; support for the non-published JSON-RPC 1.1 protocol was dropped in json 1.7

See also

◆ make_jsonrpc_error()

string Qore::Json::make_jsonrpc_error	(	auto	version,
		auto	id,
		auto	error_msg,
		*int	format )

Creates a generic JSON-RPC error response string from the parameters passed, without any line breaks.

Code Flags:: RET_VALUE_ONLY

Parameters

version	the JSON-RPC version to include in the call under the `"version"` key (for JSON-RPC earlier than 2.0) or the `"jsonrpc"` key (for JSON-RPC equal to or greater than 2.0); will be converted to a string; if the resulting string is empty, the `"version"` key will not be sent; note that for strict JSON-RPC 1.0 compatibility this argument will not be serialized if passed as `"1.0"`
id	the ID of the call
error_msg	the parameters for the error response message/message payload
format	optional formatting flags; see JSON Generation Constants for more information

Returns: a JSON string in UTF-8 encoding representing the JSON-RPC error response, without any line breaks

Exceptions

JSON-SERIALIZATION-ERROR cannot serialize value passed (ex: binary, object)

Example:: string json = make_jsonrpc_error("1.0", id, error);

Qore::Json::make_jsonrpc_error
string make_jsonrpc_error(auto version, auto id, auto error_msg, *int format)
Creates a generic JSON-RPC error response string from the parameters passed, without any line breaks.

Since

json 1.5 added this function as a replacement for deprecated camel-case makeJSONRPCErrorString() and makeFormattedJSONRPCErrorString()
json 1.7 added support for JSON-RPC 2.0 and corrections for JSON-RPC 1.0 support

Note: do not use the version argument for strict JSON-RPC 1.0 compatibility (send as NOTHING)

See also

◆ make_jsonrpc_request()

string Qore::Json::make_jsonrpc_request	(	string	method_name,
		auto	version,
		auto	id,
		auto	request_msg,
		*int	format )

Creates a JSON-RPC request string from the parameters passed, without any line breaks.

To follow JSON-RPC specifications, the generated string will always be in UTF-8 encoding

Code Flags:: RET_VALUE_ONLY

Parameters

method_name	the name of the JSON-RPC method to call
version	the JSON-RPC version to include in the call under the `"version"` key (for JSON-RPC earlier than 2.0) or the `"jsonrpc"` key (for JSON-RPC equal to or greater than 2.0); will be converted to a string; if the resulting string is empty, the `"version"` key will not be sent; note that for strict JSON-RPC 1.0 compatibility this argument will not be serialized if passed as `"1.0"`
id	the ID of the call
request_msg	the parameters for the message/message payload
format	optional formatting flags; see JSON Generation Constants for more information

Returns: a JSON string in UTF-8 encoding representing the JSON-RPC request

Exceptions

JSON-SERIALIZATION-ERROR cannot serialize value passed (ex: binary, object)

Example:: string json = make_jsonrpc_request("omq.system.help", "1.0", id, msg);

Qore::Json::make_jsonrpc_request
string make_jsonrpc_request(string method_name, auto version, auto id, auto request_msg, *int format)
Creates a JSON-RPC request string from the parameters passed, without any line breaks.

Since

json 1.5 added this function as a replacement for deprecated camel-case makeJSONRPCRequestString() and makeFormattedJSONRPCRequestString()
json 1.7 added support for JSON-RPC 2.0 and corrections for JSON-RPC 1.0 support

Note: do not use the version argument for strict JSON-RPC 1.0 compatibility (send as NOTHING)

See also

◆ make_jsonrpc_response()

string Qore::Json::make_jsonrpc_response	(	auto	version,
		auto	id,
		auto	response_msg,
		*int	format )

Creates a JSON-RPC response string from the parameters passed, without any line breaks.

Code Flags:: RET_VALUE_ONLY

Parameters

version	the JSON-RPC version to include in the call under the `"version"` key (for JSON-RPC earlier than 2.0) or the `"jsonrpc"` key (for JSON-RPC equal to or greater than 2.0); will be converted to a string; if the resulting string is empty, the `"version"` key will not be sent; note that for strict JSON-RPC 1.0 compatibility this argument will not be serialized if passed as `"1.0"`
id	the ID of the call
response_msg	the parameters for the message/message payload
format	optional formatting flags; see JSON Generation Constants for more information

Returns: a JSON string in UTF-8 encoding representing the JSON-RPC response, without any line breaks

Exceptions

JSON-SERIALIZATION-ERROR cannot serialize value passed (ex: binary, object)

Example:: string json = make_jsonrpc_response("1.0", id, msg);

Qore::Json::make_jsonrpc_response
string make_jsonrpc_response(auto version, auto id, auto response_msg, *int format)
Creates a JSON-RPC response string from the parameters passed, without any line breaks.

Since

json 1.5 added this function as a replacement for deprecated camel-case makeJSONRPCResponseString() and makeFormattedJSONRPCResponseString()
json 1.7 added support for JSON-RPC 2.0 and corrections for JSON-RPC 1.0 support

Note: do not use the version argument for strict JSON-RPC 1.0 compatibility (send as NOTHING)

See also

◆ makeFormattedJSONRPC11ErrorString()

string Qore::Json::makeFormattedJSONRPC11ErrorString	(	softint	code,
		string	error,
		auto	id,
		auto	error_msg )

Creates a JSON-RPC 1.1 error response string from the parameters passed, formatted with line breaks for easier readability.

Code Flags:: RET_VALUE_ONLY, DEPRECATED

Parameters

code	the error code to return
error	a string error message
id	the ID of the call
error_msg	the parameters for the error response message/message payload

Returns: a JSON string in UTF-8 encoding representing the JSON-RPC 1.1 error response, formatted with line breaks for easier readability

Exceptions

MAKE-JSONRPC11-ERROR-STRING-ERROR	the error code is not between 100-999 or empty error message string
JSON-SERIALIZATION-ERROR	cannot serialize value passed (ex: binary, object)

Deprecated: do not use; camel-case function names were deprecated in json 1.5, and support for the non-published JSON-RPC 1.1 protocol was dropped in json 1.7

See also

◆ makeFormattedJSONRPCErrorString()

string Qore::Json::makeFormattedJSONRPCErrorString	(	auto	version,
		auto	id,
		auto	error_msg )

Creates a generic JSON-RPC error response string from the parameters passed, formatted with line breaks for easier readability.

Code Flags:: RET_VALUE_ONLY, DEPRECATED

Parameters

version	the JSON-RPC version to include in the call under the `"version"` key (for JSON-RPC earlier than 2.0) or the `"jsonrpc"` key (for JSON-RPC equal to or greater than 2.0); will be converted to a string; if the resulting string is empty, the `"version"` key will not be sent; note that for strict JSON-RPC 1.0 compatibility this argument will not be serialized if passed as `"1.0"`
id	the ID of the call
error_msg	the parameters for the error response message/message payload

Returns: a JSON string in UTF-8 encoding representing the JSON-RPC error response, formatted with line breaks for easier readability

Exceptions

JSON-SERIALIZATION-ERROR cannot serialize value passed (ex: binary, object)

Deprecated: use make_jsonrpc_error(); camel-case function names were deprecated in json 1.5

Note: do not use the version argument for strict JSON-RPC 1.0 compatibility (send as NOTHING)

See also

◆ makeFormattedJSONRPCRequestString()

string Qore::Json::makeFormattedJSONRPCRequestString	(	string	method_name,
		auto	version,
		auto	id,
		auto	request_msg )

Creates a JSON-RPC request string from the parameters passed, formatted with line breaks for easier readability.

To follow JSON-RPC specifications, the generated string will always be in UTF-8 encoding

Code Flags:: RET_VALUE_ONLY, DEPRECATED

Parameters

method_name	the name of the JSON-RPC method to call
version	the JSON-RPC version to include in the call under the `"version"` key (for JSON-RPC earlier than 2.0) or the `"jsonrpc"` key (for JSON-RPC equal to or greater than 2.0); will be converted to a string; if the resulting string is empty, the `"version"` key will not be sent; note that for strict JSON-RPC 1.0 compatibility this argument will not be serialized if passed as `"1.0"s`
id	the ID of the call
request_msg	the parameters for the message/message payload

Returns: a JSON string in UTF-8 encoding representing the JSON-RPC request, formatted with line breaks for easier readability

Exceptions

JSON-SERIALIZATION-ERROR cannot serialize value passed (ex: binary, object)

Deprecated: use make_jsonrpc_request(); camel-case function names were deprecated in json 1.5

Note: do not use the version argument for strict JSON-RPC 1.0 compatibility (send as NOTHING)

See also

◆ makeFormattedJSONRPCResponseString()

string Qore::Json::makeFormattedJSONRPCResponseString	(	auto	version,
		auto	id,
		auto	response_msg )

Creates a JSON-RPC response string from the parameters passed, formatted with line breaks for easier readability.

Code Flags:: RET_VALUE_ONLY, DEPRECATED

Parameters

version	the JSON-RPC version to include in the call under the `"version"` key (for JSON-RPC earlier than 2.0) or the `"jsonrpc"` key (for JSON-RPC equal to or greater than 2.0); will be converted to a string; if the resulting string is empty, the `"version"` key will not be sent; note that for strict JSON-RPC 1.0 compatibility this argument will not be serialized if passed as `"1.0"`
id	the ID of the call
response_msg	the parameters for the message/message payload

Returns: a JSON string in UTF-8 encoding representing the JSON-RPC response, formatted with line breaks for easier readability

Exceptions

JSON-SERIALIZATION-ERROR cannot serialize value passed (ex: binary, object)

Deprecated: use make_jsonrpc_response(); camel-case function names were deprecated in json 1.5

Note: do not use the version argument for strict JSON-RPC 1.0 compatibility (send as NOTHING)

See also

◆ makeJSONRPC11ErrorString()

string Qore::Json::makeJSONRPC11ErrorString	(	softint	code,
		string	error,
		auto	id,
		auto	error_msg )

Creates a JSON-RPC 1.1 error response string from the parameters passed, without any line breaks.

Code Flags:: RET_VALUE_ONLY, DEPRECATED

Parameters

code	the error code to return
error	a string error message
id	the ID of the call
error_msg	the parameters for the error response message/message payload

Returns: a JSON string in UTF-8 encoding representing the JSON-RPC 1.1 error response, without any line breaks

Exceptions

MAKE-JSONRPC11-ERROR-STRING-ERROR	the error code is not between 100-999 or empty error message string
JSON-SERIALIZATION-ERROR	cannot serialize value passed (ex: binary, object)

Deprecated: do not use; camel-case function names were deprecated in json 1.5, and support for the non-published JSON-RPC 1.1 protocol was dropped in json 1.7

See also

◆ makeJSONRPCErrorString()

string Qore::Json::makeJSONRPCErrorString	(	auto	version,
		auto	id,
		auto	error_msg )

Creates a generic JSON-RPC error response string from the parameters passed, without any line breaks.

Code Flags:: RET_VALUE_ONLY, DEPRECATED

Parameters

version	the JSON-RPC version to include in the call under the `"version"` key (for JSON-RPC earlier than 2.0) or the `"jsonrpc"` key (for JSON-RPC equal to or greater than 2.0); will be converted to a string; if the resulting string is empty, the `"version"` key will not be sent; note that for strict JSON-RPC 1.0 compatibility this argument will not be serialized if passed as `"1.0"`
id	the ID of the call
error_msg	the parameters for the error response message/message payload

Returns: a JSON string in UTF-8 encoding representing the JSON-RPC error response, without any line breaks

Exceptions

JSON-SERIALIZATION-ERROR cannot serialize value passed (ex: binary, object)

Deprecated: use make_jsonrpc_error(); camel-case function names were deprecated in json 1.5

Note: do not use the version argument for strict JSON-RPC 1.0 compatibility (send as NOTHING)

See also

◆ makeJSONRPCRequestString()

string Qore::Json::makeJSONRPCRequestString	(	string	method_name,
		auto	version,
		auto	id,
		auto	request_msg )

Creates a JSON-RPC request string from the parameters passed, without any line breaks.

To follow JSON-RPC specifications, the generated string will always be in UTF-8 encoding

Code Flags:: RET_VALUE_ONLY, DEPRECATED

Parameters

method_name	the name of the JSON-RPC method to call
version	the JSON-RPC version to include in the call under the `"version"` key (for JSON-RPC earlier than 2.0) or the `"jsonrpc"` key (for JSON-RPC equal to or greater than 2.0); will be converted to a string; if the resulting string is empty, the `"version"` key will not be sent; for strict JSON-RPC 1.0 compatibility this argument will not be serialized if passed as `"1.0"`
id	the ID of the call
request_msg	the parameters for the message/message payload

Returns: a JSON string in UTF-8 encoding representing the JSON-RPC request

Exceptions

JSON-SERIALIZATION-ERROR cannot serialize value passed (ex: binary, object)

Deprecated: use make_jsonrpc_request(); camel-case function names were deprecated in json 1.5

Note: do not use the version argument for strict JSON-RPC 1.0 compatibility (send as NOTHING)

See also

◆ makeJSONRPCResponseString()

string Qore::Json::makeJSONRPCResponseString	(	auto	version,
		auto	id,
		auto	response_msg )

Creates a JSON-RPC response string from the parameters passed, without any line breaks.

Code Flags:: RET_VALUE_ONLY, DEPRECATED

Parameters

version	the JSON-RPC version to include in the call under the `"version"` key (for JSON-RPC earlier than 2.0) or the `"jsonrpc"` key (for JSON-RPC equal to or greater than 2.0); will be converted to a string; if the resulting string is empty, the `"version"` key will not be sent; note that for strict JSON-RPC 1.0 compatibility this argument will not be serialized if passed as `"1.0"`
id	the ID of the call
response_msg	the parameters for the message/message payload

Returns: a JSON string in UTF-8 encoding representing the JSON-RPC response, without any line breaks

Exceptions

JSON-SERIALIZATION-ERROR cannot serialize value passed (ex: binary, object)

Deprecated: use make_jsonrpc_response(); camel-case function names were deprecated in json 1.5

Note: do not use the version argument for strict JSON-RPC 1.0 compatibility (send as NOTHING)

See also

Functions

Detailed Description

Function Documentation

◆ make_jsonrpc11_error()

◆ make_jsonrpc_error()

◆ make_jsonrpc_request()

◆ make_jsonrpc_response()

◆ makeFormattedJSONRPC11ErrorString()

◆ makeFormattedJSONRPCErrorString()

◆ makeFormattedJSONRPCRequestString()

◆ makeFormattedJSONRPCResponseString()

◆ makeJSONRPC11ErrorString()

◆ makeJSONRPCErrorString()

◆ makeJSONRPCRequestString()

◆ makeJSONRPCResponseString()