Adobe® Flex® 4 Language Reference
Show Packages and Classes List |  Packages  |  Classes  |  Index  |  Appendixes
flash.globalization 
LastOperationStatus 
Packageflash.globalization
Classpublic final class LastOperationStatus
InheritanceLastOperationStatus Inheritance 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
 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_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;".

        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.

        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:

        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.

        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.