flash.globalization

# LastOperationStatus - AS3

Package | flash.globalization
Class | public final class LastOperationStatus
Inheritance | LastOperationStatus Object

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, 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
Hide Inherited Public Properties
Show Inherited Public Properties

| Property | Defined By
--- | --- | ---
|  | constructor : Object A reference to the class object or constructor function for a given object instance. | Object

Public Methods
Hide Inherited Public Methods
Show Inherited Public Methods

| Method | Defined By
--- | --- | ---
|  | hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined. | Object
|  | isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter. | Object
|  | propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable. | Object
|  | setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations. | Object
|  | toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions. | Object
|  | toString():String Returns the string representation of the specified object. | Object
|  | valueOf():Object Returns the primitive value of the specified object. | Object

Public Constants

| Constant | Defined 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_ERROR

Constant

`public static const BUFFER_OVERFLOW_ERROR:String = "bufferOverflowError"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, AIR 2

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

### ERROR_CODE_UNKNOWN

Constant

`public static const ERROR_CODE_UNKNOWN:String = "errorCodeUnknown"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, 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_ERROR

Constant

`public static const ILLEGAL_ARGUMENT_ERROR:String = "illegalArgumentError"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, 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;".

Copy

            var cf:CurrencyFormatter = new CurrencyFormatter("en-US");
            cf.groupingPattern = "3;";
            trace(cf.lastOperationStatus); // "illegalArgumentError"

### INDEX_OUT_OF_BOUNDS_ERROR

Constant

`public static const INDEX_OUT_OF_BOUNDS_ERROR:String = "indexOutOfBoundsError"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, AIR 2

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

### INVALID_ATTR_VALUE

Constant

`public static const INVALID_ATTR_VALUE:String = "invalidAttrValue"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, 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.

Copy

            var nf:NumberFormatter = new NumberFormatter(LocaleID.DEFAULT);
            nf.negativeNumberFormat = 9;
            nf.lastOperationStatus; // "invalidAttrValue"

### INVALID_CHAR_FOUND

Constant

`public static const INVALID_CHAR_FOUND:String = "invalidCharFound"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, AIR 2

Indicates that invalid Unicode value was found.

### MEMORY_ALLOCATION_ERROR

Constant

`public static const MEMORY_ALLOCATION_ERROR:String = "memoryAllocationError"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, AIR 2

Indicates that memory allocation has failed.

### NO_ERROR

Constant

`public static const NO_ERROR:String = "noError"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, 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_ERROR

Constant

`public static const NUMBER_OVERFLOW_ERROR:String = "numberOverflowError"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, AIR 2

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

### PARSE_ERROR

Constant

`public static const PARSE_ERROR:String = "parseError"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, 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_ERROR

Constant

`public static const PATTERN_SYNTAX_ERROR:String = "patternSyntaxError"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, 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:

Copy

            var df:DateTimeFormatter = new DateTimeFormatter("en-US");
            df.setDateTimePattern("xx");
            trace(df.lastOperationStatus); // "patternSyntaxError"

### PLATFORM_API_FAILED

Constant

`public static const PLATFORM_API_FAILED:String = "platformAPIFailed"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, AIR 2

Indicates that an underlying platform API failed for an operation.

### TRUNCATED_CHAR_FOUND

Constant

`public static const TRUNCATED_CHAR_FOUND:String = "truncatedCharFound"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, AIR 2

Indicates that a truncated Unicode character value was found.

### UNEXPECTED_TOKEN

Constant

`public static const UNEXPECTED_TOKEN:String = "unexpectedToken"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, 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.

Copy

            var locale:LocaleID = new LocaleID("en-US@Collation");
            var kav:Object = locale.getKeysAndValues();
            trace(locale.lastOperationStatus); // "unexpectedToken"

### UNSUPPORTED_ERROR

Constant

`public static const UNSUPPORTED_ERROR:String = "unsupportedError"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, 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_WARNING

Constant

`public static const USING_DEFAULT_WARNING:String = "usingDefaultWarning"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, AIR 2

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

### USING_FALLBACK_WARNING

Constant

`public static const USING_FALLBACK_WARNING:String = "usingFallbackWarning"`

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 10.1, 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`.

© 2015 Adobe Systems Incorporated. All rights reserved.
Mon Apr 10 2017, 12:28 PM -07:00