![]() |
Diffusion Apple API 6.11.5
Unified Client Library for iOS, tvOS and OS X / macOS
|
Support for creating value streams for primitive values including string and numeric types.
+ (PTDiffusionValueStream *) doubleFloatNumberTimeSeriesEventValueStreamWithDelegate: | (id< PTDiffusionNumberTimeSeriesEventValueStreamDelegate >) | delegate |
Creates a value stream capable of receiving double-precision floating point numeric time series events.
delegate | The object which will handle the incoming stream. A weak reference is maintained to this object by the returned stream. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionValueStream *) doubleFloatNumberValueStreamWithDelegate: | (id< PTDiffusionNumberValueStreamDelegate >) | delegate |
Creates a value stream capable of receiving double-precision floating point numbers (Eight-byte IEEE 754).
delegate | The object which will handle the incoming stream. A weak reference is maintained to this object by the returned stream. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionRequestHandler *) doubleFloatRequestHandlerWithDelegate: | (id< PTDiffusionNumberRequestDelegate >) | delegate |
Creates a request handler capable of receiving double-precision floating point numeric requests (Eight-byte IEEE 754) for a handler registered at the server.
delegate | The object which will handle the incoming requests. A weak reference is maintained to this object by the returned handler. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionRequestStream *) doubleFloatRequestStreamWithDelegate: | (id< PTDiffusionNumberRequestStreamDelegate >) | delegate |
Creates a request stream capable of receiving double-precision floating point numeric requests.
delegate | The object which will handle the incoming requests. A weak reference is maintained to this object by the returned stream. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionSessionResponseStream *) doubleFloatSessionResponseStreamWithDelegate: | (id< PTDiffusionNumberSessionResponseStreamDelegate >) | delegate |
Creates a response stream capable of receiving double-precision floating point numeric responses from discrete sessions.
delegate | The object which will handle the incoming responses. A weak reference is maintained to this object by the returned stream. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionValueStream *) int64NumberTimeSeriesEventValueStreamWithDelegate: | (id< PTDiffusionNumberTimeSeriesEventValueStreamDelegate >) | delegate |
Creates a value stream capable of receiving 64-bit integer time series events.
delegate | The object which will handle the incoming stream. A weak reference is maintained to this object by the returned stream. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionValueStream *) int64NumberValueStreamWithDelegate: | (id< PTDiffusionNumberValueStreamDelegate >) | delegate |
Creates a value stream capable of receiving 64-bit integer values.
delegate | The object which will handle the incoming stream. A weak reference is maintained to this object by the returned stream. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionRequestHandler *) int64RequestHandlerWithDelegate: | (id< PTDiffusionNumberRequestDelegate >) | delegate |
Creates a request handler capable of receiving 64-bit integer requests for a handler registered at the server.
delegate | The object which will handle the incoming requests. A weak reference is maintained to this object by the returned handler. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionRequestStream *) int64RequestStreamWithDelegate: | (id< PTDiffusionNumberRequestStreamDelegate >) | delegate |
Creates a request stream capable of receiving 64-bit integer requests.
delegate | The object which will handle the incoming requests. A weak reference is maintained to this object by the returned stream. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionSessionResponseStream *) int64SessionResponseStreamWithDelegate: | (id< PTDiffusionNumberSessionResponseStreamDelegate >) | delegate |
Creates a response stream capable of receiving 64-bit integer responses from discrete sessions.
delegate | The object which will handle the incoming responses. A weak reference is maintained to this object by the returned stream. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionRequest *) requestWithDouble: | (double) | value |
Creates a request that can be used to send the given double-precision floating point (Eight-byte IEEE 754) value using messaging.
value | The value to send as the request. |
nil
on failure.+ (nullable PTDiffusionRequest *) requestWithDoubleFloatNumber: | (nullable NSNumber *) | number | |
error: | (NSError **) | error | |
Creates a request that can be used to send the given double-precision floating point (Eight-byte IEEE 754) value using messaging.
number | The value to send as the request. This may be nil in order to create a 'null' request. |
error | Location to store a reason if this method returns nil to indicate failure. |
nil
on failure.+ (nullable PTDiffusionRequest *) requestWithInt64Number: | (nullable NSNumber *) | number | |
error: | (NSError **) | error | |
Creates a request that can be used to send the given 64-bit integer value using messaging.
number | The value to send as the request. This may be nil in order to create a 'null' request. |
error | Location to store a reason if this method returns nil to indicate failure. |
nil
on failure.+ (PTDiffusionRequest *) requestWithLongLong: | (long long) | value |
Creates a request that can be used to send the given 64-bit integer value using messaging.
value | The value to send as the request. |
nil
on failure.+ (nullable PTDiffusionRequest *) requestWithString: | (nullable NSString *) | string | |
error: | (NSError **) | error | |
Creates a request that can be used to send the given string using messaging.
string | The value to send as the request. This may be nil in order to create a 'null' request. |
error | Location to store a reason if this method returns nil to indicate failure. |
nil
on failure.+ (PTDiffusionResponse *) responseWithDouble: | (double) | value |
Creates a response that can be used to send the given double-precision floating point (Eight-byte IEEE 754) value using messaging.
value | The value to send as the response. |
nil
on failure.+ (nullable PTDiffusionResponse *) responseWithDoubleFloatNumber: | (nullable NSNumber *) | number | |
error: | (NSError **) | error | |
Creates a response that can be used to send the given double-precision floating point (Eight-byte IEEE 754) value using messaging.
number | The value to send as the response. This may be nil in order to create a 'null' response. |
error | Location to store a reason if this method returns nil to indicate failure. |
nil
on failure.+ (nullable PTDiffusionResponse *) responseWithInt64Number: | (nullable NSNumber *) | number | |
error: | (NSError **) | error | |
Creates a response that can be used to send the given 64-bit integer value using messaging.
number | The value to send as the response. This may be nil in order to create a 'null' response. |
error | Location to store a reason if this method returns nil to indicate failure. |
nil
on failure.+ (PTDiffusionResponse *) responseWithLongLong: | (long long) | value |
Creates a response that can be used to send the given 64-bit integer value using messaging.
value | The value to send as the response. |
nil
on failure.+ (nullable PTDiffusionResponse *) responseWithString: | (nullable NSString *) | string | |
error: | (NSError **) | error | |
Creates a response that can be used to send the given string using messaging.
string | The value to send as the response. This may be nil in order to create a 'null' response. |
error | Location to store a reason if this method returns nil to indicate failure. |
nil
on failure.+ (PTDiffusionRequestHandler *) stringRequestHandlerWithDelegate: | (id< PTDiffusionStringRequestDelegate >) | delegate |
Creates a request handler capable of receiving string requests for a handler registered at the server.
delegate | The object which will handle the incoming requests. A weak reference is maintained to this object by the returned handler. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionRequestStream *) stringRequestStreamWithDelegate: | (id< PTDiffusionStringRequestStreamDelegate >) | delegate |
Creates a request stream capable of receiving string requests.
delegate | The object which will handle the incoming requests. A weak reference is maintained to this object by the returned stream. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionSessionResponseStream *) stringSessionResponseStreamWithDelegate: | (id< PTDiffusionStringSessionResponseStreamDelegate >) | delegate |
Creates a response stream capable of receiving string responses from discrete sessions.
delegate | The object which will handle the incoming responses. A weak reference is maintained to this object by the returned stream. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionValueStream *) stringTimeSeriesEventValueStreamWithDelegate: | (id< PTDiffusionStringTimeSeriesEventValueStreamDelegate >) | delegate |
Creates a value stream capable of receiving string time series events.
delegate | The object which will handle the incoming stream. A weak reference is maintained to this object by the returned stream. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionValueStream *) stringValueStreamWithDelegate: | (id< PTDiffusionStringValueStreamDelegate >) | delegate |
Creates a value stream capable of receiving string values.
delegate | The object which will handle the incoming stream. A weak reference is maintained to this object by the returned stream. |
NSInvalidArgumentException | Raised if the delegate argument is `nil`. |
+ (PTDiffusionUpdateConstraint *) updateConstraintWithDouble: | (double) | value |
Returns an update constraint requiring the current value of a topic to exactly match the given double-precision floating point (Eight-byte IEEE 754) value.
This is exactly equivalent to calling PTDiffusionPrimitive#updateConstraintWithDouble:comparisonOperator:error
, specifying the IS
operator.
Use noValue (PTDiffusionUpdateConstraint) to check if the topic has no value.
This constraint is unsatisfied if no topic is present at the path.
value | The value to be matched against the topic value. |
nil
on failure.PTDiffusionPrimitive#updateConstraintWithDouble:comparisonOperator:error
instead. + (nullable PTDiffusionUpdateConstraint *) updateConstraintWithDouble: | (double) | value | |
comparisonOperator: | (nonnull PTDiffusionUpdateConstraintOperator *) | comparisonOperator | |
error: | (NSError *__autoreleasing *const) | error | |
Returns an update constraint comparing the current value of a topic to the given double-precision floating point (Eight-byte IEEE 754) value.
This update constraint will work with STRING
, INT64
or DOUBLE
topics (or TIME_SERIES
topics with a primitive event type) only.
STRING
topics can only be compared if they contain a value that can be parsed as a number.
If the value of a STRING
topic cannot be parsed as a number, or the topic is of any other non-number type, the constraint will be unsatisfied.
Any of the operators (other than IS
) can be used with such number comparisons.
Decimal numbers can be compared with integral numbers so 1
is equal to 1.0
, "1"
, or "1.0"
.
When a STRING
, INT64
or DOUBLE
topic is updated to a null
value, the topic is set to have no value. Use the PTDiffusionUpdateConstraint#noValue
constraint to check if the topic has no value.
This constraint is unsatisfied if no topic is present at the path.
value | The value to be compared against the topic value. |
comparisonOperator | The comparison operator. See PTDiffusionUpdateConstraintOperator . |
error | Location to store a reason if this method returns nil to indicate failure. |
nil
on failure.+ (nullable PTDiffusionUpdateConstraint *) updateConstraintWithDoubleFloatNumber: | (nullable NSNumber *) | number | |
comparisonOperator: | (nonnull PTDiffusionUpdateConstraintOperator *) | comparisonOperator | |
error: | (NSError *__autoreleasing *const) | error | |
Returns an update constraint comparing the current value of a topic to the given double-precision floating point (Eight-byte IEEE 754) value.
This update constraint will work with STRING
, INT64
or DOUBLE
topics (or TIME_SERIES
topics with a primitive event type) only.
STRING
topics can only be compared if they contain a value that can be parsed as a number.
If the value of a STRING
topic cannot be parsed as a number, or the topic is of any other non-number type, the constraint will be unsatisfied.
Any of the operators (other than IS
) can be used with such number comparisons.
Decimal numbers can be compared with integral numbers so 1
is equal to 1.0
, "1"
, or "1.0"
.
When a STRING
, INT64
or DOUBLE
topic is updated to a null
value, the topic is set to have no value. Use the PTDiffusionUpdateConstraint#noValue
constraint to check if the topic has no value.
This constraint is unsatisfied if no topic is present at the path.
number | The value to be compared against the topic value. |
comparisonOperator | The comparison operator. See PTDiffusionUpdateConstraintOperator . |
error | Location to store a reason if this method returns nil to indicate failure. |
nil
on failure.+ (nullable PTDiffusionUpdateConstraint *) updateConstraintWithDoubleFloatNumber: | (NSNumber *) | number | |
error: | (NSError *__autoreleasing *const) | error | |
Returns an update constraint requiring the current value of a topic to exactly match the given double-precision floating point (Eight-byte IEEE 754) value.
This is exactly equivalent to calling PTDiffusionPrimitive#updateConstraintWithDoubleFloatNumber:comparisonOperator:error
, specifying the IS
operator.
Use noValue (PTDiffusionUpdateConstraint) to check if the topic has no value.
This constraint is unsatisfied if no topic is present at the path.
number | The value to be matched against the topic value. |
error | Location to store a reason if this method returns nil to indicate failure. |
nil
on failure.NSInvalidArgumentException | If the number argument is `nil`. |
PTDiffusionPrimitive#updateConstraintWithDoubleFloatNumber:comparisonOperator:error
instead. + (nullable PTDiffusionUpdateConstraint *) updateConstraintWithInt64Number: | (nullable NSNumber *) | number | |
comparisonOperator: | (nonnull PTDiffusionUpdateConstraintOperator *) | comparisonOperator | |
error: | (NSError *__autoreleasing *const) | error | |
Returns an update constraint comparing the current value of a topic to the given 64-bit integer value.
This update constraint will work with STRING
, INT64
or DOUBLE
topics (or TIME_SERIES
topics with a primitive event type) only.
STRING
topics can only be compared if they contain a value that can be parsed as a number.
If the value of a STRING
topic cannot be parsed as a number, or the topic is of any other non-number type, the constraint will be unsatisfied.
Any of the operators (other than IS
) can be used with such number comparisons.
Decimal numbers can be compared with integral numbers so 1
is equal to 1.0
, "1"
, or "1.0"
.
When a STRING
, INT64
or DOUBLE
topic is updated to a null
value, the topic is set to have no value. Use the PTDiffusionUpdateConstraint#noValue
constraint to check if the topic has no value.
This constraint is unsatisfied if no topic is present at the path.
value | The value to be compared against the topic value. |
comparisonOperator | The comparison operator. See PTDiffusionUpdateConstraintOperator . |
error | Location to store a reason if this method returns nil to indicate failure. |
nil
on failure.+ (nullable PTDiffusionUpdateConstraint *) updateConstraintWithInt64Number: | (NSString *) | number | |
error: | (NSError *__autoreleasing *const) | error | |
Returns an update constraint requiring the current value of a topic to exactly match the given 64-bit integer value.
This is exactly equivalent to calling PTDiffusionPrimitive#updateConstraintWithInt64Number:comparisonOperator:error
, specifying the IS
operator.
Use noValue (PTDiffusionUpdateConstraint) to check if the topic has no value.
This constraint is unsatisfied if no topic is present at the path.
number | The value to be matched against the topic value. |
error | Location to store a reason if this method returns nil to indicate failure. |
nil
on failure.NSInvalidArgumentException | If the number argument is `nil`. |
PTDiffusionPrimitive#updateConstraintWithInt64Number:comparisonOperator:error
instead. + (PTDiffusionUpdateConstraint *) updateConstraintWithLongLong: | (long long) | value |
Returns an update constraint requiring the current value of a topic to exactly match the given 64-bit integer value.
This is exactly equivalent to calling PTDiffusionPrimitive#updateConstraintWithLongLong:comparisonOperator:error
, specifying the IS
operator.
Use noValue (PTDiffusionUpdateConstraint) to check if the topic has no value.
This constraint is unsatisfied if no topic is present at the path.
value | The value to be matched against the topic value. |
nil
on failure.PTDiffusionPrimitive#updateConstraintWithLongLong:comparisonOperator:error
instead. + (nullable PTDiffusionUpdateConstraint *) updateConstraintWithLongLong: | (long long) | value | |
comparisonOperator: | (nonnull PTDiffusionUpdateConstraintOperator *) | comparisonOperator | |
error: | (NSError *__autoreleasing *const) | error | |
Returns an update constraint comparing the current value of a topic to the given 64-bit integer value.
This update constraint will work with STRING
, INT64
or DOUBLE
topics (or TIME_SERIES
topics with a primitive event type) only.
STRING
topics can only be compared if they contain a value that can be parsed as a number.
If the value of a STRING
topic cannot be parsed as a number, or the topic is of any other non-number type, the constraint will be unsatisfied.
Any of the operators (other than IS
) can be used with such number comparisons.
Decimal numbers can be compared with integral numbers so 1
is equal to 1.0
, "1"
, or "1.0"
.
When a STRING
, INT64
or DOUBLE
topic is updated to a null
value, the topic is set to have no value. Use the PTDiffusionUpdateConstraint#noValue
constraint to check if the topic has no value.
This constraint is unsatisfied if no topic is present at the path.
value | The value to be compared against the topic value. |
comparisonOperator | The comparison operator. See PTDiffusionUpdateConstraintOperator . |
error | Location to store a reason if this method returns nil to indicate failure. |
nil
on failure.+ (nullable PTDiffusionUpdateConstraint *) updateConstraintWithString: | (nullable NSString *) | string | |
comparisonOperator: | (nonnull PTDiffusionUpdateConstraintOperator *) | comparisonOperator | |
error: | (NSError *__autoreleasing *const) | error | |
Returns an update constraint comparing the current value of a topic to the given string value.
If the operator is EQ
or NE
, the string representation of the topic will be compared to the supplied value.
This can only be used with primitive topic types (or TIME_SERIES
topics with a primitive event type).
Other operators (other than IS
) are not permitted with String values.
When a STRING
, INT64
or DOUBLE
topic is updated to a null
value, the topic is set to have no value. Use the PTDiffusionUpdateConstraint#noValue
constraint to check if the topic has no value.
This constraint is unsatisfied if no topic is present at the path.
string | The value to be compared against the topic value. |
comparisonOperator | The comparison operator. See PTDiffusionUpdateConstraintOperator . |
error | Location to store a reason if this method returns nil to indicate failure. |
nil
on failure.+ (nullable PTDiffusionUpdateConstraint *) updateConstraintWithString: | (NSString *) | string | |
error: | (NSError *__autoreleasing *const) | error | |
Returns an update constraint requiring the current value of a topic to exactly match the given string value.
This is exactly equivalent to calling PTDiffusionPrimitive#updateConstraintWithString:comparisonOperator:error
, specifying the IS
operator.
Use noValue (PTDiffusionUpdateConstraint) to check if the topic has no value.
This constraint is unsatisfied if no topic is present at the path.
string | The value to be matched against the topic value. |
error | Location to store a reason if this method returns nil to indicate failure. |
nil
on failure.NSInvalidArgumentException | If the number argument is `nil`. |
PTDiffusionPrimitive#updateConstraintWithString:comparisonOperator:error
instead.