Packageflash.globalization
Classpublic final class LastOperationStatus
InheritanceLastOperationStatus Inheritance Object

Language version: ActionScript 3.0
Runtime version: AIR 2

The LastOperationStatus class enumerates constant values that represent the status of the most recent globalization service operation. These values can be retrieved through the read-only property lastOperationStatus available in most globalization classes.



Public Properties
 PropertyDefined by
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
Public Methods
 MethodDefined by
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
Returns the string representation of the specified object.
Object
 Inherited
Returns the primitive value of the specified object.
Object
Public Constants
 ConstantDefined by
  BUFFER_OVERFLOW_ERROR : String = "bufferOverflowError"
[static] Indicates that given buffer is not enough to hold the result.
LastOperationStatus
  ERROR_CODE_UNKNOWN : String = "errorCodeUnknown"
[static] Indicates that the return error code is not known.
LastOperationStatus
  ILLEGAL_ARGUMENT_ERROR : String = "illegalArgumentError"
[static] Indicates that an argument passed to a method was illegal.
LastOperationStatus
  INDEX_OUT_OF_BOUNDS_ERROR : String = "indexOutOfBoundsError"
[static] Indicates that an iterator went out of range or an invalid parameter was specified for month, day, or time.
LastOperationStatus
  INVALID_ATTR_VALUE : String = "invalidAttrValue"
[static] Indicates that a given attribute value is out of the expected range.
LastOperationStatus
  INVALID_CHAR_FOUND : String = "invalidCharFound"
[static] Indicates that invalid Unicode value was found.
LastOperationStatus
  MEMORY_ALLOCATION_ERROR : String = "memoryAllocationError"
[static] Indicates that memory allocation has failed.
LastOperationStatus
  NO_ERROR : String = "noError"
[static] Indicates that the last operation succeeded without any errors.
LastOperationStatus
  NUMBER_OVERFLOW_ERROR : String = "numberOverflowError"
[static] Indicates that an operation resulted a value that exceeds a specified numeric type.
LastOperationStatus
  PARSE_ERROR : String = "parseError"
[static] Indicates that the parsing of a number failed.
LastOperationStatus
  PATTERN_SYNTAX_ERROR : String = "patternSyntaxError"
[static] Indicates that the pattern for formatting a number, date, or time is invalid.
LastOperationStatus
  PLATFORM_API_FAILED : String = "platformAPIFailed"
[static] Indicates that an underlying platform API failed for an operation.
LastOperationStatus
  TRUNCATED_CHAR_FOUND : String = "truncatedCharFound"
[static] Indicates that a truncated Unicode character value was found.
LastOperationStatus
  UNEXPECTED_TOKEN : String = "unexpectedToken"
[static] Indicates that an unexpected token was detected in a Locale ID string.
LastOperationStatus
  UNSUPPORTED_ERROR : String = "unsupportedError"
[static] Indicates that the requested operation or option is not supported.
LastOperationStatus
  USING_DEFAULT_WARNING : String = "usingDefaultWarning"
[static] Indicates that an operating system default value was used during the most recent operation.
LastOperationStatus
  USING_FALLBACK_WARNING : String = "usingFallbackWarning"
[static] Indicates that a fallback value was set during the most recent operation.
LastOperationStatus
Constant detail
BUFFER_OVERFLOW_ERRORconstant
public static const BUFFER_OVERFLOW_ERROR:String = "bufferOverflowError"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that given buffer is not enough to hold the result.

ERROR_CODE_UNKNOWNconstant 
public static const ERROR_CODE_UNKNOWN:String = "errorCodeUnknown"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that the return error code is not known. Any non-static method or read/write properties can return this error when the operation is not successful and the return error code is not known.

ILLEGAL_ARGUMENT_ERRORconstant 
public static const ILLEGAL_ARGUMENT_ERROR:String = "illegalArgumentError"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that an argument passed to a method was illegal.

For example, the following code shows that an invalid argument error status is set when CurrencyFormatter.grouping property is set to the invalid value "3;".

	    var cf:CurrencyFormatter = new CurrencyFormatter("en-US");
	    cf.groupingPattern = "3;";
	    trace(cf.lastOperationStatus); // "illegalArgumentError"
        
INDEX_OUT_OF_BOUNDS_ERRORconstant 
public static const INDEX_OUT_OF_BOUNDS_ERROR:String = "indexOutOfBoundsError"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that an iterator went out of range or an invalid parameter was specified for month, day, or time.

INVALID_ATTR_VALUEconstant 
public static const INVALID_ATTR_VALUE:String = "invalidAttrValue"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that a given attribute value is out of the expected range.

The following example shows that setting the NumberFormatter.negativeNumberFormat property to an out-of-range value results in an invalid attribute value status.

	    var nf:NumberFormatter = new NumberFormatter(LocaleID.DEFAULT);
	    nf.negativeNumberFormat = 9;
	    nf.lastOperationStatus; // "invalidAttrValue" 
		
INVALID_CHAR_FOUNDconstant 
public static const INVALID_CHAR_FOUND:String = "invalidCharFound"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that invalid Unicode value was found.

MEMORY_ALLOCATION_ERRORconstant 
public static const MEMORY_ALLOCATION_ERROR:String = "memoryAllocationError"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that memory allocation has failed.

NO_ERRORconstant 
public static const NO_ERROR:String = "noError"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that the last operation succeeded without any errors. This status can be returned by all constructors, non-static methods, static methods and read/write properties.

NUMBER_OVERFLOW_ERRORconstant 
public static const NUMBER_OVERFLOW_ERROR:String = "numberOverflowError"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that an operation resulted a value that exceeds a specified numeric type.

PARSE_ERRORconstant 
public static const PARSE_ERROR:String = "parseError"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that the parsing of a number failed. This status can be returned by parsing methods of the formatter classes, such as CurrencyFormatter.parse() and NumberFormatter.parseNumber(). For example, if the value "12abc34" is passed as the parameter to the CurrencyFormatter.parse() method, the method returns "NaN" and sets the lastOperationStatus value to LastOperationStatus.PARSE_ERROR.

PATTERN_SYNTAX_ERRORconstant 
public static const PATTERN_SYNTAX_ERROR:String = "patternSyntaxError"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that the pattern for formatting a number, date, or time is invalid. This status is set when the user's operating system does not support the given pattern.

For example, the following code shows the value of the lastOperationStatus property after an invalid "xx" pattern is used for date formatting:

		var df:DateTimeFormatter = new DateTimeFormatter("en-US");
		df.setDateTimePattern("xx");
	    trace(df.lastOperationStatus); // "patternSyntaxError" 
	    
PLATFORM_API_FAILEDconstant 
public static const PLATFORM_API_FAILED:String = "platformAPIFailed"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that an underlying platform API failed for an operation.

TRUNCATED_CHAR_FOUNDconstant 
public static const TRUNCATED_CHAR_FOUND:String = "truncatedCharFound"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that a truncated Unicode character value was found.

UNEXPECTED_TOKENconstant 
public static const UNEXPECTED_TOKEN:String = "unexpectedToken"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that an unexpected token was detected in a Locale ID string.

For example, the following code shows the value of the lastOperationStatus property after an incomplete string is used when requesting a locale ID. As a result the lastOperationStatus property is set to the value UNEXPECTED_TOKEN after a call to the LocaleID.getKeysAndValues() method.

	    var locale:LocaleID = new LocaleID("en-US@Collation");
		var kav:Object = locale.getKeysAndValues();
		trace(locale.lastOperationStatus); // "unexpectedToken"
		
UNSUPPORTED_ERRORconstant 
public static const UNSUPPORTED_ERROR:String = "unsupportedError"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that the requested operation or option is not supported. This status can be returned by methods like DateTimeFormatter.setDateTimePattern() and when retrieving properties like Collator.ignoreCase.

USING_DEFAULT_WARNINGconstant 
public static const USING_DEFAULT_WARNING:String = "usingDefaultWarning"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that an operating system default value was used during the most recent operation. Class constructors can return this status.

USING_FALLBACK_WARNINGconstant 
public static const USING_FALLBACK_WARNING:String = "usingFallbackWarning"

Language version: ActionScript 3.0
Runtime version: AIR 2

Indicates that a fallback value was set during the most recent operation. This status can be returned by constructors and methods like DateTimeFormatter.setDateTimeStyles(), and when retrieving properties like CurrencyFormatter.groupingPattern.