Adobe® Flash® Platform için ActionScript® 3.0 Başvurusu
Ana Sayfa  |  Paket ve Sınıf Listesini Gizle |  Paketler  |  Sınıflar  |  Yenilikler  |  Dizin  |  Ekler  |  Niçin İngilizce?
Filtreler: AIR 30.0 ve öncesi, Flash Player 30.0 ve öncesi, Flash Lite 4
Flex 4.6 ve öncesi, Flash Pro CS6 ve öncesi
Filtreleri Gizle
Üst Düzey 

Array  - AS3

Paketlerx

Üst Düzey
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

Dil Öğeleri

Global Sabitler
Global İşlevler
Operatörler
İfadeler, Anahtar Kelimeler ve Direktifler
Özel Türler

Ekler

Yenilikler
Derleyici Hataları
Derleyici Uyarıları
Çalışma Zamanı Hataları
ActionScript 3'e Geçiş Yapma
Desteklenen Karakter Kümeleri
Yalnızca MXML Etiketleri
Motion XML Öğeleri
Timed Text Etiketleri
Onaylanmamış öğelerin listesi
Erişilebilirlik Uygulaması Sabitleri
ActionScript Örnekleri Nasıl Kullanılır?
Yasal uyarılar
PaketÜst Düzey
Sınıfpublic dynamic class Array
Miras AlmaArray Inheritance Object

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Array sınıfı dizilere erişmenize ve bunları işlemenize izin verir. Dize dizinleri sıfır temellidir, başka bir deyişle, dizideki birinci öğe [0], ikinci öğe [1], vb.'dir. Bir Array nesnesi oluşturmak için, new Array() yapıcısı kullanılır. Array() bir işlev olarak da çağrılabilir. Ayrıca, bir diziyi başlatmak veya bir dizinin öğelerine erişmek için, dizi erişimi ([]) operatörünü de kullanabilirsiniz.

Sayı, dize, nesne ve diğer diziler dahil, bir dizi öğesinde çeşitli veri türlerini saklayabilirsiniz. Dizinli bir dizi oluşturup bu dizinin öğelerinin her birine farklı bir dizinli dizi atayarak multidimensional dizi oluşturabilirsiniz. Bu tür bir dizinin çok boyutlu olarak değerlendirilmesinin nedeni, bir tabloda verileri temsil etmek için kullanılabilmesidir.

Diziler seyrek dizilerdir, başka bir deyişle, 0 dizininde bir öğe ve 5 dizininde başka bir öğe olabilir ancak bu iki öğenin arasındaki dizin konumlarında herhangi bir şey yoktur. Bu tür bir durumda, 1 - 4 konumları arasındaki öğeler tanımsız olup mutlaka undefined değerine sahip bir öğenin varlığını değil, bir öğenin yokluğunu belirtir.

Dize ataması değere göre değil, başvuruya göredir. Bir dizi değişkenini başka bir dizi değişkenine atadığınızda, her ikisi de aynı diziye başvurur:

 var oneArray:Array = new Array("a", "b", "c");
 var twoArray:Array = oneArray; // Both array variables refer to the same array.
 twoArray[0] = "z";             
 trace(oneArray);               // Output: z,b,c.
 

Numaralı öğeler yerine adlandırılmış öğeleri içeren veri yapıları niteliğindeki ilişkilendirilebilir diziler (karma da denir) oluşturmak için Array sınıfını kullanmayın. İlişkilendirilebilir diziler oluşturmak için Object sınıfını kullanın. ActionScript, Array sınıfını kullanarak ilişkilendirilebilir diziler oluşturmanıza izin verse de, ilişkilendirilebilir dizilerle Array sınıfı yöntemlerini veya özelliklerini kullanamazsınız.

Array sınıfını genişletebilir ve yöntemleri geçersiz kılabilir veya ekleyebilirsiniz. Ancak, alt sınıfı dynamic olarak belirtmeniz gerekir, aksi takdirde bir diziye veri saklama yeteneğinizi kaybedersiniz.

Örnekleri görüntüle

İlgili API Öğeleri



Genel Özellikler
 ÖzellikTanımlayan:
 Inheritedconstructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.
Object
  length : uint
Dizideki öğe sayısını belirten, negatif olmayan bir tam sayı.
Array
Genel Yöntemler
 YöntemTanımlayan:
  
Array(... values)
Belirtilen öğeleri içeren bir dizi oluşturmanızı sağlar.
Array
  
Array(numElements:int = 0)
Belirtilen sayıda öğesi olan bir dizi oluşturmanızı sağlar.
Array
  
Parametrelerde belirtilen öğeleri bir dizideki öğelerle birleştirir ve yeni bir dizi oluşturur.
Array
  
every(callback:Function, thisObject:* = null):Boolean
Belirtilen işlev için false döndüren bir öğeye ulaşılıncaya kadar dizideki her öğede bir test işlevi çalıştırır.
Array
  
filter(callback:Function, thisObject:* = null):Array
Dizideki her öğede bir test işlevini çalıştırır ve belirtilen işlev için true döndüren tüm öğeler için yeni bir dizi oluşturur.
Array
  
forEach(callback:Function, thisObject:* = null):void
Bir işlevi dizideki her öğe üzerinde çalıştırır.
Array
 Inherited
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.
Object
  
indexOf(searchElement:*, fromIndex:int = 0):int
Bir dizide bir öğeyi katı eşitlik (===) kullanarak arar ve öğenin dizin konumunu döndürür.
Array
  
insertAt(index:int, element:*):void
Bir diziye tek bir öğe ekleyin.
Array
 Inherited
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.
Object
  
Dizideki öğeleri dizelere dönüştürür, öğeler arasına belirtilen ayırıcıları ekler, bunları birleştirir ve sonuç dizesini döndürür.
Array
  
lastIndexOf(searchElement:*, fromIndex:int = 0x7fffffff):int
Bir dizide bir öğeyi en son öğeden başlayarak geriye doğru arar ve katı eşitlik (===) kullanarak eşleşen öğenin dizin konumunu döndürür.
Array
  
map(callback:Function, thisObject:* = null):Array
Bir işlevi bir dizinin her öğesinde çalıştırır ve orijinal dizideki öğelerin her birindeki işlevin sonuçlarına karşılık gelen yeni bir öğe dizisi oluşturur.
Array
  
pop():*
Bir dizinin son öğesini kaldırır ve o öğenin değerini döndürür.
Array
 Inherited
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.
Object
  
push(... args):uint
Bir dizinin sonuna bir veya daha fazla öğe ekler ve dizinin yeni uzunluğunu döndürür.
Array
  
removeAt(index:int):*
Bir diziden tek bir öğe kaldırın.
Array
  
Diziyi yerinde ters çevirir.
Array
 Inherited
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.
Object
  
Bir dizinin ilk öğesini kaldırır ve o öğeyi döndürür.
Array
  
slice(startIndex:int = 0, endIndex:int = 16777215):Array
Orijinal diziyi değiştirmeden, orijinal dizideki öğelerin aralığını içeren yeni bir dizi döndürür.
Array
  
some(callback:Function, thisObject:* = null):Boolean
true döndüren bir öğeye ulaşılıncaya kadar dizideki her öğede bir test işlevi çalıştırır.
Array
  
sort(... args):Array
Bir dizideki öğeleri sıralar.
Array
  
sortOn(fieldName:Object, options:Object = null):Array
Bir dizideki öğeleri, dizideki bir veya daha fazla alana göre sıralar.
Array
  
splice(startIndex:int, deleteCount:uint, ... values):Array
Bir diziye öğe ekleyip diziden öğeyi kaldırır.
Array
  
Belirtilen dizideki öğeleri temsil eden bir dize döndürür.
Array
  
Belirtilen dizideki öğeleri temsil eden bir dize döndürür.
Array
  
Bir dizinin başına bir veya daha fazla öğe ekler ve dizinin yeni uzunluğunu döndürür.
Array
 Inherited
Belirtilen nesnenin temel değerini döndürür.
Object
Genel Sabitler
 SabitTanımlayan:
  CASEINSENSITIVE : uint = 1
[statik] Array sınıfı sıralama yöntemleri için büyük/küçük harf duyarsız sıralama belirtir.
Array
  DESCENDING : uint = 2
[statik] Array sınıfı sıralama yöntemleri için azalan sırada sıralama belirtir.
Array
  NUMERIC : uint = 16
[statik] Array sınıfı sıralama yöntemleri için sayısal (karakter dizesi yerine) sıralama belirtir.
Array
  RETURNINDEXEDARRAY : uint = 8
[statik] Bir sıralamanın dizi dizinlerinden oluşan bir dizi döndüreceğini belirtir.
Array
  UNIQUESORT : uint = 4
[statik] Array sınıfı sıralama yöntemleri için benzersiz sıralama gereksinimini belirtir.
Array
Özellik Ayrıntısı

length

özellik
length:uint

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Dizideki öğe sayısını belirten, negatif olmayan bir tam sayı. Diziye yeni öğeler eklendiğinde bu özellik otomatik olarak güncellenir. Bir dizi öğesine bir değer atadığınızda (örneğin, my_array[index] = value), index bir sayıysa ve index+1, length özelliğinden büyükse, length özelliği index+1 değerine güncellenir.

Not: length özelliğine varolan uzunluktan daha kısa bir değer atarsanız, dizi kesilir.



Uygulama
    public function get length():uint
    public function set length(value:uint):void

Örnek  ( Bu örnek nasıl kullanılır? )
Şu kod, Bill dize öğesini içeren bir names Array nesnesi oluşturur. Daha sonra bu başka bir Kyle dize öğesi eklemek için push() yöntemini kullanır. length özelliğinin belirlediği dizi uzunluğu, push() kullanılmadan önce bir öğe iken push() çağrıldıktan sonra iki öğedir. names uzunluğunu üç öğe haline getirmek için başka bir dize olan Jeff eklenir. Daha sonra Bill ve Kyle öğelerini kaldırmak için shift() yöntemi iki defa çağrılır, bu durumda length son dizisinin değeri bir olur.
var names:Array = new Array("Bill");
names.push("Kyle");
trace(names.length); // 2

names.push("Jeff");
trace(names.length); // 3

names.shift();
names.shift();
trace(names.length); // 1
Yapıcı Ayrıntı

Array

()Yapıcı
public function Array(... values)

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Belirtilen öğeleri içeren bir dizi oluşturmanızı sağlar. Herhangi türde veri belirtebilirsiniz. Dizideki birinci öğenin her zaman bir 0 dizini (veya konumu) vardır.

Not: Yapıcı, değişken argüman türlerini kabul ettiğinden, bu sınıf iki yapıcı girişini gösterir. İletilen argümanların türüne ve sayısına bağlı olarak yapıcı farklı davranır (her giriş için ayrıntılı olarak belirtilmiştir). ActionScript 3.0, yöntem veya yapıcı aşırı yüklemesini desteklemez.

Parametreler
... values — Bir veya daha fazla rastgele değerin virgüllerle ayrıldığı bir liste.

Not: Array yapıcısına yalnızca tek bir sayısal parametre iletilirse, bunun dizinin length özelliğini belirttiği varsayılır.


Atar
RangeError — Argüman, 0'dan büyük veya 0'a eşit bir tam sayı olmayan sayıdır.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Aşağıdaki örnek, 3 başlangıç uzunluğunda yeni bir Array nesnesi oluşturur, diziye one, two ve three dize öğelerini toplar ve ardından öğeleri bir dizeye dönüştürür.
package {
    import flash.display.Sprite;

    public class Array_Array_3 extends Sprite {

        public function Array_Array_3() {
            var myArr:Array = new Array("one", "two", "three");
            trace(myArr.length); // 3
            trace(myArr);          // one,two,three
        }
    }
}

Array

()Yapıcı 
public function Array(numElements:int = 0)

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Belirtilen sayıda öğesi olan bir dizi oluşturmanızı sağlar. Herhangi bir parametre belirtmezseniz, 0 öğe içeren bir dizi oluşturulur. Bir öğe sayısı belirtirseniz, numElements öğe içeren bir dizi oluşturulur.

Not: Yapıcı, çeşitli argüman türlerini kabul ettiğinden, bu sınıf iki constructor yöntemi girişini gösterir. İletilen argümanların türüne ve sayısına bağlı olarak yapıcı farklı davranır (her giriş için ayrıntılı olarak belirtilmiştir). ActionScript 3.0, yöntem veya yapıcı aşırı yüklemesini desteklemez.

Parametreler
numElements:int (default = 0) — Dizideki öğe sayısını belirten bir tam sayı.

Atar
RangeError — Argüman, 0'dan büyük veya 0'a eşit bir tam sayı olmayan sayıdır.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek, herhangi bir argüman ve 0 başlangıç uzunluğu olmadan myArr Array nesnesini oluşturur:
package {
    import flash.display.Sprite;

    public class Array_Array extends Sprite {

        public function Array_Array() {
            var myArr:Array = new Array();
            trace(myArr.length); // 0
        }
    }
}

Şu örnek, 5 uzunluğunda 5 başlangıç öğesi olan bir Array nesnesi oluşturur ve birinci öğeyi "one" dizesiyle doldurur ve push() yöntemini kullanarak dizinin sonuna "six" dize öğesini ekler:
package {
    import flash.display.Sprite;

    public class Array_Array_2 extends Sprite {

        public function Array_Array_2() {
            var myArr:Array = new Array(5);
            trace(myArr.length); // 5
            myArr[0] = "one";
            myArr.push("six");
            trace(myArr);         // one,,,,,six
            trace(myArr.length); // 6
        }
    }
}
Yöntem Ayrıntısı

concat

()yöntem
AS3 function concat(... args):Array

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Parametrelerde belirtilen öğeleri bir dizideki öğelerle birleştirir ve yeni bir dizi oluşturur. Parametreler bir dizi belirtirse, o dizinin öğeleri birleştirilir. Herhangi bir parametre iletmezseniz, yeni dizi orijinal dizinin aynısıdır (sığ klon).

Parametreler

... args — Yeni bir dizide birleştirilecek herhangi bir veri türünün (örn. sayı, öğe veya dize) değeri.

Döndürür
Array — Ardından parametrelerin öğeleri gelecek şekilde bu dizideki öğeleri içeren bir dizi.

Örnek  ( Bu örnek nasıl kullanılır? )

Şu kod dört Array nesnesi oluşturur:
  • 1, 2 ve 3 sayılarını içeren numbers dizisi.
  • a, b ve c harflerini içeren letters dizisi.
  • [1,2,3,a,b,c] dizisini üretmek için concat() yöntemini çağıran numbersAndLetters dizisi.
  • [a,b,c,1,2,3] dizisini üretmek için concat() yöntemini çağıran lettersAndNumbers dizisi.
var numbers:Array = new Array(1, 2, 3);
var letters:Array = new Array("a", "b", "c");
var numbersAndLetters:Array = numbers.concat(letters);
var lettersAndNumbers:Array = letters.concat(numbers);

trace(numbers);       // 1,2,3
trace(letters);       // a,b,c
trace(numbersAndLetters); // 1,2,3,a,b,c
trace(lettersAndNumbers); // a,b,c,1,2,3

every

()yöntem 
AS3 function every(callback:Function, thisObject:* = null):Boolean

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Belirtilen işlev için false döndüren bir öğeye ulaşılıncaya kadar dizideki her öğede bir test işlevi çalıştırır. Bir dizideki tüm öğelerin belirli bir sayıdan daha az değere sahip olma gibi bir ölçütü karşılayıp karşılamadığını belirlemek için bu yöntem kullanılır.

Birinci parametre (callback) bir yöntem kapanışıysa, bu yöntem için ikinci parametrenin (thisObject) null olması gerekir. me adlı film klibinizde bir işlev oluşturduğunuzu varsayın:

     function myFunction(obj:Object):void {
        //your code here
     }
     

Daha sonra da myArray adındaki bir dizide every() yöntemini kullanacağınızı varsayın:

     myArray.every(myFunction, me);
     

myFunction, me tarafından geçersiz kılınamayan Timeline sınıfının bir üyesi olduğundan, Flash çalışma zamanı bir istisna atar. Şu şekilde işlevi bir değişkene atayarak bu zaman aşımı hatasını önleyebilirsiniz:

     var myFunction:Function = function(obj:Object):void {
         //your code here
     };
     myArray.every(myFunction, me);
     

Parametreler

callback:Function — Dizideki her öğe üzerinde çalışma işlevi. Bu işlev basit bir karşılaştırma (örneğin, item < 20) veya daha karmaşık bir işlem içerebilir ve üç argümanla çağrılır; öğenin değeri, öğenin dizini ve Array nesnesi:
function callback(item:*, index:int, array:Array):Boolean;
 
thisObject:* (default = null) — İşlev için this olarak kullanılacak bir nesne.

Döndürür
Boolean — Belirtilen işlev için dizideki tüm öğeler true değerini getirirse, Boolean değeri true; aksi takdirde, false.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek, her dizideki öğelerin her birinin bir sayı olup olmadığını belirlemek için iki diziyi test eder. Bu ayrıca test sonuçlarının çıktısını vererek isNumeric öğesinin birinci dizi için true ve ikinci dizi için false olduğunu gösterir:
package {
    import flash.display.Sprite;
    public class Array_every extends Sprite {
        public function Array_every() {
            var arr1:Array = new Array(1, 2, 4);
            var res1:Boolean = arr1.every(isNumeric);
            trace("isNumeric:", res1); // true
 
            var arr2:Array = new Array(1, 2, "ham");
            var res2:Boolean = arr2.every(isNumeric);
            trace("isNumeric:", res2); // false
        }
        private function isNumeric(element:*, index:int, arr:Array):Boolean {
            return (element is Number);
        }
    }
}

filter

()yöntem 
AS3 function filter(callback:Function, thisObject:* = null):Array

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Dizideki her öğede bir test işlevini çalıştırır ve belirtilen işlev için true döndüren tüm öğeler için yeni bir dizi oluşturur. Bir öğe false döndürürse, yeni diziye dahil edilmez.

Birinci parametre (callback) bir yöntem kapanışıysa, bu yöntem için ikinci parametrenin (thisObject) null olması gerekir. me adlı film klibinizde bir işlev oluşturduğunuzu varsayın:

     function myFunction(obj:Object):void {
        //your code here
     }
     

Daha sonra da myArray adındaki bir dizide filter() yöntemini kullanacağınızı varsayın:

 
     myArray.filter(myFunction, me);
     

myFunction, me tarafından geçersiz kılınamayan Timeline sınıfının bir üyesi olduğundan, Flash çalışma zamanı bir istisna atar. Şu şekilde işlevi bir değişkene atayarak bu zaman aşımı hatasını önleyebilirsiniz:

     var myFunction:Function = function(obj:Object):void {
         //your code here
         };
     myArray.filter(myFunction, me);
     

Parametreler

callback:Function — Dizideki her öğe üzerinde çalışma işlevi. Bu işlev basit bir karşılaştırma (örneğin, item < 20) veya daha karmaşık bir işlem içerebilir ve üç argümanla çağrılır; öğenin değeri, öğenin dizini ve Array nesnesi:
    function callback(item:*, index:int, array:Array):Boolean;
 
thisObject:* (default = null) — İşlev için this olarak kullanılacak bir nesne.

Döndürür
Array — Orijinal dizideki true döndüren tüm öğeleri içeren yeni bir dizi.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek, yönetici olan tüm çalışanların bir dizisini oluşturur:
package {
    import flash.display.Sprite;
    public class Array_filter extends Sprite {
        public function Array_filter() {
            var employees:Array = new Array();
            employees.push({name:"Employee 1", manager:false});
            employees.push({name:"Employee 2", manager:true});
            employees.push({name:"Employee 3", manager:false});
            trace("Employees:");
            employees.forEach(traceEmployee);
            
            var managers:Array = employees.filter(isManager);
            trace("Managers:");
            managers.forEach(traceEmployee);
        }
        private function isManager(element:*, index:int, arr:Array):Boolean {
            return (element.manager == true);
        }
        private function traceEmployee(element:*, index:int, arr:Array):void {
            trace("\t" + element.name + ((element.manager) ? " (manager)" : ""));
        }
    }
}

forEach

()yöntem 
AS3 function forEach(callback:Function, thisObject:* = null):void

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir işlevi dizideki her öğe üzerinde çalıştırır.

Birinci parametre (callback) bir yöntem kapanışıysa, bu yöntem için ikinci parametrenin (thisObject) null olması gerekir. me adlı film klibinizde bir işlev oluşturduğunuzu varsayın:

     function myFunction(obj:Object):void {
        //your code here
     }
     

Daha sonra da myArray adındaki bir dizide forEach() yöntemini kullanacağınızı varsayın:

     myArray.forEach(myFunction, me);
     

myFunction, me tarafından geçersiz kılınamayan Timeline sınıfının bir üyesi olduğundan, Flash çalışma zamanı bir istisna atar. Şu şekilde işlevi bir değişkene atayarak bu zaman aşımı hatasını önleyebilirsiniz:

     var myFunction:Function = function(obj:Object):void {
         //your code here
         };
     myArray.forEach(myFunction, me);
     

Parametreler

callback:Function — Dizideki her öğe üzerinde çalışma işlevi. Bu işlev basit bir komut (örneğin, trace() ifadesi) veya daha karmaşık bir işlem içerebilir ve üç argümanla çağrılır; öğenin değeri, öğenin dizini ve Array nesnesi:
    function callback(item:*, index:int, array:Array):void;
 
thisObject:* (default = null) — İşlev için this olarak kullanılacak bir nesne.


Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek, dizide bulunan her öğedeki traceEmployee() işlevinde trace() ifadesini çalıştırır:
package {
    import flash.display.Sprite;
    public class Array_forEach extends Sprite {
        public function Array_forEach() {
            var employees:Array = new Array();
            employees.push({name:"Employee 1", manager:false});
            employees.push({name:"Employee 2", manager:true});
            employees.push({name:"Employee 3", manager:false});
            trace(employees);
            employees.forEach(traceEmployee);
        }
        private function traceEmployee(element:*, index:int, arr:Array):void {
            trace(element.name + " (" + element.manager + ")");
        }
    }
}

Şu örnek de, dizide bulunan her öğedeki biraz değişmiş traceEmployee() işlevinde trace() ifadesini çalıştırır:
package {
    import flash.display.Sprite;
    public class Array_forEach_2 extends Sprite {
        public function Array_forEach_2() {
            var employeeXML:XML = <employees>
                    <employee name="Steven" manager="false" />
                    <employee name="Bruce" manager="true" />
                    <employee name="Rob" manager="false" />
                </employees>;
            var employeesList:XMLList = employeeXML.employee;
            var employeesArray:Array = new Array();
            for each (var tempXML:XML in employeesList) {
                employeesArray.push(tempXML);
            }
            employeesArray.sortOn("@name");
            employeesArray.forEach(traceEmployee);
        }
        private function traceEmployee(element:*, index:Number, arr:Array):void {
            trace(element.@name + ((element.@manager == "true") ? " (manager)" : ""));
        }
    }
}

indexOf

()yöntem 
AS3 function indexOf(searchElement:*, fromIndex:int = 0):int

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir dizide bir öğeyi katı eşitlik (===) kullanarak arar ve öğenin dizin konumunu döndürür.

Parametreler

searchElement:* — Dizide bulunacak öğe.
 
fromIndex:int (default = 0) — Dizide, öğenin aranmaya başlanacağı konum.

Döndürür
int — Dizideki öğenin sıfır temellidizin konumu. searchElement argümanı bulunmazsa, dönüş değeri -1'dir.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek, belirtilen dizinin konumunu görüntüler:
package {
    import flash.display.Sprite;
    public class Array_indexOf extends Sprite {
        public function Array_indexOf() {
            var arr:Array = new Array(123,45,6789);
            arr.push("123-45-6789");
            arr.push("987-65-4321");
            
            var index:int = arr.indexOf("123");
            trace(index); // -1
            
            var index2:int = arr.indexOf(123);
            trace(index2); // 0
        }
    }
}

insertAt

()yöntem 
AS3 function insertAt(index:int, element:*):void

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: Flash Player 19, AIR 19

Bir diziye tek bir öğe ekleyin. Bu yöntem, kopya oluşturmadan diziyi değiştirir.

Parametreler

index:int — Öğenin ekleneceği dizindeki konumu belirten bir tamsayı. Dizinin sonuna göre bir konum belirtmek için negatif bir tam sayı kullanabilirsiniz (örneğin, dizinin son öğesi -1'dir).
 
element:*

join

()yöntem 
AS3 function join(sep:*):String

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Dizideki öğeleri dizelere dönüştürür, öğeler arasına belirtilen ayırıcıları ekler, bunları birleştirir ve sonuç dizesini döndürür. Yuvalanmış bir dizi, join() yöntemine iletilen ayırıcı ile değil, her zaman virgülle (,) ayrılır.

Parametreler

sep:* (default = NaN) — Döndürülen dizede dizi öğelerini ayıran bir karakter veya dize. Bu parametreyi atlarsanız, varsayılan ayırıcı olarak virgül kullanılır.

Döndürür
String — Dizelere dönüştürülmüş ve belirtilen parametre ile ayrılmış bir dizin öğelerinden oluşan dize.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu kod, one, two ve three öğelerini içeren bir myArr Array nesnesini ve join() yöntemini kullanarak one and two and three içeren bir dize oluşturur.
var myArr:Array = new Array("one", "two", "three");
var myStr:String = myArr.join(" and ");
trace(myArr); // one,two,three
trace(myStr); // one and two and three

Şu kod, (, ), - öğelerini ve bir boşluğu içeren specialChars Array nesnesini ve (888) 867-5309 içeren bir dize oluşturur. Daha sonra for döngüsünü kullanarak, yalnızca kalan telefon numarasının sayılarını (888675309) içeren bir dize (myStr) oluşturmak için specialChars içinde listelenen özel karakter türlerinin her birini kaldırır. + gibi diğer karakterlerin specialChars öğesine eklenmiş olabileceğini ve bu işlemin uluslararası telefon numarası biçimleriyle kullanılacağını unutmayın.
var phoneString:String = "(888) 867-5309";

var specialChars:Array = new Array("(", ")", "-", " ");
var myStr:String = phoneString;

var ln:uint = specialChars.length;
for(var i:uint; i < ln; i++) {
    myStr = myStr.split(specialChars[i]).join("");
}

var phoneNumber:Number = new Number(myStr);

trace(phoneString); // (888) 867-5309
trace(phoneNumber); // 8888675309

lastIndexOf

()yöntem 
AS3 function lastIndexOf(searchElement:*, fromIndex:int = 0x7fffffff):int

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir dizide bir öğeyi en son öğeden başlayarak geriye doğru arar ve katı eşitlik (===) kullanarak eşleşen öğenin dizin konumunu döndürür.

Parametreler

searchElement:* — Dizide bulunacak öğe.
 
fromIndex:int (default = 0x7fffffff) — Dizide, öğenin aranmaya başlanacağı konum. Varsayılan, bir dizin için izin verilen maksimum değerdir. fromIndex öğesini belirtmezseniz, arama dizideki en son öğeden başlar.

Döndürür
int — Dizideki öğenin sıfır temellidizin konumu. searchElement argümanı bulunmazsa, dönüş değeri -1'dir.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek, belirtilen dizinin konumunu görüntüler:
package {
    import flash.display.Sprite;
    public class Array_lastIndexOf extends Sprite {
        public function Array_lastIndexOf() {
            var arr:Array = new Array(123,45,6789,123,984,323,123,32);
            
            var index:int = arr.indexOf(123);
            trace(index); // 0
            
            var index2:int = arr.lastIndexOf(123);
            trace(index2); // 6
        }
    }
}

map

()yöntem 
AS3 function map(callback:Function, thisObject:* = null):Array

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir işlevi bir dizinin her öğesinde çalıştırır ve orijinal dizideki öğelerin her birindeki işlevin sonuçlarına karşılık gelen yeni bir öğe dizisi oluşturur.

Birinci parametre (callback) bir yöntem kapanışıysa, bu yöntem için ikinci parametrenin (thisObject) null olması gerekir. me adlı film klibinizde bir işlev oluşturduğunuzu varsayın:

     function myFunction(obj:Object):void {
        //your code here
     }
     

Daha sonra da myArray adındaki bir dizide map() yöntemini kullanacağınızı varsayın:

     myArray.map(myFunction, me);
     

myFunction, me tarafından geçersiz kılınamayan Timeline sınıfının bir üyesi olduğundan, Flash çalışma zamanı bir istisna atar. Şu şekilde işlevi bir değişkene atayarak bu zaman aşımı hatasını önleyebilirsiniz:

     var myFunction:Function = function(obj:Object):void {
         //your code here
         };
     myArray.map(myFunction, me);
     

Parametreler

callback:Function — Dizideki her öğe üzerinde çalışma işlevi. Bu işlev basit bir komut (örneğin, dizelerin dizisinin büyük/küçük harf seçeneğini değiştirme) veya daha karmaşık bir işlem içerebilir ve üç argümanla çağrılır; öğenin değeri, öğenin dizini ve Array nesnesi:
    function callback(item:*, index:int, array:Array):String;
 
thisObject:* (default = null) — İşlev için this olarak kullanılacak bir nesne.

Döndürür
Array — Orijinal dizideki öğelerin her birindeki işlevin sonuçlarını içeren yeni bir dizi.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek, büyük harf kullanmak için dizideki tüm öğeleri değiştirir:
package {
    import flash.display.Sprite;
    public class Array_map extends Sprite {
        public function Array_map() {
            var arr:Array = new Array("one", "two", "Three");
            trace(arr); // one,two,Three

            var upperArr:Array = arr.map(toUpper);
            trace(upperArr); // ONE,TWO,THREE
        }
        private function toUpper(element:*, index:int, arr:Array):String {
            return String(element).toUpperCase();
        }
    }
}

pop

()yöntem 
AS3 function pop():*

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir dizinin son öğesini kaldırır ve o öğenin değerini döndürür.

Döndürür
* — Belirtilen dizideki son öğenin (herhangi bir veri türünde) değeri.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu kod, a, b ve c öğelerini içeren bir letters Array nesnesi oluşturur. Ardından, pop() yöntemi kullanılarak son öğe (c) diziden kaldırılır ve letter String nesnesine atanır.
var letters:Array = new Array("a", "b", "c");
trace(letters); // a,b,c
var letter:String = letters.pop();
trace(letters); // a,b
trace(letter);     // c

push

()yöntem 
AS3 function push(... args):uint

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir dizinin sonuna bir veya daha fazla öğe ekler ve dizinin yeni uzunluğunu döndürür.

Parametreler

... args — Dizine eklenecek bir veya birkaç değer.

Döndürür
uint — Yeni dizinin uzunluğunu temsil eden bir tam sayı.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu kod, boş bir letters Array nesnesi oluşturur ve ardından push() yöntemini kullanarak diziye a, b ve c öğelerini doldurur.
var letters:Array = new Array();

letters.push("a");
letters.push("b");
letters.push("c");

trace(letters.toString()); // a,b,c

Şu kod, başlangıçta a öğesiyle doldurulan bir letters Array nesnesi oluşturur. Daha sonra b ve c öğelerini dizinin sonuna eklemek için push() yöntemi kullanılır. Bu dizin, push yönteminin ardından üç öğe içermiş olur.
var letters:Array = new Array("a");
var count:uint = letters.push("b", "c");

trace(letters); // a,b,c
trace(count);   // 3

removeAt

()yöntem 
AS3 function removeAt(index:int):*

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: Flash Player 19, AIR 19

Bir diziden tek bir öğe kaldırın. Bu yöntem, kopya oluşturmadan diziyi değiştirir.

Parametreler

index:int — Silinecek dizideki öğenin dizinini belirten bir tam sayı. Dizinin sonuna göre bir konum belirtmek için negatif bir tam sayı kullanabilirsiniz (örneğin, dizinin son öğesi -1'dir).

Döndürür
* — Orijinal diziden kaldırılmış öğe.

reverse

()yöntem 
AS3 function reverse():Array

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Diziyi yerinde ters çevirir.

Döndürür
Array — Yeni dizi.

Örnek  ( Bu örnek nasıl kullanılır? )

Şu kod, a, b ve c öğelerini içeren bir letters Array nesnesi oluşturur. [c,b,a] dizisini oluşturmak için, reverse() yöntemi kullanılarak dizi öğelerinin sırası tersine çevrilir.
var letters:Array = new Array("a", "b", "c");
trace(letters); // a,b,c
letters.reverse();
trace(letters); // c,b,a

shift

()yöntem 
AS3 function shift():*

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir dizinin ilk öğesini kaldırır ve o öğeyi döndürür. Kalan dizi öğeleri orijinal konumları olan i'den i-1'e taşınır.

Döndürür
* — Bir dizideki ilk öğe (herhangi bir veri türünde).

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu kod, a, b ve c. öğelerini içeren bir letters Array nesnesi oluşturur. Ardından birinci öğeyi (a) letters içinden kaldırıp firstLetter dizesine atamak için shift() yöntemi kullanılır.
var letters:Array = new Array("a", "b", "c");
var firstLetter:String = letters.shift();
trace(letters);     // b,c
trace(firstLetter); // a

slice

()yöntem 
AS3 function slice(startIndex:int = 0, endIndex:int = 16777215):Array

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Orijinal diziyi değiştirmeden, orijinal dizideki öğelerin aralığını içeren yeni bir dizi döndürür. Döndürülen dizi, startIndex öğesini ve endIndex öğesi hariç o öğeye kadar olan tüm öğeleri içerir.

Herhangi bir parametre iletmezseniz, yeni dizi orijinal dizinin aynısıdır (sığ klon).

Parametreler

startIndex:int (default = 0) — Dilim için başlangıç noktasının dizinini belirten bir sayı. startIndex negatif bir sayıysa, başlangıç noktası, dizinin sonunda başlar; burada -1 son öğedir.
 
endIndex:int (default = 16777215) — Dilim için bitiş noktasının dizinini belirten bir sayı. Bu parametreyi atlarsanız, dilim, dizinin başlangıç noktasından sonuna kadar tüm öğeleri içerir. endIndex negatif bir sayıysa, bitiş noktası, dizinin sonunda belirtilir; burada -1 son öğedir.

Döndürür
Array — Orijinal dizideki öğelerin aralığını içeren yeni bir dizi döndürür.

Örnek  ( Bu örnek nasıl kullanılır? )

Şu kod, [a,b,c,d,e,f] öğelerini içeren bir letters Array nesnesi oluşturur. Daha sonra bir (b) ile üç (d) arasındaki öğelerde slice() yöntemi çağrılarak someLetters dizisi oluşturulur ve bunun sonucunda b ve c öğelerini içeren bir dizi verilir.
var letters:Array = new Array("a", "b", "c", "d", "e", "f");
var someLetters:Array = letters.slice(1,3);

trace(letters);     // a,b,c,d,e,f
trace(someLetters); // b,c

Şu kod, [a,b,c,d,e,f] öğelerini içeren bir letters Array nesnesi oluşturur. Daha sonra iki öğesinde (c) slice() yöntemi çağrılarak someLetters dizisi oluşturulur ve bunun sonucunda [c,d,e,f] öğelerini içeren bir dizi verilir.
var letters:Array = new Array("a", "b", "c", "d", "e", "f");
var someLetters:Array = letters.slice(2);

trace(letters);     // a,b,c,d,e,f
trace(someLetters); // c,d,e,f

Şu kod, [a,b,c,d,e,f] öğelerini içeren bir letters Array nesnesi oluşturur. Ardından, ikinciden son öğeye (e) kadarki öğelerde slice() yöntemi çağrılarak someLetters dizisi oluşturulur ve bunun sonucunda e ve f öğelerini içeren bir dizi verilir.
var letters:Array = new Array("a", "b", "c", "d", "e", "f");
var someLetters:Array = letters.slice(-2);

trace(letters);     // a,b,c,d,e,f
trace(someLetters); // e,f

some

()yöntem 
AS3 function some(callback:Function, thisObject:* = null):Boolean

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

true döndüren bir öğeye ulaşılıncaya kadar dizideki her öğede bir test işlevi çalıştırır. Bir dizideki tüm öğelerin belirli bir sayıdan daha az değere sahip olma gibi bir ölçütü karşılayıp karşılamadığını belirlemek için bu yöntemi kullanın.

Birinci parametre (callback) bir yöntem kapanışıysa, bu yöntem için ikinci parametrenin (thisObject) null olması gerekir. me adlı film klibinizde bir işlev oluşturduğunuzu varsayın:

     function myFunction(obj:Object):void {
        //your code here
     }
     

Daha sonra da myArray adındaki bir dizide some() yöntemini kullanacağınızı varsayın:

     myArray.some(myFunction, me);
     

myFunction, me tarafından geçersiz kılınamayan Timeline sınıfının bir üyesi olduğundan, Flash çalışma zamanı bir istisna atar. Şu şekilde işlevi bir değişkene atayarak bu zaman aşımı hatasını önleyebilirsiniz:

     var myFunction:Function = function(obj:Object):void {
         //your code here
         };
     myArray.some(myFunction, me);
     

Parametreler

callback:Function — Dizideki her öğe üzerinde çalışma işlevi. Bu işlev basit bir karşılaştırma (örneğin, item < 20) veya daha karmaşık bir işlem içerebilir ve üç argümanla çağrılır; öğenin değeri, öğenin dizini ve Array nesnesi:
    function callback(item:*, index:int, array:Array):Boolean;
 
thisObject:* (default = null) — İşlev için this olarak kullanılacak bir nesne.

Döndürür
Boolean — Belirtilen işlev için dizideki tüm öğeler true değerini döndürürse, Boolean değeri true; aksi takdirde, false.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek, hangi değerlerin tanımsız olduğunu gösterir:
package {
    import flash.display.Sprite;
    public class Array_some extends Sprite {
        public function Array_some() {
            var arr:Array = new Array();
            arr[0] = "one";
            arr[1] = "two";
            arr[3] = "four";
            var isUndef:Boolean = arr.some(isUndefined);
            if (isUndef) {
                trace("array contains undefined values: " + arr);
            } else {
                trace("array contains no undefined values.");
            }
        }
        private function isUndefined(element:*, index:int, arr:Array):Boolean {
            return (element == undefined);
        }
    }
}

sort

()yöntem 
AS3 function sort(... args):Array

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir dizideki öğeleri sıralar. Bu yöntem, Unicode değerlerine göre sıralama yapar. (ASCII, Unicode öğesinin alt kümesidir.)

Varsayılan olarak, Array.sort() şu şekilde çalışır:

  • Sıralama büyük/küçük harf duyarlıdır (Z, a'dan önce gelir).
  • Sıralama artan sırada olur (a, b'den önce gelir).
  • Dizi, sıralama düzenini yansıtacak şekilde değiştirilir, aynı sıralama alanı olan birden çok öğe herhangi bir düzen dikkate alınmaksızın sıralanmış diziye art arda yerleştirilir.
  • Veri türü fark etmeksizin tüm öğeler, dizeymiş gibi sıralanır, bu nedenle "1"'in dize değeri "9"dan düşük olduğu için 100, 99'dan önce gelir.

Varsayılan ayarlardan sapan ayarları kullanarak bir diziyi sıralamak için, ...args parametresinin sortOptions bölümünde açıklanan sıralama seçeneklerinden birini kullanabilir veya sıralamayı yapmak için kendi özel işlevinizi oluşturabilirsiniz. Özel bir işlev oluşturursanız, sort() yöntemini çağırıp özel işlevinizin adını birinci argüman (compareFunction) olarak kullanırsınız.

Parametreler

... args — Bir karşılaştırma işlevini belirten ve sıralama davranışını belirleyen bir veya daha fazla değeri belirten argümanlar.

Bu yöntem, şu şekilde tanımlanan argümanlarla birlikte Array.sort(compareFunction, sortOptions) sözdizimi ve argüman sırasını kullanır:

  • compareFunction - Bir dizideki öğelerin sıralanma düzenini belirlemek için kullanılan karşılaştırma işlevi. Bu argüman isteğe bağlıdır. Karşılaştırma işlevinin karşılaştırılacak iki argüman alması gerekir. A ve B öğeleri verildiğinde, compareFunction öğesinin sonucu negatif bir değer, 0 veya pozitif bir değer olabilir:
    • Negatif bir döndürme değeri, sıralanmış bir dizide A'nın B'den önce görüntülendiğini belirtir.
    • 0 döndürme değeri, A ve B'nin aynı sıralama düzenine sahip olduğunu belirtir.
    • Pozitif bir döndürme değeri, sıralanmış bir dizide A'nın B'den sonra görüntülendiğini belirtir.
  • sortOptions - Sıralama davranışının varsayılan ayarını değiştiren, | (bitsel OR) operatörüyle ayrılmış bir veya daha fazla sayı ya da tanımlanmış sabit. Bu argüman isteğe bağlıdır. Şu değerler, sortOptions için kabul edilebilir:
    • 1 veya Array.CASEINSENSITIVE
    • 2 veya Array.DESCENDING
    • 4 veya Array.UNIQUESORT
    • 8 veya Array.RETURNINDEXEDARRAY
    • 16 veya Array.NUMERIC
    Daha fazla bilgi için Array.sortOn() yöntemine bakın.

Döndürür
Array — Dönüş değeri, şu listede açıklandığı gibi herhangi bir argüman iletip iletmemenize dayanır.
  • ...args argümanının sortOptions argümanı için 4 veya Array.UNIQUESORT değerini belirtirseniz ve sıralanmış iki ya da daha fazla öğenin sıralama alanları aynıysa, Flash 0 değerini döndürür ve diziyi değiştirmez.
  • ...args argümanının sortOptions argümanı için 8 veya Array.RETURNINDEXEDARRAY değerini belirtirseniz, Flash, sıralamanın sonuçlarını yansıtan dizinlerin sıralanmış sayısal dizisini döndürür ve diziyi değiştirmez.
  • Aksi takdirde, Flash hiçbir şey döndürmez ve sıralama düzenini yansıtmak için diziyi değiştirir.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu kod, [spinach, green pepper, cilantro, onion, avocado] öğelerini içeren bir vegetables Array nesnesi oluşturur. Daha sonra dizi, parametre olmadan çağrılan sort() yöntemine göre sıralanır. Sonuç olarak, vegetables alfabetik düzende sıralanır ([avocado, cilantro, green pepper, onion, spinach]).
var vegetables:Array = new Array("spinach",
                 "green pepper",
                 "cilantro",
                 "onion",
                 "avocado");

trace(vegetables); // spinach,green pepper,cilantro,onion,avocado
vegetables.sort();
trace(vegetables); // avocado,cilantro,green pepper,onion,spinach

Şu kod, [spinach, green pepper, Cilantro, Onion ve Avocado] öğelerini içeren bir vegetables Array nesnesi oluşturur. Daha sonra dizi, ilk anda parametre olmadan çağrılan sort() yöntemine göre sıralanır; sonuç olarak [Avocado,Cilantro,Onion,green pepper,spinach] şeklinde sıralama olur. Ardından parametre olarak CASEINSENSITIVE sabitiyle tekrar vegetables üzerinde sort() çağrılır. Sonuç olarak, vegetables alfabetik düzende sıralanır ([Avocado, Cilantro, green pepper, Onion, spinach]).
var vegetables:Array = new Array("spinach",
                 "green pepper",
                 "Cilantro",
                 "Onion",
                 "Avocado");

vegetables.sort();
trace(vegetables); // Avocado,Cilantro,Onion,green pepper,spinach
vegetables.sort(Array.CASEINSENSITIVE);
trace(vegetables); // Avocado,Cilantro,green pepper,Onion,spinach

Şu kod, boş bir vegetables Array nesnesi oluşturur ve bu nesne daha sonra beş push() çağrısıyla doldurulur. push() her çağrıldığında, bir String (name) ve Number (price) nesnesini kabul eden Vegetable() yapıcısına bir çağrı yapılarak yeni bir Vegetable nesnesi oluşturulur. Gösterilen değerlerle push() öğesinin beş defa çağrılması sonucunda şu dizi verilir: [lettuce:1.49, spinach:1.89, asparagus:3.99, celery:1.29, squash:1.44]. Daha sonra diziyi sıralamak için sort() yöntemi kullanılır ve bunun sonucunda [asparagus:3.99, celery:1.29, lettuce:1.49, spinach:1.89, squash:1.44] dizisi verilir.
var vegetables:Array = new Array();
vegetables.push(new Vegetable("lettuce", 1.49));
vegetables.push(new Vegetable("spinach", 1.89));
vegetables.push(new Vegetable("asparagus", 3.99));
vegetables.push(new Vegetable("celery", 1.29));
vegetables.push(new Vegetable("squash", 1.44));

trace(vegetables);
// lettuce:1.49, spinach:1.89, asparagus:3.99, celery:1.29, squash:1.44

vegetables.sort();

trace(vegetables);
// asparagus:3.99, celery:1.29, lettuce:1.49, spinach:1.89, squash:1.44

//The following code defines the Vegetable class
class Vegetable {
    private var name:String;
    private var price:Number;

    public function Vegetable(name:String, price:Number) {
        this.name = name;
        this.price = price;
    }

    public function toString():String {
        return " " + name + ":" + price;
    }
}

Şu örnek bir önceki örneğin tamamen aynısıdır, tek farkı sort() yönteminin alfabetik olarak değil de fiyata göre sıralama yapan özel bir sıralama işleviyle (sortOnPrice) kullanılmasıdır. Yeni getPrice() işlevinin fiyatı dışa aktardığını unutmayın.
var vegetables:Array = new Array();
vegetables.push(new Vegetable("lettuce", 1.49));
vegetables.push(new Vegetable("spinach", 1.89));
vegetables.push(new Vegetable("asparagus", 3.99));
vegetables.push(new Vegetable("celery", 1.29));
vegetables.push(new Vegetable("squash", 1.44));

trace(vegetables);
// lettuce:1.49, spinach:1.89, asparagus:3.99, celery:1.29, squash:1.44

vegetables.sort(sortOnPrice);

trace(vegetables);
// celery:1.29, squash:1.44, lettuce:1.49, spinach:1.89, asparagus:3.99

function sortOnPrice(a:Vegetable, b:Vegetable):Number {
    var aPrice:Number = a.getPrice();
    var bPrice:Number = b.getPrice();

    if(aPrice > bPrice) {
        return 1;
    } else if(aPrice < bPrice) {
        return -1;
    } else  {
        //aPrice == bPrice
        return 0;
    }
}

// The following code defines the Vegetable class and should be in a separate package.
class Vegetable {
    private var name:String;
    private var price:Number;

    public function Vegetable(name:String, price:Number) {
        this.name = name;
        this.price = price;
    }

    public function getPrice():Number {
        return price;
    }

    public function toString():String {
        return " " + name + ":" + price;
    }
}

Şu kod, [3,5,100,34,10] öğelerini içeren numbers Array nesnesini oluşturur. Herhangi bir parametre olmadan sort() çağrısı yapıldığında, sıralama alfabetik olur ve bu da istenmeyen sonuçlara [10,100,3,34,5] yol açabilir. Sayısal değerleri düzgün şekilde sıralamak için, NUMERIC sabitini sort() yöntemine iletmeniz gerekir, bu yöntem numbers öğesini şu şekilde sıralar: [3,5,10,34,100].

Not: sort() işlevinin varsayılan davranışı, her varlığı dize olarak ele almaktır. Array.NUMERIC argümanını kullanırsanız, Flash çalışma zamanı, sıralama amacıyla sayısal olmayan değerleri tam sayılara dönüştürmeye çalışır. Başarısız olursa, çalışma zamanı bir hata atar. Örneğin, çalışma zamanı "6" String değerini başarıyla bir tam sayıya dönüştürebilir, ancak "six" String değeriyle karşılaşırsa hata atar.

var numbers:Array = new Array(3,5,100,34,10);

trace(numbers); // 3,5,100,34,10
numbers.sort();
trace(numbers); // 10,100,3,34,5
numbers.sort(Array.NUMERIC);
trace(numbers); // 3,5,10,34,100

sortOn

()yöntem 
AS3 function sortOn(fieldName:Object, options:Object = null):Array

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir dizideki öğeleri, dizideki bir veya daha fazla alana göre sıralar. Dizide şu özellikler olmalıdır:

  • Dizi, ilişkilendirilebilir bir dizi değil, dizinli bir dizidir.
  • Dizinin her öğesinde bir veya daha fazla özelliğe sahip bir nesne bulunur.
  • Tüm nesnelerin ortak en az bir özelliği vardır, bu özelliğin değerleri diziyi sıralamak için kullanılabilir. Bu özellik türüne field denir.

Birden çok fieldName parametresi iletirseniz, birinci alan birincil sıralama alanını ve ikinci alan da sonraki sıralama alanını, vb. temsil eder. Flash, Unicode değerlerine göre sıralar. (ASCII, Unicode öğesinin alt kümesidir.) Karşılaştırılan öğelerden herhangi biri fieldName parametresinde belirtilen alanı içermezse, alanın undefined olarak ayarlandığı varsayılır ve öğeler herhangi bir düzen dikkate alınmaksızın sıralanmış diziye art arda yerleştirilir.

Varsayılan olarak, Array.sortOn() şu şekilde çalışır:

  • Sıralama büyük/küçük harf duyarlıdır (Z, a'dan önce gelir).
  • Sıralama artan sırada olur (a, b'den önce gelir).
  • Dizi, sıralama düzenini yansıtacak şekilde değiştirilir, aynı sıralama alanı olan birden çok öğe herhangi bir düzen dikkate alınmaksızın sıralanmış diziye art arda yerleştirilir.
  • Sayısal alanlar dizeymiş gibi sıralanır, bu nedenle "1"in dize değeri "9"dan düşük olduğu için 100, 99'dan önce gelir.

Flash Player 7, varsayılan sıralama davranışını geçersiz kılmak için kullanabileceğiniz options parametresini eklemiştir. Basit bir diziyi (örneğin, yalnızca bir alan içeren bir dizi) sıralamak veya options parametresinin desteklemediği bir sıralama düzeni belirtmek için Array.sort() öğesini kullanın.

Birden çok bayrak iletmek için bunları bitsel OR (|) operatörüyle birbirinden ayırın:

     my_array.sortOn(someFieldName, Array.DESCENDING | Array.NUMERIC);
     

Flash Player 8, birden çok alana göre sıralama yapıldığında her alan için farklı bir sıralama seçeneği belirtme yeteneğini eklemiştir. Flash Player 8 ve daha sonraki sürümlerinde options parametresi, her sıralama seçeneği fieldName parametresindeki bir sıralama alanına karşılık gelecek şekilde sıralama seçenekleri dizisini kabul eder. Şu örnek, azalan sıralama kullanarak birincil sıralama alanını (a); sayısal sıralama kullanarak ikincil sıralama alanını (b) ve büyük/küçük harf duyarsız sıralama kullanarak üçüncül sıralama alanını (c) sıralar:

     Array.sortOn (["a", "b", "c"], [Array.DESCENDING, Array.NUMERIC, Array.CASEINSENSITIVE]);
     

Not: fieldName ve options dizilerinin aynı sayıda öğeye sahip olması gerektiğini, aksi takdirde options dizisinin yok sayılacağını unutmayın. Ayrıca Array.UNIQUESORT ve Array.RETURNINDEXEDARRAY seçenekleri de yalnızca dizideki birinci öğe olarak kullanılabilir, aksi takdirde yok sayılır.

Parametreler

fieldName:Object — Sıralama değeri olarak kullanılacak bir alanı belirten dize veya birinci öğenin birincil sıralama alanını ve ikinci öğenin de ikincil sıralama alanını, vb. yansıttığı bir dizi.
 
options:Object (default = null) — Sıralama davranışını değiştiren bitwise OR (|) operatörüyle birbirinden ayrılmış tanımlı sabitlerin bir veya birden çok numarası ya da adı. Şu değerler options parametresi için kabul edilebilir:
  • Array.CASEINSENSITIVE veya 1
  • Array.DESCENDING veya 2
  • Array.UNIQUESORT veya 4
  • Array.RETURNINDEXEDARRAY veya 8
  • Array.NUMERIC veya 16

Bayrağın sayısal şekli (2) yerine dize şeklini (örneğin, DESCENDING) kullanırsanız kod ipuçları etkinleştirilir.

Döndürür
Array — Dönüş değeri, herhangi bir parametre iletip iletmemenize bağlıdır.
  • options parametresi için 4 veya Array.UNIQUESORT değerini belirtirseniz ve sıralanan iki ya da daha fazla öğenin sıralama alanı aynıysa, 0 değeri döndürülür ve dizi değiştirilmez.
  • options parametresi için 8 veya Array.RETURNINDEXEDARRAY değerini belirtirseniz, sıralamanın sonuçlarını yansıtan bir dizi döndürülür ve dizi değiştirilmez.
  • Aksi takdirde herhangi bir şey döndürülmez ve dizi sıralama düzenini yansıtacak şekilde değiştirilir.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu kod, boş bir vegetables Array nesnesi oluşturur ve dizi daha sonra beş push() çağrısıyla doldurulur. push() her çağrıldığında, bir String (name) ve Number (price) nesnesini kabul eden Vegetable() yapıcısı çağrılarak yeni bir Vegetable nesnesi oluşturulur. Gösterilen değerlerle push() öğesinin beş defa çağrılması sonucunda şu dizi verilir: [lettuce:1.49, spinach:1.89, asparagus:3.99, celery:1.29, squash:1.44]. Daha sonra şu diziyi oluşturmak için name parametresiyle birlikte sortOn() yöntemi kullanılır: [asparagus:3.99, celery:1.29, lettuce:1.49, spinach:1.89, squash:1.44]. Ardından azalan düzende sayılara göre sıralanmış bir dizi oluşturmak için price parametresi ve NUMERIC ve DESCENDING sabitleri ile tekrar sortOn() yöntemi çağrılır: [asparagus:3.99, spinach:1.89, lettuce:1.49, squash:1.44, celery:1.29].
var vegetables:Array = new Array();
vegetables.push(new Vegetable("lettuce", 1.49));
vegetables.push(new Vegetable("spinach", 1.89));
vegetables.push(new Vegetable("asparagus", 3.99));
vegetables.push(new Vegetable("celery", 1.29));
vegetables.push(new Vegetable("squash", 1.44));

trace(vegetables);
// lettuce:1.49, spinach:1.89, asparagus:3.99, celery:1.29, squash:1.44

vegetables.sortOn("name");
trace(vegetables);
// asparagus:3.99, celery:1.29, lettuce:1.49, spinach:1.89, squash:1.44

vegetables.sortOn("price", Array.NUMERIC | Array.DESCENDING);
trace(vegetables);
// asparagus:3.99, spinach:1.89, lettuce:1.49, squash:1.44, celery:1.29

class Vegetable {
    public var name:String;
    public var price:Number;

    public function Vegetable(name:String, price:Number) {
        this.name = name;
        this.price = price;
    }

    public function toString():String {
        return " " + name + ":" + price;
    }
}

Şu kod, boş bir records Array nesnesi oluşturur ve dizi daha sonra üç push() çağrısıyla doldurulur. push() her çağrıldığında, name ve city dizeleri ile zip numarası records öğesine eklenir. Dizi öğelerini yazdırmak için üç for döngüsü kullanılır. Birinci for döngüsü, öğeleri eklendikleri sırayla yazdırır. İkinci for döngüsü, sortOn() yöntemi kullanılarak records ada ve şehre göre sıralandıktan sonra çalıştırılır. records şehre ve sonra ada göre yeniden sıralandığı için, üçüncü for döngüsü farklı çıktılar oluşturur.

var records:Array = new Array();
records.push({name:"john", city:"omaha", zip:68144});
records.push({name:"john", city:"kansas city", zip:72345});
records.push({name:"bob", city:"omaha", zip:94010});

for(var i:uint = 0; i < records.length; i++) {
    trace(records[i].name + ", " + records[i].city);
}
// Results:
// john, omaha
// john, kansas city
// bob, omaha

trace("records.sortOn('name', 'city');");
records.sortOn(["name", "city"]);
for(var i:uint = 0; i < records.length; i++) {
    trace(records[i].name + ", " + records[i].city);
}
// Results:
// bob, omaha
// john, kansas city
// john, omaha

trace("records.sortOn('city', 'name');");
records.sortOn(["city", "name"]);
for(var i:uint = 0; i < records.length; i++) {
    trace(records[i].name + ", " + records[i].city);
}
// Results:
// john, kansas city
// bob, omaha
// john, omaha

Şu kod, boş bir users Array nesnesi oluşturur ve dizi daha sonra dört push() çağrısıyla doldurulur. push() her çağrıldığında, kullanıcılara User() yapıcısı ve bir name dizesi ile age uint öğesi eklenmiş şekilde bir User nesnesi oluşturulur. Verilen dizi kümesi şudur: [Bob:3,barb:35,abcd:3,catchy:4].

Dizi daha sonra şu şekilde sıralanır:

  1. Yalnızca ada göre, ortaya çıkan dizi: [Bob:3,abcd:3,barb:35,catchy:4]
  2. Ada göre ve CASEINSENSITIVE sabiti kullanılarak, ortaya çıkan dizi: [abcd:3,barb:35,Bob:3,catchy:4]
  3. Ada göre ve CASEINSENSITIVE ve DESCENDING sabitleri kullanılarak, ortaya çıkan dizi: [catchy:4,Bob:3,barb:35,abcd:3]
  4. Yalnızca yaşa göre, ortaya çıkan dizi: [abcd:3,Bob:3,barb:35,catchy:4]
  5. Yaşa göre ve NUMERIC sabiti kullanılarak, ortaya çıkan dizi: [Bob:3,abcd:3,catchy:4,barb:35]
  6. Yaşa göre ve DESCENDING ve NUMERIC sabitleri kullanılarak, ortaya çıkan dizi: [barb:35,catchy:4,Bob:3,abcd:3]

Daha sonra indices adında bir dizi oluşturulur ve yaşa göre ve NUMERIC ve RETURNINDEXEDARRAY sabitleri kullanılarak yapılan sıralama sonuçlarına eklenir, verilen dizi: [Bob:3,abcd:3,catchy:4,barb:35], bu daha sonra for döngüsü kullanılarak yazdırılır.

class User {
    public var name:String;
    public var age:Number;
    public function User(name:String, age:uint) {
        this.name = name;
        this.age = age;
    }

    public function toString():String {
        return this.name + ":" + this.age;
    }
}

var users:Array = new Array();
users.push(new User("Bob", 3));
users.push(new User("barb", 35));
users.push(new User("abcd", 3));
users.push(new User("catchy", 4));

trace(users); // Bob:3,barb:35,abcd:3,catchy:4

users.sortOn("name");
trace(users); // Bob:3,abcd:3,barb:35,catchy:4

users.sortOn("name", Array.CASEINSENSITIVE);
trace(users); // abcd:3,barb:35,Bob:3,catchy:4

users.sortOn("name", Array.CASEINSENSITIVE | Array.DESCENDING);
trace(users); // catchy:4,Bob:3,barb:35,abcd:3

users.sortOn("age");
trace(users); // abcd:3,Bob:3,barb:35,catchy:4

users.sortOn("age", Array.NUMERIC);
trace(users); // Bob:3,abcd:3,catchy:4,barb:35

users.sortOn("age", Array.DESCENDING | Array.NUMERIC);
trace(users); // barb:35,catchy:4,Bob:3,abcd:3

var indices:Array = users.sortOn("age", Array.NUMERIC | Array.RETURNINDEXEDARRAY);
var index:uint;
for(var i:uint = 0; i < indices.length; i++) {
    index = indices[i];
    trace(users[index].name, ": " + users[index].age);
}

// Results:
// Bob : 3
// abcd : 3
// catchy : 4
// barb : 35

splice

()yöntem 
AS3 function splice(startIndex:int, deleteCount:uint, ... values):Array

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir diziye öğe ekleyip diziden öğeyi kaldırır. Bu yöntem, kopya oluşturmadan diziyi değiştirir.

Not: Bir Array alt sınıfında bu yöntemi geçersiz kılmak için, şu örnekte gösterildiği gibi parametreler için ...args öğesini kullanın:

     public override function splice(...args) {
       // your statements here
     }
     

Parametreler

startIndex:int — Ekleme veya silmenin başladığı dizideki öğenin dizinini belirten bir tam sayı. Dizinin sonuna göre bir konum belirtmek için negatif bir tam sayı kullanabilirsiniz (örneğin, dizinin son öğesi -1'dir).
 
deleteCount:uint — Silinecek öğe sayısını belirten bir tam sayı. Bu sayı, startIndex parametresinde belirtilen öğeyi içerir. deleteCount parametresi için bir değer belirtmezseniz, yöntem startIndex öğesinden dizideki son öğeye kadar tüm değerleri siler. Değer 0 ise herhangi bir öğe silinmez.
 
... valuesstartIndex parametresinde belirtilen konumdaki diziye eklenecek, virgülle ayrılmış bir veya birkaç değerden oluşan isteğe bağlı bir liste. Eklenen değer Array türündeyse, dizi değiştirilmeden korunur ve tek bir öğe olarak eklenir. Örneğin, varolan bir üç uzunluk dizisini başka bir üç uzunluk dizisine eklerseniz, sonuçta ortaya çıkan dizide yalnızca dört öğe olacaktır. Ancak bu öğelerden biri, üç uzunluk dizesi olacaktır.

Döndürür
Array — Orijinal diziden kaldırılmış öğeleri içeren bir dizi.

Örnek  ( Bu örnek nasıl kullanılır? )

Şu kod, [spinach, green pepper, cilantro, onion, avocado] öğelerini içeren bir vegetables Array nesnesi oluşturur. Daha sonra, spliced dizisine cilantro ve onion öğelerini atayan 2 ve 2 parametreleriyle splice() yöntemi çağrılır. [spinach,green pepper,avocado] öğelerini içeren vegetables dizisi. vegetables dizisine ikinci öğe olarak [cilantro,onion] öğesini atamak için 1, 0 parametreleri ve spliced dizisi kullanılarak splice() yöntemi çağrılır.
var vegetables:Array = new Array("spinach",
                 "green pepper",
                 "cilantro",
                 "onion",
                 "avocado");

var spliced:Array = vegetables.splice(2, 2);
trace(vegetables); // spinach,green pepper,avocado
trace(spliced);    // cilantro,onion

vegetables.splice(1, 0, spliced);
trace(vegetables); // spinach,cilantro,onion,green pepper,avocado


vegetables dizininde gerçekte dört öğe bulunduğu halde (ve ikinci öğe, iki öğe içeren başka bir dizi olduğu halde), cilantro ve onion öğelerinin bu dizinde 5 öğe varmış gibi izleme işlemi yaptığına dikkat edin. Ayrı ayrı cilantro ve onion eklemek için şu kullanılır:
 
var vegetables:Array = new Array("spinach",
                 "green pepper",
                 "cilantro",
                 "onion",
                 "avocado");
 
 var spliced:Array = vegetables.splice(2, 2);
 trace(vegetables); // spinach,green pepper,avocado
 trace(spliced);    // cilantro,onion
 
 vegetables.splice(1, 0, "cilantro", "onion");
 trace(vegetables); // spinach,cilantro,onion,green pepper,avocado

toLocaleString

()yöntem 
public function toLocaleString():String

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Belirtilen dizideki öğeleri temsil eden bir dize döndürür. Dizideki 0 diziniyle başlayıp en yüksek dizinle biten her öğe, birleştirilmiş bir dizeye dönüştürülür ve virgüllerle birbirinden ayrılır. ActionScript 3.0 uygulamasında bu yöntem, Array.toString() yöntemiyle aynı değeri döndürür.

Döndürür
String — Dizi öğelerinden oluşan bir dize.

İlgili API Öğeleri

toString

()yöntem 
public function toString():String

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Belirtilen dizideki öğeleri temsil eden bir dize döndürür. Dizideki 0 diziniyle başlayıp en yüksek dizinle biten her öğe, birleştirilmiş bir dizeye dönüştürülür ve virgüllerle birbirinden ayrılır. Özel bir ayırıcı belirtmek için, Array.join() yöntemini kullanın.

Döndürür
String — Dizi öğelerinden oluşan bir dize.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu kod, bir Array oluşturur, değerleri dizelere dönüştürür ve bunları String veri türünün vegnums değişkeninde saklar.
var vegetables:Array = new Array();
vegetables.push(1);
vegetables.push(2);
vegetables.push(3);
vegetables.push(4);
vegetables.push(5);
var vegnums:String = vegetables.toString();
trace(vegnums+",6");
// 1,2,3,4,5,6

unshift

()yöntem 
AS3 function unshift(... args):uint

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir dizinin başına bir veya daha fazla öğe ekler ve dizinin yeni uzunluğunu döndürür. Dizideki diğer öğeler orijinal konumları olan i'den i+1'e taşınır.

Parametreler

... args — Dizinin başına eklenecek bir veya daha fazla sayı, öğe ya da değişken.

Döndürür
uint — Dizinin yeni uzunluğunu temsil eden bir tam sayı.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu kod boş bir names Array nesnesi oluşturur. push() yöntemiyle Bill ve Jeff dizeleri eklenir ve sonra iki unshift() çağrısıyla names öğesinin başına Alfred ve Kyle dizeleri eklenir.
var names:Array = new Array();
names.push("Bill");
names.push("Jeff");

trace(names); // Bill,Jeff

names.unshift("Alfred");
names.unshift("Kyle");

trace(names); // Kyle,Alfred,Bill,Jeff
Sabit Ayrıntısı

CASEINSENSITIVE

Sabit
public static const CASEINSENSITIVE:uint = 1

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Array sınıfı sıralama yöntemleri için büyük/küçük harf duyarsız sıralama belirtir. sort() veya sortOn() yönteminde options parametresi için bu sabiti kullanabilirsiniz.

Bu sabitin değeri 1'dir.

İlgili API Öğeleri

DESCENDING

Sabit 
public static const DESCENDING:uint = 2

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Array sınıfı sıralama yöntemleri için azalan sırada sıralama belirtir. sort() veya sortOn() yönteminde options parametresi için bu sabiti kullanabilirsiniz.

Bu sabitin değeri 2'dir.

İlgili API Öğeleri

NUMERIC

Sabit 
public static const NUMERIC:uint = 16

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Array sınıfı sıralama yöntemleri için sayısal (karakter dizesi yerine) sıralama belirtir. options parametresine bu sabitin dahil edilmesi, sort() ve sortOn() yöntemlerinin sayıları sayısal karakter dizeleri olarak değil, sayısal değerler olarak sıralamasını sağlar. NUMERIC sabiti olmadan sıralama işlemi, her dizi öğesini karakter dizesi olarak değerlendirir ve sonuçları Unicode sırasında verir.

Örneğin, [2005, 7, 35] değer dizisi verildiğinde, NUMERIC sabiti options parametresine dahil edilmezse, sıralanan dizi [2005, 35, 7] olur ancak NUMERIC sabiti dahil edilirse, sıralanan dizi [7, 35, 2005] olur.

Bu sabit yalnızca dizideki sayılar için geçerlidir; ["23", "5"] gibi sayısal veri içeren dizeler için geçerli değildir.

Bu sabitin değeri 16'dır.

İlgili API Öğeleri

RETURNINDEXEDARRAY

Sabit 
public static const RETURNINDEXEDARRAY:uint = 8

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir sıralamanın dizi dizinlerinden oluşan bir dizi döndüreceğini belirtir. sort() veya sortOn() yönteminde options parametresi için bu sabiti kullanabilir, böylece orijinal dizi değiştirilmemiş durumdayken dizi öğelerinin birden çok görünümüne erişebilirsiniz.

Bu sabitin değeri 8'dir.

İlgili API Öğeleri

UNIQUESORT

Sabit 
public static const UNIQUESORT:uint = 4

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Array sınıfı sıralama yöntemleri için benzersiz sıralama gereksinimini belirtir. sort() veya sortOn() yönteminde options parametresi için bu sabiti kullanabilirsiniz. Sıralanan öğe veya alanlardan herhangi ikisi aynı değere sahipse, benzersiz sıralama seçeneği sıralamayı sonlandırır.

Bu sabitin değeri 4'tür.

İlgili API Öğeleri

ArrayExample.as

Şu örnek, herhangi bir argüman ve 0 başlangıç uzunluğu olmadan yeni bir myArr Array nesnesi oluşturur:
package {
    import flash.display.Sprite;

    public class ArrayExample extends Sprite {
        public function ArrayExample() {
            var myArr:Array = new Array();
            trace(myArr.length); // 0
        }
    }
}




[ X ]Niçin İngilizce?
ActionScript 3.0 Başvurusu'ndaki içerik İngilizce görünür

ActionScript 3.0 Başvurusu'nun tüm bölümleri tüm dillere çevrilmemiştir. Bir dil öğesi çevrilmediğinde İngilizce görünür. Örneğin, ga.controls.HelpBox sınıfı hiçbir dile çevrilmez. Bu nedenle, başvurunun Türkçe versiyonunda ga.controls.HelpBox sınıfı İngilizce görünür.