Referencia de ActionScript® 3.0 para la plataforma de Adobe® Flash®
Inicio  |  Ocultar lista de paquetes y clases |  Paquetes  |  Clases  |  Novedades  |  Índice  |  Apéndices  |  ¿Por qué hay texto en inglés?
Filtros: AIR 30.0 y versiones anteriores, Flash Player 30.0 y versiones anteriores, Flash Lite 4
Flex 4.6 y versiones anteriores, Flash Pro CS6 y versiones anteriores
Ocultar filtros
flash.globalization 

Collator  - AS3

Paquetesx

Nivel superior
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Elementos del lenguaje

Constantes globales
Funciones globales
Operadores
Sentencias, palabras clave y directivas
Tipos especiales

Apéndices

Novedades
Errores del compilador
Advertencias del compilador
Errores en tiempo de ejecución
Migración a ActionScript 3
Conjuntos de caracteres admitidos
Solo etiquetas MXML
Elementos Motion XML
Etiquetas de texto temporizado
Lista de elementos desfasados
Constantes de implementación de accesibilidad
Cómo utilizar ejemplos de ActionScript
Avisos legales
Paqueteflash.globalization
Clasepublic final class Collator
HerenciaCollator Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

La clase Collator proporciona funcionalidades de comparación de cadenas que distinguen entre mayúsculas y minúsculas.

Esta clase utiliza los servicios de comprarción de cadenas proporcionados por el sistema operativo. Las comparaciones difieren según el identificador de configuración regional que se proporciona cuando se crea la instancia de la clase. ActionScript almacena las cadenas utilizando el conjunto de caracteres Unicode. Los operadores de comprarción de cadenas Boolean (==, !=, >, <, <=, >=) utilizan puntos de código Unicode para la comparación. En la mayoría de los casos el orden de clasificación resultante no coincide con las convenciones de un idioma y región concretos, por lo que no se debe utilizar para ordenar cadenas que se presentan en una interfaz de usuario. Por el contrario, los métodos de comparación de esta clase proporcionan un orden que se ajusta a estas convenciones.

A continuación se presentan algunos ejemplos donde el orden de clasificación varía en función del idioma:

  • En inglés, la a minúscula va antes de la A mayúscula y la A mayúscula está antes de la b minúscula
  • La ö va detrás de la z en sueco, mientras que en alemán, la ö va detrás de la o
  • la ch se ordena como un solo carácter entre la c y la d en español tradicional

Los órdenes de clasificación pueden variar incluso dentro del mismo idioma y región en función del uso. Por ejemplo, en alemán hay un orden de clasificación distinto para los nombres en agendas telefónicas frente a las mismas palabras en un diccionario. En chino y el japonés existen distintas formas de ordenar los caracteres ideográficos: por pronunciación o por radical geográfico y número de trazos en un glifo. En español y en georgiano se establecen diferencias entre la ordenación moderna y tradicional.

Los métodos de comparación de la clase principal proporcionan dos modos de uso. El parámetro initialMode del constructor Collator() controla estos modos. El modo predeterminado de “ordenación” sirve para ordenar los elementos que se van a mostrar al usuario final. En este modo, la comparación es más estricta para garantizar que los elementos que de otro modo serían iguales, se ordenen de forma coherente. Por ejemplo, las letras mayúsculas y minúsculas no se comparan como iguales. En el modo “coincidente”, la comparación es más suave. Por ejemplo, en este modo las mayúsculas y minúsculas se tratan de la misma forma. A continuación se incluye un ejemplo que muestra ambos modos:

 
     var sortingCollator:Collator = new Collator("en-US", CollatorMode.SORTING);
     var words:Array = new  Array("Airplane" , "airplane", "boat", "Boat");
     words.sort(sortingCollator.compare);
     trace(words);
              
     var matchingCollator:Collator = new Collator("en-US", CollatorMode.MATCHING);
     if (matchingCollator.equals("Car", "car")) {
       trace("The words match!");
     }
     

Incluso cuando se proporciona un parámetro de ID de configuración regional al constructor, tal como se puede ver arriba, el comportamiento de recopilación puede variar en función del usuario dependiendo de la configuración de su sistema operativo y de si existe una configuración regional de repuesto para utilizar cuando la configuración regional requerida no se admita.

Ver los ejemplos



Propiedades públicas
 PropiedadDefinido por
  actualLocaleIDName : String
[solo lectura] El nombre del ID real de configuración regional utilizado por este objeto Collator.
Collator
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  ignoreCase : Boolean
Cuando esta propiedad se establece en true, las cadenas idénticas y las que difieren únicamente en la caja de las letras se evalúan como iguales.
Collator
  ignoreCharacterWidth : Boolean
Cuando la propiedad es true, las formas de ancho completo y de medio ancho de algunos caracteres chinos y japoneses se evalúan como iguales.
Collator
  ignoreDiacritics : Boolean
Cuando esta propiedad se establece en true, las cadenas que utilizan los mismos caracteres base pero diferentes acentos u otras marcas diacríticas se evalúan como iguales.
Collator
  ignoreKanaType : Boolean
Cuando esta propiedad se establece en true, las cadenas que se van a utilizar y que difieren únicamente en el tipo de carácter kana se tratan como iguales.
Collator
  ignoreSymbols : Boolean
Cuando esta propiedad se establece en true, los caracteres de símbolo como, por ejemplo, espacios, símbolos de divisa, símbolos matemáticos y otros tipos de símbolos, se omitirán en la ordenación.
Collator
  lastOperationStatus : String
[solo lectura] El estado de la última operación que este objeto Collator ha realizado.
Collator
  numericComparison : Boolean
Controla cómo se gestionan los valores numéricos incorporados en cadenas durante la comparación de cadenas.
Collator
  requestedLocaleIDName : String
[solo lectura] El nombre del ID de configuración regional requerido que se transfirió al constructor de este objeto Collator.
Collator
Métodos públicos
 MétodoDefinido por
  
Collator(requestedLocaleIDName:String, initialMode:String = "sorting")
Construye un nuevo objeto Collator para proporcionar comparaciones según las convenciones de una configuración regional específica.
Collator
  
compare(string1:String, string2:String):int
Compara dos cadenas y devuelve un valor entero que indica si la primera cadena es menor, igual o mayor que la segunda cadena.
Collator
  
equals(string1:String, string2:String):Boolean
Compara dos cadenas y devuelve un valor booleano que indica si las cadenas son iguales.
Collator
  
[estática] Muestra una lista de todos los nombres de ID de configuración regional admitidos por esta clase.
Collator
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Información sobre propiedades

actualLocaleIDName

propiedad
actualLocaleIDName:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

El nombre del ID real de configuración regional utilizado por este objeto Collator.

Existen tres posibilidades para el valor del nombre, en función del sistema operativo y del valor del parámetro requestedLocaleIDName transferido al constructor Collator().

  1. Si la configuración regional requerida no era LocaleID.DEFAULT y el sistema operativo admite la configuración regional requerida, el nombre devuelto es el mismo que la propiedad requestedLocaleIDName.
  2. Si LocaleID.DEFAULT se ha utilizado como el valor del parámetro requestedLocaleIDName en el constructor, se utiliza el nombre de la configuración regional actual especificado por el sistema operativo del usuario. El valor de LocaleID.DEFAULT conserva la configuración personalizada del usuario en el sistema operativo. Transferir un valor explícito como el parámetro requestedLocaleIDName no necesariamente produce el mismo resultado que utilizar LocaleID.DEFAULT incluso si los dos ID de configuración regional son los mismos. El usuario podría haber personalizado los ajustes de la configuración regional de su equipo y, al solicitar un nombre ID de configuración regional explícito en lugar de utilizar LocaleID.DEFAULT, la aplicación no recuperaría dichos ajustes personalizados.
  3. Si el sistema no admite el nombre de requestedLocaleIDName especificado en el constructor, se proporciona un nombre de ID de configuración regional de repuesto.



Implementación
    public function get actualLocaleIDName():String

Elementos de API relacionados

ignoreCase

propiedad 
ignoreCase:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Cuando esta propiedad se establece en true, las cadenas idénticas y las que difieren únicamente en la caja de las letras se evalúan como iguales. Por ejemplo, compare("ABC", "abc") devuelve true si la propiedad ignoreCase se establece en true.

La conversión de la caja de la cadena sigue las reglas de la configuración regional especificada.

Si la propiedad ignoreCase es false, los caracteres en mayúscula y minúscula no se consideran iguales entre sí.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es true si el parámetro initialMode del constructor Collator() se establece en Collator.MATCHING. El valor predeterminado es false si el parámetro initialMode del constructor Collator() se establece en Collator.SORTING.



Implementación
    public function get ignoreCase():Boolean
    public function set ignoreCase(value:Boolean):void

Elementos de API relacionados

ignoreCharacterWidth

propiedad 
ignoreCharacterWidth:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Cuando la propiedad es true, las formas de ancho completo y de medio ancho de algunos caracteres chinos y japoneses se evalúan como iguales.

Para asegurar la compatibilidad con las normas existentes para los conjuntos de caracteres de chino y de japonés, Unicode proporciona códigos de caracteres tanto para ancho completo como para medio ancho en algunos caracteres. Por ejemplo, cuando la propiedad ignoreCharacterWidth se establece en true, compare("Aア", "Aア") devuelve true.

Si la propiedad ignoreCharacterWidth se establece en false, las formas de ancho completo y de medio ancho no se consideran iguales entre sí.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es false.



Implementación
    public function get ignoreCharacterWidth():Boolean
    public function set ignoreCharacterWidth(value:Boolean):void

Elementos de API relacionados

ignoreDiacritics

propiedad 
ignoreDiacritics:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Cuando esta propiedad se establece en true, las cadenas que utilizan los mismos caracteres base pero diferentes acentos u otras marcas diacríticas se evalúan como iguales. Por ejemplo, compare("coté", "côte") devuelve true si la propiedad ignoreDiacritics se establece en true.

Cuando ignoreDiacritics se establece en false, los caracteres base con marcas diacríticas o con acentos no se consideran iguales entre sí.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es false.



Implementación
    public function get ignoreDiacritics():Boolean
    public function set ignoreDiacritics(value:Boolean):void

Elementos de API relacionados

ignoreKanaType

propiedad 
ignoreKanaType:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Cuando esta propiedad se establece en true, las cadenas que se van a utilizar y que difieren únicamente en el tipo de carácter kana se tratan como iguales. Por ejemplo, compare("カナ", "かな") devuelve true si la propiedad ignoreKanaType se establece en true.

Si ignoreKanaType se establece en false, los caracteres hiragana y katakana que hacen referencia a la misma sílaba no se consideran iguales entre sí.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es false.



Implementación
    public function get ignoreKanaType():Boolean
    public function set ignoreKanaType(value:Boolean):void

Elementos de API relacionados

ignoreSymbols

propiedad 
ignoreSymbols:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Cuando esta propiedad se establece en true, los caracteres de símbolo como, por ejemplo, espacios, símbolos de divisa, símbolos matemáticos y otros tipos de símbolos, se omitirán en la ordenación. Por ejemplo, las cadenas "OBrian", "O'Brian" y "O Brian" se tratarán todas como iguales si la propiedad ignoreSymbols se establece en true.

Si la propiedad ignoreSymbols es false, los caracteres de símbolo se tienen en cuenta en las comparaciones de cadena.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es false.



Implementación
    public function get ignoreSymbols():Boolean
    public function set ignoreSymbols(value:Boolean):void

Elementos de API relacionados

lastOperationStatus

propiedad 
lastOperationStatus:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

El estado de la última operación que este objeto Collator ha realizado. lastOperationStatus se establece siempre que se llame al constructor o a un método de esta clase, o si se establece otra propiedad. Para conocer los valores posibles, consulte la descripción de cada método.



Implementación
    public function get lastOperationStatus():String

Elementos de API relacionados

numericComparison

propiedad 
numericComparison:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Controla cómo se gestionan los valores numéricos incorporados en cadenas durante la comparación de cadenas.

Cuando la propiedad numericComparison se establece en true, el método compare convierte los números que aparecen en las cadenas en valores numéricos para la comparación.

Cuando esta propiedad se establece en false, la comparación trata los números como códigos de caracteres y los ordenará conforme a las reglas para la ordenación de caracteres de la configuración regional especificada.

Por ejemplo, cuando esta propiedad es "true" para el ID de configuración regional "en-US", las cadenas "version1", "version10" y "version2" se ordenan del modo siguiente: version1 < version2 < version10.

Si esta propiedad es false para "en-US", esas mismas cadenas se ordenan del modo siguiente: version1 < version10 < version2.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es false.



Implementación
    public function get numericComparison():Boolean
    public function set numericComparison(value:Boolean):void

Elementos de API relacionados

requestedLocaleIDName

propiedad 
requestedLocaleIDName:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

El nombre del ID de configuración regional requerido que se transfirió al constructor de este objeto Collator.

Si se ha utilizado el valor LocaleID.DEFAULT, el nombre devuelto es "i-default". La configuración regional real que se utiliza puede ser diferente de la configuración regional requerida cuando cuando se aplica una configuración regional de repuesto. El nombre de la configuración regional real se puede recuperar usando la propiedad actualLocaleIDName.



Implementación
    public function get requestedLocaleIDName():String

Elementos de API relacionados

Información sobre constructores

Collator

()Información sobre
public function Collator(requestedLocaleIDName:String, initialMode:String = "sorting")

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Construye un nuevo objeto Collator para proporcionar comparaciones según las convenciones de una configuración regional específica.

Si el sistema operativo actual no admite el ID de configuración regional transferido en el parámetro requestedLocaleIDName, se determina una configuración regional del repuesto. Si se utiliza un repuesto, la propiedad lastOperationStatus se establece para indicar el tipo de repuesto.

El parámetro initialMode establece diversas opciones para usos generales. Se puede establecer en cualquiera de los valores siguientes:

  • CollatorMode.SORTING: establece opciones de recopilación para usos generales de ordenación lingüística, como ordenar una lista de cadenas de texto que se muestre al usuario final. En este modo, las diferencias entre mayúsculas y minúsculas, caracteres acentuados y otras diferencias específicas de la configuración regional se tienen en cuenta al llevar a cabo comparaciones de cadena.
  • CollatorMode.MATCHING: establece opciones de recopilación para usos generales, como determinar si dos cadenas son equivalentes. En este modo, las diferencias entre mayúsculas y minúsculas, caracteres acentuados, etc., se omiten cuando lleve a cabo comparaciones de cadena.

A continuación, se muestra un ejemplo de lista ordenada creada mediante un objeto Collator con el ID de configuración regional "en-US" (inglés de Estados Unidos) y la opción CollatorMode.SORTING:

AaÄäAaAEAEÆæBbBbCcçCc

Tal y como se muestra arriba, todos los caracteres se tratan como si tuvieran valores distintos, pero en orden lingüístico.

A continuación, se muestra un ejemplo de lista ordenada creada mediante un objeto Collator con el ID de configuración regional "en-US" (inglés de Estados Unidos) y la opción CollatorMode.MATCHING:

A a Ä ä A aAE ae Æ æB b B bC c ç C c

Tal y como se puede ver arriba, algunos caracteres están en orden lingüístico y se tratan como si tuvieran el mismo valor de carácter.

Para obtener un control mayor de ordenación, puede cambiar propiedades collator como Collator.ignoreCase o Collator.ignoreDiacritics.

A modo de referencia, a continuación se incluye un ejemplo de ordenación correspondiente con el método estándar Array.sort(), que no detecta la configuración regional:

AAEBCaAEbcÄÆäæçABab

Como puede ver arriba, todos los caracteres se ordenan simplemente según el valor numérico Unicode. No tiene mucho sentido desde un punto de vista lingüístico.

Para utilizar las preferencias del sistema operativo actuales del usuario, transfiera el valor estático LocaleID.DEFAULT del parámetro requestedLocaleIDName al constructor.

Algunas configuraciones regionales tienen variantes de orden de clasificación. Por ejemplo, en alemán se utiliza un orden de clasificación para agendas de teléfonos y otro orden para diccionarios. En chino, las palabras suelen admitirse por transliteración de los caracteres en el pinyin. Estos órdenes de clasificación distintos se pueden seleccionar incluyendo la palabra clave "collation" de la cadena que se transfiere en el parámetro requestedLocaleIDName al constructor.

         var germanPhonebook:LocaleID = new LocaleID("de-DE@collation=phonebook");
         var chinesePinyin:LocaleID = new LocaleID("zh-Hant@collation=pinyin");
         

Los valores posibles de la cadena Collation son los siguientes, con los idiomas afectados entre paréntesis:

Cadena CollationDescripciónstandardOrdenación predeterminada para cada idioma. agendaPara una ordenación al estilo de agenda telefónica (utilizada en alemán).pinyinOrdenación pinyin para caracteres latinos y CJK; es decir, una ordenación para caracteres CJK basada en una transliteración carácter a carácter en un pinyin. (utilizada en chino)tradicionalPara una ordenación al estilo tradicional (utilizada en español) strokeOrdenación pinyin para trazos latinos en caracteres CJK (utilizada en chino)direct(utilizada en hindi) big5hanOrdenación pinyin para conjuntos de caracteres latinos y big5 en caracteres CJK. (utilizada en chino) gb2312han Ordenación pinyin para conjuntos de caracteres latinos y gb2312han en caracteres CJK. (utilizada en chino) unihanOrdenación pinyin para trazos de radicales latinos y Unihan en caracteres CJK. (utilizada en chino)

Si la plataforma host no admite el tipo de recopilación requerido, se utiliza una de repuesto y la propiedad lastOperationStatus se establece para indicar que se ha seleccionado una recopilación de repuesto. Puede utilizar la propiedad actualLocaleIDName para determinar el valor que se utilizó como repuesto, tal y como se muestra en el siguiente ejemplo:

         var collator:Collator = new Collator("fr-FR");
         if (collator.lastOperationStatus == LastOperationStatus.USING_FALLBACK_WARNING)
         {
           trace ("Using fallback locale: " + collator.actualLocaleIDName);
         }
         

Cuando el constructor se completa correctamente, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

Cuando nombre del ID de la configuración regional requerida no está disponible, la propiedad lastOperationStatus se establece en uno de los valores siguientes:

  • LastOperationStatus.USING_FALLBACK_WARNING
  • LastOperationStatus.USING_DEFAULT_WARNING

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Para obtener información detallada sobre las advertencias que aparecen en la lista anterior y sobre otros valores posibles de lastOperationStatus, consulte las descripciones de la clase LastOperationStatus.

Parámetros
requestedLocaleIDName:StringCadena que va a usar este objeto Collator.
 
initialMode:String (default = "sorting") — Un valor de cadena que especifica el modo recopilación inicial. El valor predeterminado es CollatorMode.SORTING. Consulte la clase CollatorMode para ver una lista de modos disponibles.

Emite
TypeError — si el parámetro requestedLocaleIDName es null.
 
ArgumentError — cuando el parámetro requestedLocaleIDName contiene un valor no válido.

Elementos de API relacionados

Información sobre métodos

compare

()método
public function compare(string1:String, string2:String):int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Compara dos cadenas y devuelve un valor entero que indica si la primera cadena es menor, igual o mayor que la segunda cadena. La comparación utiliza las reglas de orden de clasificación para el ID de configuración regional especificado en el constructor Collator().

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Parámetros

string1:String — Primera cadena de comparación.
 
string2:String — Segunda cadena de comparación.

Valor devuelto
int — Un valor entero que indica si la primera cadena es menor, igual o mayor que la segunda cadena.
  • Si el valor devuelto es negativo, string1 es menor que string2.
  • Si el valor devuelto es igual a cero, string1 es igual a string2.
  • Si el valor devuelto es positivo, string1 es mayor que string2.

Emite
TypeError — cuando un parámetro necesario es null.
 
ArgumentError — cuando un parámetro contiene un valor no válido.

Elementos de API relacionados

equals

()método 
public function equals(string1:String, string2:String):Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Compara dos cadenas y devuelve un valor booleano que indica si las cadenas son iguales. La comparación utiliza las reglas de orden de clasificación para el ID de configuración regional especificado en el constructor Collator().

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

  • LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Parámetros

string1:String — Primera cadena de comparación.
 
string2:String — Segunda cadena de comparación.

Valor devuelto
Boolean — Un valor booleano que indica si las cadenas son iguales (true) o desiguales (false).

Emite
TypeError — cuando un parámetro necesario es null.
 
ArgumentError — cuando un parámetro contiene un valor no válido.

Elementos de API relacionados

getAvailableLocaleIDNames

()método 
public static function getAvailableLocaleIDNames():Vector.<String>

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10.1, AIR 2

Muestra una lista de todos los nombres de ID de configuración regional admitidos por esta clase.

Si esta clase no se admite en el sistema operativo actual, este método devuelve un valor null.

Valor devuelto
Vector.<String> — Un vector de cadenas que contiene todos los nombres de ID de configuración regional admitidos por esta clase.
CollatorExample1.as

En el ejemplo siguiente se muestran los resultados de ordenación que difieren según la configuración regional. El ejemplo lleva a cabo los siguientes pasos:
  1. Itera por un conjunto de nombres de ID de configuración regional, incluido el ID de configuración regional predeterminada para el sistema operativo (como se especifica en LocaleID.DEFAULT)
  2. Crea un objeto Collator para cada nombre de ID de configuración regional utilizando el modo de "ordenación" (configuración predeterminada).
  3. Muestra la configuración regional real y solicitada y los nombres de ID y el valor de la propiedad lastOperationStatus para que pueda ver si una se ha utilizado una configuración regional de repuesto.
  4. Ordena un conjunto de datos con dada objeto Collator y muestra los resultados. El orden resultante es diferente para cada configuración regional.
package {
    import flash.globalization.Collator;
    import flash.globalization.LocaleID;

    public class CollatorExample1
    {
        public var col:Collator;
        
        public function CollatorExample1():void
        {        
            var localeNames:Array = [LocaleID.DEFAULT,
                                     "de-DE", "sv-SE",
                                     "fr-FR", "lt-LT",
                                     "es-ES"];
            
            var testSortData:Array = [
                "y ", "i ", "k ", // Latvian
                "acxa ", "acha ", "adxa ", // es_traditional
                "n ", "ö ", "o ", "z ", "vu ", "wo ", // sw
                "däd ", "daed ", // de
                "öf ", "of ", // de_dictionary
                "côte ", "coté " // fr
            ];
            
            for each (var localeName:String in localeNames) {
            
                col = new Collator(localeName);
                
                trace("LocaleID requested: " + col.requestedLocaleIDName 
                       + "; actual: " + col.actualLocaleIDName);
                       
                trace("Last Operation Status: " + col.lastOperationStatus );
                
                var result:Array = testSortData.sort(col.compare);
                        
                trace ("sorted data: " + result); 
            }
        }      
    }
}
CollatorExample2.as

Los ejemplos siguientes muestran el uso del objeto Collator para controlar el comportamiento de comparaciones de cadenas. El ejemplo lleva a cabo los siguientes pasos:
  1. Crea un objeto Collator para la configuración regional predeterminada del usuario utilizando el modo "coincidente".
  2. También establece la propiedad Collator.ignoreDiacritics en false y true
  3. Compara conjuntos de cadenas que contienen signos diacríticos y caracteres en mayúscula y minúscula.
  4. Muestra cómo las comparaciones cambian cuando cambian las propiedades Collator.ignoreDiacritics y Collator.ignoreCase.
package {
    import flash.display.Sprite;
    import flash.globalization.Collator;
    import flash.globalization.CollatorMode;
    import flash.globalization.LocaleID;
    
    public class CollatorExample2 extends Sprite
    {
        public var col:Collator;
        public var testMatchData:Array = ["cote", "Cote", "côte", "coté"];
        public var wordToMatch:String = "Cote";
        
        public function CollatorExample2()
        {
            col = new Collator( LocaleID.DEFAULT, CollatorMode.MATCHING );

            trace("LocaleID requested: " + col.requestedLocaleIDName 
                    + "; actual: " + col.actualLocaleIDName);
                    
            trace("Last Operation Status: " + col.lastOperationStatus );

            trace('\n' + "ignoreCase = " + col.ignoreCase);
            trace("ignoreDiacritics = " + col.ignoreDiacritics);

            compareString(testMatchData, wordToMatch) // All variations of the word cote match

            col.ignoreDiacritics = false;
            trace('\n' + "ignoreDiacritics = false");

            compareString(testMatchData, wordToMatch) // Variations with different diacritics will not match

            col.ignoreCase = false;
            trace('\n' + "ignoreCase = false");

            compareString(testMatchData, wordToMatch) // Variations with different case will not match
        }
    
        private function compareString(stringArray:Array, keyword:String):void
        {
            for each(var s:String in stringArray)
            {
                if(col.equals(s, keyword))    
                {
                    trace(keyword + " = " + s);
                }
            }
        }
    }
}




[ X ]¿Por qué hay texto en inglés?
Cierto contenido de la Referencia de ActionScript 3.0 se muestra en inglés

No todo el contenido de la Referencia de ActionScript 3.0 se traduce a todos los idiomas. Si un elemento del lenguaje no se traduce, aparecerá en inglés. Por ejemplo, la clase ga.controls.HelpBox no está traducida en ningún idioma. Por lo tanto, en la versión en español de la referencia, la clase ga.controls.HelpBox aparecerá en inglés.