Diffusion Apple API  6.10.3
Unified Client Library for iOS, tvOS and OS X / macOS
 All Classes Files Functions Variables Enumerations Enumerator Properties Pages
Class Methods | List of all members
PTDiffusionPrimitive Class Reference

Introduction

Support for creating value streams for primitive values including string and numeric types.

Since
6.0
Inheritance diagram for PTDiffusionPrimitive:

Class Methods

(PTDiffusionValueStream *) + doubleFloatNumberValueStreamWithDelegate:
 
(PTDiffusionValueStream *) + int64NumberValueStreamWithDelegate:
 
(PTDiffusionValueStream *) + stringValueStreamWithDelegate:
 
(PTDiffusionValueStream *) + doubleFloatNumberTimeSeriesEventValueStreamWithDelegate:
 
(PTDiffusionValueStream *) + int64NumberTimeSeriesEventValueStreamWithDelegate:
 
(PTDiffusionValueStream *) + stringTimeSeriesEventValueStreamWithDelegate:
 
(PTDiffusionRequestHandler *) + doubleFloatRequestHandlerWithDelegate:
 
(PTDiffusionRequestHandler *) + int64RequestHandlerWithDelegate:
 
(PTDiffusionRequestHandler *) + stringRequestHandlerWithDelegate:
 
(PTDiffusionRequestStream *) + doubleFloatRequestStreamWithDelegate:
 
(PTDiffusionRequestStream *) + int64RequestStreamWithDelegate:
 
(PTDiffusionRequestStream *) + stringRequestStreamWithDelegate:
 
(PTDiffusionSessionResponseStream *) + doubleFloatSessionResponseStreamWithDelegate:
 
(PTDiffusionSessionResponseStream *) + int64SessionResponseStreamWithDelegate:
 
(PTDiffusionSessionResponseStream *) + stringSessionResponseStreamWithDelegate:
 
(PTDiffusionRequest *) + requestWithDouble:
 
(nullable PTDiffusionRequest *) + requestWithDoubleFloatNumber:error:
 
(PTDiffusionRequest *) + requestWithLongLong:
 
(nullable PTDiffusionRequest *) + requestWithInt64Number:error:
 
(nullable PTDiffusionRequest *) + requestWithString:error:
 
(PTDiffusionResponse *) + responseWithDouble:
 
(nullable PTDiffusionResponse *) + responseWithDoubleFloatNumber:error:
 
(PTDiffusionResponse *) + responseWithLongLong:
 
(nullable PTDiffusionResponse *) + responseWithInt64Number:error:
 
(nullable PTDiffusionResponse *) + responseWithString:error:
 
(PTDiffusionUpdateConstraint *) + updateConstraintWithDouble:
 
(nullable
PTDiffusionUpdateConstraint *) 
+ updateConstraintWithDouble:comparisonOperator:error:
 
(nullable
PTDiffusionUpdateConstraint *) 
+ updateConstraintWithDoubleFloatNumber:error:
 
(nullable
PTDiffusionUpdateConstraint *) 
+ updateConstraintWithDoubleFloatNumber:comparisonOperator:error:
 
(PTDiffusionUpdateConstraint *) + updateConstraintWithLongLong:
 
(nullable
PTDiffusionUpdateConstraint *) 
+ updateConstraintWithLongLong:comparisonOperator:error:
 
(nullable
PTDiffusionUpdateConstraint *) 
+ updateConstraintWithInt64Number:error:
 
(nullable
PTDiffusionUpdateConstraint *) 
+ updateConstraintWithInt64Number:comparisonOperator:error:
 
(nullable
PTDiffusionUpdateConstraint *) 
+ updateConstraintWithString:error:
 
(nullable
PTDiffusionUpdateConstraint *) 
+ updateConstraintWithString:comparisonOperator:error:
 

Method Documentation

+ (PTDiffusionValueStream *) doubleFloatNumberTimeSeriesEventValueStreamWithDelegate: (id< PTDiffusionNumberTimeSeriesEventValueStreamDelegate >)  delegate

Creates a value stream capable of receiving double-precision floating point numeric time series events.

Parameters
delegateThe object which will handle the incoming stream. A weak reference is maintained to this object by the returned stream.
Returns
An object reliant on the supplied delegate that can be added as a receiver of values using the Topics feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionTopicsFeature
Since
6.0
+ (PTDiffusionValueStream *) doubleFloatNumberValueStreamWithDelegate: (id< PTDiffusionNumberValueStreamDelegate >)  delegate

Creates a value stream capable of receiving double-precision floating point numbers (Eight-byte IEEE 754).

Parameters
delegateThe object which will handle the incoming stream. A weak reference is maintained to this object by the returned stream.
Returns
An object reliant on the supplied delegate that can be added as a receiver of values using the Topics feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionTopicsFeature
Since
6.0
+ (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.

Parameters
delegateThe object which will handle the incoming requests. A weak reference is maintained to this object by the returned handler.
Returns
An object reliant on the supplied delegate that can be registered at the server using the Messaging feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionMessagingFeature
Since
6.0
+ (PTDiffusionRequestStream *) doubleFloatRequestStreamWithDelegate: (id< PTDiffusionNumberRequestStreamDelegate >)  delegate

Creates a request stream capable of receiving double-precision floating point numeric requests.

Parameters
delegateThe object which will handle the incoming requests. A weak reference is maintained to this object by the returned stream.
Returns
An object reliant on the supplied delegate that can be set as the receiver of requests using the Messaging feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionMessagingFeature
Since
6.0
+ (PTDiffusionSessionResponseStream *) doubleFloatSessionResponseStreamWithDelegate: (id< PTDiffusionNumberSessionResponseStreamDelegate >)  delegate

Creates a response stream capable of receiving double-precision floating point numeric responses from discrete sessions.

Parameters
delegateThe object which will handle the incoming responses. A weak reference is maintained to this object by the returned stream.
Returns
An object reliant on the supplied delegate that can be set as the receiver of requests using the Messaging feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionMessagingFeature
Since
6.1
+ (PTDiffusionValueStream *) int64NumberTimeSeriesEventValueStreamWithDelegate: (id< PTDiffusionNumberTimeSeriesEventValueStreamDelegate >)  delegate

Creates a value stream capable of receiving 64-bit integer time series events.

Parameters
delegateThe object which will handle the incoming stream. A weak reference is maintained to this object by the returned stream.
Returns
An object reliant on the supplied delegate that can be added as a receiver of values using the Topics feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionTopicsFeature
Since
6.0
+ (PTDiffusionValueStream *) int64NumberValueStreamWithDelegate: (id< PTDiffusionNumberValueStreamDelegate >)  delegate

Creates a value stream capable of receiving 64-bit integer values.

Parameters
delegateThe object which will handle the incoming stream. A weak reference is maintained to this object by the returned stream.
Returns
An object reliant on the supplied delegate that can be added as a receiver of values using the Topics feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionTopicsFeature
Since
6.0
+ (PTDiffusionRequestHandler *) int64RequestHandlerWithDelegate: (id< PTDiffusionNumberRequestDelegate >)  delegate

Creates a request handler capable of receiving 64-bit integer requests for a handler registered at the server.

Parameters
delegateThe object which will handle the incoming requests. A weak reference is maintained to this object by the returned handler.
Returns
An object reliant on the supplied delegate that can be registered at the server using the Messaging feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionMessagingFeature
Since
6.0
+ (PTDiffusionRequestStream *) int64RequestStreamWithDelegate: (id< PTDiffusionNumberRequestStreamDelegate >)  delegate

Creates a request stream capable of receiving 64-bit integer requests.

Parameters
delegateThe object which will handle the incoming requests. A weak reference is maintained to this object by the returned stream.
Returns
An object reliant on the supplied delegate that can be set as the receiver of requests using the Messaging feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionMessagingFeature
Since
6.0
+ (PTDiffusionSessionResponseStream *) int64SessionResponseStreamWithDelegate: (id< PTDiffusionNumberSessionResponseStreamDelegate >)  delegate

Creates a response stream capable of receiving 64-bit integer responses from discrete sessions.

Parameters
delegateThe object which will handle the incoming responses. A weak reference is maintained to this object by the returned stream.
Returns
An object reliant on the supplied delegate that can be set as the receiver of requests using the Messaging feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionMessagingFeature
Since
6.1
+ (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.

Parameters
valueThe value to send as the request.
Returns
The new request, or nil on failure.
See Also
PTDiffusionMessagingFeature
Since
6.0
+ (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.

Parameters
numberThe value to send as the request. This may be nil in order to create a 'null' request.
errorLocation to store a reason if this method returns nil to indicate failure.
Returns
The new request, or nil on failure.
See Also
PTDiffusionMessagingFeature
Since
6.0
+ (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.

Parameters
numberThe value to send as the request. This may be nil in order to create a 'null' request.
errorLocation to store a reason if this method returns nil to indicate failure.
Returns
The new request, or nil on failure.
See Also
PTDiffusionMessagingFeature
Since
6.0
+ (PTDiffusionRequest *) requestWithLongLong: (long long)  value

Creates a request that can be used to send the given 64-bit integer value using messaging.

Parameters
valueThe value to send as the request.
Returns
The new request, or nil on failure.
See Also
PTDiffusionMessagingFeature
Since
6.0
+ (nullable PTDiffusionRequest *) requestWithString: (nullable NSString *)  string
error: (NSError **)  error 

Creates a request that can be used to send the given string using messaging.

Parameters
stringThe value to send as the request. This may be nil in order to create a 'null' request.
errorLocation to store a reason if this method returns nil to indicate failure.
Returns
The new request, or nil on failure.
See Also
PTDiffusionMessagingFeature
Since
6.0
+ (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.

Parameters
valueThe value to send as the response.
Returns
The new request, or nil on failure.
See Also
PTDiffusionMessagingFeature
Since
6.1
+ (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.

Parameters
numberThe value to send as the response. This may be nil in order to create a 'null' response.
errorLocation to store a reason if this method returns nil to indicate failure.
Returns
The new response, or nil on failure.
See Also
PTDiffusionMessagingFeature
Since
6.1
+ (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.

Parameters
numberThe value to send as the response. This may be nil in order to create a 'null' response.
errorLocation to store a reason if this method returns nil to indicate failure.
Returns
The new response, or nil on failure.
See Also
PTDiffusionMessagingFeature
Since
6.1
+ (PTDiffusionResponse *) responseWithLongLong: (long long)  value

Creates a response that can be used to send the given 64-bit integer value using messaging.

Parameters
valueThe value to send as the response.
Returns
The new request, or nil on failure.
See Also
PTDiffusionMessagingFeature
Since
6.1
+ (nullable PTDiffusionResponse *) responseWithString: (nullable NSString *)  string
error: (NSError **)  error 

Creates a response that can be used to send the given string using messaging.

Parameters
stringThe value to send as the response. This may be nil in order to create a 'null' response.
errorLocation to store a reason if this method returns nil to indicate failure.
Returns
The new response, or nil on failure.
See Also
PTDiffusionMessagingFeature
Since
6.1
+ (PTDiffusionRequestHandler *) stringRequestHandlerWithDelegate: (id< PTDiffusionStringRequestDelegate >)  delegate

Creates a request handler capable of receiving string requests for a handler registered at the server.

Parameters
delegateThe object which will handle the incoming requests. A weak reference is maintained to this object by the returned handler.
Returns
An object reliant on the supplied delegate that can be registered at the server using the Messaging feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionMessagingFeature
Since
6.0
+ (PTDiffusionRequestStream *) stringRequestStreamWithDelegate: (id< PTDiffusionStringRequestStreamDelegate >)  delegate

Creates a request stream capable of receiving string requests.

Parameters
delegateThe object which will handle the incoming requests. A weak reference is maintained to this object by the returned stream.
Returns
An object reliant on the supplied delegate that can be set as the receiver of requests using the Messaging feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionMessagingFeature
Since
6.0
+ (PTDiffusionSessionResponseStream *) stringSessionResponseStreamWithDelegate: (id< PTDiffusionStringSessionResponseStreamDelegate >)  delegate

Creates a response stream capable of receiving string responses from discrete sessions.

Parameters
delegateThe object which will handle the incoming responses. A weak reference is maintained to this object by the returned stream.
Returns
An object reliant on the supplied delegate that can be set as the receiver of requests using the Messaging feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionMessagingFeature
Since
6.1
+ (PTDiffusionValueStream *) stringTimeSeriesEventValueStreamWithDelegate: (id< PTDiffusionStringTimeSeriesEventValueStreamDelegate >)  delegate

Creates a value stream capable of receiving string time series events.

Parameters
delegateThe object which will handle the incoming stream. A weak reference is maintained to this object by the returned stream.
Returns
An object reliant on the supplied delegate that can be added as a receiver of values using the Topics feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionTopicsFeature
Since
6.0
+ (PTDiffusionValueStream *) stringValueStreamWithDelegate: (id< PTDiffusionStringValueStreamDelegate >)  delegate

Creates a value stream capable of receiving string values.

Parameters
delegateThe object which will handle the incoming stream. A weak reference is maintained to this object by the returned stream.
Returns
An object reliant on the supplied delegate that can be added as a receiver of values using the Topics feature.
Exceptions
NSInvalidArgumentExceptionRaised if the delegate argument is nil.
See Also
PTDiffusionTopicsFeature
Since
6.0
+ (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.

Parameters
valueThe value to be matched against the topic value.
Returns
The new constraint, or nil on failure.
Since
6.3
Deprecated:
since 6.10. Use 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.

Parameters
valueThe value to be compared against the topic value.
comparisonOperatorThe comparison operator. See PTDiffusionUpdateConstraintOperator.
errorLocation to store a reason if this method returns nil to indicate failure.
Returns
The new constraint, or nil on failure.
Since
6.10
+ (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.

Parameters
numberThe value to be compared against the topic value.
comparisonOperatorThe comparison operator. See PTDiffusionUpdateConstraintOperator.
errorLocation to store a reason if this method returns nil to indicate failure.
Returns
The new constraint, or nil on failure.
Since
6.10
+ (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.

Parameters
numberThe value to be matched against the topic value.
errorLocation to store a reason if this method returns nil to indicate failure.
Returns
The new constraint, or nil on failure.
Exceptions
NSInvalidArgumentExceptionIf the number argument is nil.
Since
6.3
Deprecated:
since 6.10. Use 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.

Parameters
valueThe value to be compared against the topic value.
comparisonOperatorThe comparison operator. See PTDiffusionUpdateConstraintOperator.
errorLocation to store a reason if this method returns nil to indicate failure.
Returns
The new constraint, or nil on failure.
Since
6.10
+ (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.

Parameters
numberThe value to be matched against the topic value.
errorLocation to store a reason if this method returns nil to indicate failure.
Returns
The new constraint, or nil on failure.
Exceptions
NSInvalidArgumentExceptionIf the number argument is nil.
Since
6.3
Deprecated:
since 6.10. Use 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.

Parameters
valueThe value to be matched against the topic value.
Returns
The new constraint, or nil on failure.
Since
6.3
Deprecated:
since 6.10. Use 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.

Parameters
valueThe value to be compared against the topic value.
comparisonOperatorThe comparison operator. See PTDiffusionUpdateConstraintOperator.
errorLocation to store a reason if this method returns nil to indicate failure.
Returns
The new constraint, or nil on failure.
Since
6.10
+ (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.

Parameters
stringThe value to be compared against the topic value.
comparisonOperatorThe comparison operator. See PTDiffusionUpdateConstraintOperator.
errorLocation to store a reason if this method returns nil to indicate failure.
Returns
The new constraint, or nil on failure.
Since
6.10
+ (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.

Parameters
stringThe value to be matched against the topic value.
errorLocation to store a reason if this method returns nil to indicate failure.
Returns
The new constraint, or nil on failure.
Exceptions
NSInvalidArgumentExceptionIf the number argument is nil.
Since
6.3
Deprecated:
since 6.10. Use PTDiffusionPrimitive#updateConstraintWithString:comparisonOperator:error instead.