# Hamsi

## Hamsi.js ile Dizilere Hükmedin, Hemde Türkçe
[![npm version](https://badge.fury.io/js/hamsi.svg)](https://badge.fury.io/js/hamsi) [![wercker status](https://app.wercker.com/status/6ae33c39e1faf8dc57dfd9a45671dd79/m/master "wercker status")](https://app.wercker.com/project/byKey/6ae33c39e1faf8dc57dfd9a45671dd79)

### Yükleme Yönergeleri

Yüklemek için [Node.js](https://nodejs.org/) v4.5+ gereklidir.

```sh
$ npm install --save hamsi
```


### Kütüphane ile Gelen Özellikler

```js
var <isim> = require('hamsi');
<isim>.Build();
// Kütüphaneyi çalıştırır.

<diziniz>.turla(/* Burası callback alır */);
// turla fonksiyonu callback'e iki değişken atar; ilki eleman, ikincisi hatadır.

<diziniz>.aralikTurla(/* Başlangıç Değeri, Bitiş Değeri, Callback */);
// Callback turla fonksiyonu ile aynı değerleri alır, ek olarak başlangıç ve bitiş değeri girilir.

<diziniz>.uzunluk();
// Dizinin uzunluğunu döndürür.

<diziniz>.elemanlariYazdir();
// Dizinin elemanlarını alt alta yazdırır.

<diziniz>.tersCevir();
// Diziyi ters çevirir.

<diziniz>.ekle(/* Eleman */);
// İstediğiniz elemanı diziye eklemenizi sağlar.
```


### Örnek Kullanım

Aşağıda kütüpahenin örnek bir dizide kullanımı gösterilmiştir.

```js
'use strict';
let Hamsi = require('hamsi');
let Dizi = ['Ev','Araba','Bilgisayar','Cay','Kahve'];
let x;

Hamsi.Build();

Dizi.turla(function (eleman, hata) {
  if (!hata) {
    console.log(eleman);
  }
});
// Çıktı: Ev, Araba, Bilgisayar, Cay, Kahve (Alt alta)

Dizi.aralikTurla(0,3,function (eleman, hata) {
  if (!hata) {
    console.log(eleman);
  }
});
// Çıktı: Ev, Araba, Bilgisayar (Alt alta)

x = Dizi.uzunluk();
console.log(x);
// Çıktı: 5
```