Yazdır (Write out)

--write-out veya kısaca -w, bir transfer tamamlandıktan sonra metin ve bilgi çıktılar (yazdırır). Çıktıya dahil edebileceğiniz, değerlerle ve transferden gelen bilgilerle ayarlanmış çok sayıda değişken sunar.

Bu seçeneğe düz metin ileterek curl'den bir dize çıktılamasını isteyin:

curl -w "formatted string" http://example.com/

…ve dizeyi '@' ile öncelerseniz curl'ün o dizeyi verilen bir dosyadan okumasını da sağlayabilirsiniz:

curl -w @filename http://example.com/

…veya dosya adı olarak '-' kullanırsanız curl'ün dizeyi stdin'den okumasını bile sağlayabilirsiniz:

curl -w @- http://example.com/

Değişkenler

Mevcut olan değişkenlere dizeye %{degisken_adi} yazılarak erişilir ve bu değişken doğru değerle değiştirilir. Düz bir % çıktılamak için %% olarak yazarsınız. Ayrıca \n kullanarak yeni bir satır, \r ile satır başı ve \t ile bir sekme boşluğu çıktılayabilirsiniz.

Örnek olarak, bir HTTP transferinden Content-Type'ı ve yanıt kodunu, yeni satırlarla ve bunun gibi bazı ekstra metinlerle ayrılmış olarak çıktılayabiliriz:

curl -w "Type: %{content_type}\nCode: %{response_code}\n" \
  http://example.com

Çıktı varsayılan olarak stdout'a gönderilir, bu nedenle indirilen içeriği de stdout'a göndermediğinizden emin olmak isteyebilirsiniz, aksi takdirde verileri ayırmakta zorlanabilirsiniz; veya çıktıyı stderr'e göndermek için %{stderr} kullanın.

HTTP başlıkları

Bu seçenek ayrıca, en son transferden gelen HTTP yanıt başlıklarının içeriğini çıktılamanın kolay bir yolunu da sağlar.

Dizede %header{isim} kullanın; burada isim, başlığın büyük/küçük harfe duyarlı olmayan adıdır (sondaki iki nokta üst üste olmadan). Çıktı başlık içerikleri daha sonra ağ üzerinden gönderildiği gibi tam olarak gösterilir, baştaki ve sondaki boşluklar kırpılır. Şöyle:

curl -w "Server: %header{server}\n" http://example.com

Çıktı

Varsayılan olarak, bu seçenek seçilen verilerin stdout'ta çıktılamasını sağlar. Bu yeterince iyi değilse, %{stderr} sözde değişkeni (aşağıdaki) kısmı stderr'e yönlendirmek için kullanılabilir ve %{stdout} onu tekrar stdout'a getirir.

curl 8.3.0'dan itibaren, kullanıcıların write-out çıktısını bir dosyaya göndermesine olanak tanıyan bir özellik vardır: %output{dosyaadı}. Takip eden veriler daha sonra o dosyaya yazılır. curl'ün dosyayı sıfırdan oluşturmak yerine o dosyaya eklemesini tercih ederseniz, dosya adının önüne >> ekleyin. Şöyle: %output{>>dosyaadı}.

Bir write-out argümanı, kullanıcının uygun gördüğü şekilde stderr, stdout ve dosyalara çıktı içerebilir.

Windows

NOT: Windows'ta % sembolü, ortam değişkenlerini genişletmek için kullanılan özel bir semboldür. Toplu işlem (batch) dosyalarında, bu seçeneği kullanırken düzgün bir şekilde kaçmak için tüm % oluşumları iki katına çıkarılmalıdır. Bu seçenek komut isteminde (command prompt) kullanılırsa % kaçılamaz ve istenmeyen genişletme mümkündür.

Mevcut --write-out değişkenleri

Bu değişkenlerin bazıları gerçekten eski curl sürümlerinde mevcut değildir.

curl 8.1.0'da, url veya url_effective değişkenlerinin istediğinizden fazlasını gösterdiği durumlar için yalnızca belirli URL bileşenlerini çıktılama değişkenleri eklendi.