array view php

Tampilan Array PHP

Array View adalah pustaka PHP yang memberikan abstraksi dan utilitas yang kuat untuk bekerja dengan daftar data. Buat tampilan array, iris, dan indeks menggunakan notasi seperti python, mengubah dan pilih data Anda menggunakan operasi rantai dan lancar.

Fitur

• Tampilan array sebagai abstraksi atas array
• Pengindeksan array maju dan mundur
• Memilih dan Mengiris Menggunakan Notasi Irisan Python
• Penyaringan, pemetaan, pencocokan dan menutupi
• Operasi rantai melalui pipa dan antarmuka yang lancar

Cara menginstal ke proyek Anda

composer require smoren/array-view

Penggunaan

Pengindeksan

Indeks ke array ke depan atau ke belakang menggunakan indeks positif atau negatif.

Data	1	2	3	4	5	6	7
Indeks positif	0	1	2	3	4	5	6
Indeks negatif	-7	-6	-5	-4	-3	-2	-1

 use Smoren  ArrayView  Views  ArrayView ;

$ view = ArrayView:: toView ([ 1 , 2 , 3 , 4 , 5 , 6 , 7 ]);

$ view [ 0 ];  // 1
$ view [ 1 ];  // 2
$ view [- 1 ]; // 7
$ view [- 2 ]; // 6

Irisan

Gunakan notasi irisan seperti Python untuk memilih berbagai elemen: [start, stop, step] .

 use Smoren  ArrayView  Views  ArrayView ;

$ originalArray = [ 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 ];
$ view = ArrayView:: toView ( $ originalArray );

$ view [ ' 1:6 ' ];   // [2, 3, 4, 5, 6]
$ view [ ' 1:7:2 ' ]; // [2, 4, 6]
$ view [ ' :3 ' ];    // [1, 2, 3]
$ view [ ' ::-1 ' ];  // [9, 8, 7, 6, 5, 4, 3, 2, 1]

Masukkan ke bagian array.

 $ view [ ' 1:7:2 ' ] = [ 22 , 44 , 66 ];
print_r ( $ originalArray ); // [1, 22, 3, 44, 5, 66, 7, 8, 9]

Subview

Buat subview dari tampilan asli menggunakan topeng, indeks, dan irisan.

 use Smoren  ArrayView  Selectors  IndexListSelector ;
use Smoren  ArrayView  Selectors  MaskSelector ;
use Smoren  ArrayView  Selectors  SliceSelector ;
use Smoren  ArrayView  Views  ArrayView ;

$ originalArray = [ 1 , 2 , 3 , 4 , 5 ];
$ view = ArrayView:: toView ( $ originalArray );

// Object-oriented style
$ view -> subview ( new MaskSelector ([ true , false , true , false , true ]))-> toArray (); // [1, 3, 5]
$ view -> subview ( new IndexListSelector ([ 1 , 2 , 4 ]))-> toArray ();                   // [2, 3, 5]
$ view -> subview ( new SliceSelector ( ' ::-1 ' ))-> toArray ();                          // [5, 4, 3, 2, 1]

// Scripting style 
$ view -> subview ([ true , false , true , false , true ])-> toArray (); // [1, 3, 5]
$ view -> subview ([ 1 , 2 , 4 ])-> toArray ();                        // [2, 3, 5]
$ view -> subview ( ' ::-1 ' )-> toArray ();                           // [5, 4, 3, 2, 1]

$ view -> subview ( new MaskSelector ([ true , false , true , false , true ]))-> apply ( fn ( $ x ) => x * 10 );
print_r ( $ originalArray ); // [10, 2, 30, 4, 50]

Subarray Multi-Indexing

Langsung pilih beberapa elemen menggunakan multi-seleksi array-index.

 use Smoren  ArrayView  Selectors  IndexListSelector ;
use Smoren  ArrayView  Selectors  MaskSelector ;
use Smoren  ArrayView  Selectors  SliceSelector ;
use Smoren  ArrayView  Views  ArrayView ;

$ originalArray = [ 1 , 2 , 3 , 4 , 5 ];
$ view = ArrayView:: toView ( $ originalArray );

// Object-oriented style
$ view [ new MaskSelector ([ true , false , true , false , true ])]; // [1, 3, 5]
$ view [ new IndexListSelector ([ 1 , 2 , 4 ])];                   // [2, 3, 5]
$ view [ new SliceSelector ( ' ::-1 ' )];                          // [5, 4, 3, 2, 1]

// Scripting style
$ view [[ true , false , true , false , true ]]; // [1, 3, 5]
$ view [[ 1 , 2 , 4 ]];                        // [2, 3, 5]
$ view [ ' ::-1 ' ];                           // [5, 4, 3, 2, 1]

$ view [ new MaskSelector ([ true , false , true , false , true ])] = [ 10 , 30 , 50 ];
print_r ( $ originalArray ); // [10, 2, 30, 4, 50]

Menggabungkan subview

Gabungkan dan rantai subview satu demi satu dalam antarmuka yang lancar untuk melakukan beberapa operasi seleksi.

 use Smoren  ArrayView  Selectors  IndexListSelector ;
use Smoren  ArrayView  Selectors  MaskSelector ;
use Smoren  ArrayView  Selectors  SliceSelector ;
use Smoren  ArrayView  Views  ArrayView ;

$ originalArray = [ 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 , 10 ];

// Fluent object-oriented style
$ subview = ArrayView:: toView ( $ originalArray )
    -> subview ( new SliceSelector ( ' ::2 ' ))                          // [1, 3, 5, 7, 9]
    -> subview ( new MaskSelector ([ true , false , true , true , true ])) // [1, 5, 7, 9]
    -> subview ( new IndexListSelector ([ 0 , 1 , 2 ]))                  // [1, 5, 7]
    -> subview ( new SliceSelector ( ' 1: ' ));                          // [5, 7]

$ subview [ ' : ' ] = [ 55 , 77 ];
print_r ( $ originalArray ); // [1, 2, 3, 4, 55, 6, 77, 8, 9, 10]

// Fluent scripting style
$ originalArray = [ 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 , 10 ];
$ subview = ArrayView:: toView ( $ originalArray )
    -> subview ( ' ::2 ' )                           // [1, 3, 5, 7, 9]
    -> subview ([ true , false , true , true , true ]) // [1, 5, 7, 9]
    -> subview ([ 0 , 1 , 2 ])                       // [1, 5, 7]
    -> subview ( ' 1: ' );                           // [5, 7]

$ subview [ ' : ' ] = [ 55 , 77 ];
print_r ( $ originalArray ); // [1, 2, 3, 4, 55, 6, 77, 8, 9, 10]

Pipa Pemilih

Buat saluran pipa pilihan yang dapat disimpan dan diterapkan lagi dan lagi ke tampilan array baru.

 use Smoren  ArrayView  Selectors  IndexListSelector ;
use Smoren  ArrayView  Selectors  MaskSelector ;
use Smoren  ArrayView  Selectors  SliceSelector ;
use Smoren  ArrayView  Views  ArrayView ;

$ originalArray = [ 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 , 10 ];
$ selector = new PipeSelector ([
    new SliceSelector ( ' ::2 ' ),
    new MaskSelector ([ true , false , true , true , true ]),
    new IndexListSelector ([ 0 , 1 , 2 ]),
    new SliceSelector ( ' 1: ' ),
]);

$ view = ArrayView:: toView ( $ originalArray );
$ subview = $ view -> subview ( $ selector );
print_r ( $ subview [ ' : ' ]); // [5, 7]

$ subview [ ' : ' ] = [ 55 , 77 ];
print_r ( $ originalArray ); // [1, 2, 3, 4, 55, 6, 77, 8, 9, 10] 

Dokumentasi

Untuk contoh dokumentasi dan penggunaan yang terperinci, silakan merujuk ke dokumentasi API.

Pengujian unit

 composer install
composer test-init
composer test

Berkontribusi

Kontribusi dipersilakan! Jangan ragu untuk membuka masalah atau mengirimkan permintaan tarik pada repositori GitHub.

Standar

ArrayView sesuai dengan standar berikut:

• PSR-1-Standar Pengodean Dasar
• PSR-4-Autoloader
• PSR-12-Panduan Gaya Pengodean Diperpanjang

Lisensi

ArrayView PHP dilisensikan di bawah lisensi MIT.