D3.js - Sınırlayıcıyla Ayrılmış Değerler API'si

Sınırlayıcı, düz metin veya diğer verilerdeki ayrı, bağımsız bölgeler arasındaki sınırı belirtmek için kullanılan bir veya daha fazla karakter dizisidir. Alan sınırlayıcı, virgülle ayrılmış değerler dizisidir. Sınırlayıcıyla ayrılmış değerlercomma separated values (CSV) veya tab-separated values(TSV). Bu bölümde sınırlayıcıyla ayrılmış değerler ayrıntılı olarak açıklanmaktadır.

API'yi Yapılandırma

API'yi aşağıdaki sözdizimini kullanarak kolayca yükleyebiliriz.

<script src = "https://d3js.org/d3-dsv.v1.min.js"></script>
<script>
   var data = d3.csvParse(string);
</script>

API yöntemleri

Sınırlayıcıyla ayrılmış değerlerin çeşitli API yöntemleri aşağıda verilmiştir.

d3.csvParse (string [, satır])
d3.csvParseRows (dize [, satır])
d3.csvFormat (satırlar [, sütunlar])
d3.csvFormatRows(rows)
d3.tsvParse (dize [, satır])
d3.tsvParseRows (string [, satır])
d3.tsvFormat (satırlar [, sütunlar])
d3.tsvFormatRows(rows)

Bu API yöntemlerinin her birini ayrıntılı olarak inceleyelim.

d3.csvParse (string [, satır])

Bu yöntem, csv biçimini ayrıştırmak için kullanılır. Dosyayı düşünündata.csv bu aşağıda gösterilmiştir.

year,population
2006,40
2008,45
2010,48
2012,51
2014,53
2016,57
2017,62

Şimdi, yukarıda verilen işlevi uygulayabiliriz.

Example - Şu örneği ele alalım.

var data = d3.csvParse(string, function(d) {
   return {
      year: new Date(+d.Year, 0, 1), // lowercase and convert "Year" to Date
      population: d.population
   };
});

Burada, sınırlayıcı ile ayrılmış değerlerde belirtilen dizeyi ayrıştırır. Ayrıştırılmış satırları temsil eden bir dizi nesne döndürür.

d3.csvParseRows (dize [, satır])

Bu yöntem, satırlara eşdeğer csv biçimini ayrıştırmak için kullanılır.

var data = d3.csvParseRows(string, function(d, i) {
   return {
      year: new Date(+d[0], 0, 1), // convert first colum column to Date
      population: d[1],
   };
});

Csv dosyasındaki her satırı ayrıştırır.

d3.csvFormat (satırlar [, sütunlar])

Bu yöntem, csv satırlarını ve sütunlarını biçimlendirmek için kullanılır.

Example - Şu örneği ele alalım.

var string = d3.csvFormat(data, ["year", "population"]);

Burada, sütunlar belirtilmemişse, başlık satırını oluşturan sütun adlarının listesi, satırlardaki tüm nesnelerdeki tüm özelliklerin birleşimiyle belirlenir. Sütunlar belirtilmişse, sütun adlarını temsil eden bir dizeler dizisidir.

d3.csvFormatRows (satırlar)

Bu yöntem, csv satırlarını biçimlendirmek için kullanılır.

Example - Şu örneği ele alalım.

var string = d3.csvFormatRows(data.map(function(d, i) {
   return [
      d.year.getFullYear(), // Assuming d.year is a Date object.
      d.population
   ];
}));

Burada, belirtilen dizi satırlarını sınırlayıcıyla ayrılmış değerler olarak biçimlendirerek bir dize döndürür.