Sayısal değer işlevler dize
Notlar
Her işlev strtod ailesi için sayısal bir değer boş sonlandırılmış bir dize dönüştürür.Kullanılabilir işlevler aşağıdaki tabloda listelenmiştir.
İşlev |
Description |
|---|---|
strtod |
Çift duyarlıklı kayan nokta değeri dize dönüştürme |
strtol |
Uzun tamsayı dize dönüştürme |
strtoul |
İşaretsiz uzun tamsayı dize dönüştürme |
_strtoi64 |
Dize dönüştürme 64-bit __int64 tamsayı |
_strtoui64 |
Dönüştürme dizesine İmzasız 64-bit __int64 tamsayı |
wcstod, wcstol, wcstoul, and _wcstoi64 are wide-character versions of strtod, strtol, strtoul, and _strtoi64, respectively.Bu geniş karakter işlevlerin her dize bağımsız değişkeni bir geniş karakter dizesidir; her işlevi kümedeki tek byte–character karşılığı aksi davranır.
strtod İşlev iki bağımsız değişkenleri alır: ilk giriş dizesi ise ve ikinci karakter işaretçi erdiği dönüştürme işlemi.strtol, strtoul, _strtoi64 ve _strtoui64 dönüştürme işleminde kullanılacak temel sayı olarak üçüncü bağımsız değişken alır.
Giriş dizesi, belirtilen türde bir sayısal değer yorumlanan karakter dizisidir.Her işlev dizeyi bir sayı bir parçası olarak tanıyamaz ilk karakterinde okuma durdurur.Bu sondaki boş karakter olabilir.İçin strtol, strtoul, _strtoi64, ve _strtoui64, bu Sonlandırıcı karakter ilk sayısal karakter sayısından büyük veya eşit kullanıcı tarafından sağlanan temel de olabilir.
Kullanıcı tarafından sağlanan işaretçiyi dönüştürme son karaktere ayarlanırsa değil, null çağrı anda tarama durdu karakter için bir işaretçi var. Bunun yerine saklanacaktır.Dönüştürme işlemi, (geçerli bir basamak bulunamadı veya geçersiz bir temel belirtildi) dize işaretçisi değeri o adresinde saklanır.
strtodaşağıdaki biçimde bir dize bekliyor:
boşluk] sign] digits] **.**digits [ {d | D | e | E}signdigits
A boşluk göz ardı edilir; boşluk veya sekme karakterleri oluşabilir oturum da artı (+) veya eksi (–); ve digits bir veya daha fazla ondalık basamağı olan.Hiç basamak önce taban karakter görünüyorsa, en az bir sayı tabanı karakterin arkasına gelmelidir.Ondalık basamak bir tanıtım harfi oluşan bir üs izlenebilir (d, d, e, ya da e) ve isteğe bağlı olarak imzalı tamsayı.Üstel bir parçası ya da bir sayı tabanı karakter görüntülenirse, taban karakter dizesindeki son basamağını gelmesini kabul edilir.Bu form için uygun değil ilk karakter taramayı durdurur.
strtol, strtoul, _strtoi64, Ve _strtoui64 işlevlerinin beklediğiniz aşağıdaki biçimde bir dize:
boşluk[{+ | –}]0 { x | X}]] digits
Temel değişken 2 ile 36 arasında ise, sayının temel olarak kullanılır.0 İse, dönüştürme son işaretçi için başvurulan ilk karakterinin matrahını belirlemek için kullanılır.İlk karakteri 0'dır ve ikinci karakteri 'x' veya 'x' değil, dize sekizlik bir tamsayı olarak yorumlanır. Aksi halde, ondalık sayı olarak yorumlanır.İlk karakter '0' dir ve ikinci bir karakter 'x' veya 'x' dizeyi onaltılık tamsayı olarak yorumlanır.İlk karakter ' 1' ile ' 9' ise, dize bir ondalık tamsayı olarak yorumlanır.Harfleri 35 deerleri 10 'a' ile 'z' (veya 'a'-'z') atanır; yalnızca atanan değerleri olan harfleri küçük temel izin verilir.strtoulve _strtoui64 artı izin ver (+) veya eksi (–) işareti öneki; Dönüş değeri değilleme uygulanmış önüne bir eksi işareti gösterir.
Çıkış değeri ayarı tarafından etkilenen LC_NUMERIC ; bölgesel kategori ayarı Bkz: setlocale daha fazla bilgi için.Bu işlevler sürümlerini _l soneki kullanan yerel bu yerel ayara bağımlı davranışı; sürümleriyle _l soneki yerine geçirilen yerel parametresi kullandıkları dışında aynı.
Ne zaman bu işlevleri tarafından döndürülen değer bir taşma veya yetersiz gelme neden olur veya dönüşümü mümkün olmadığında, özel durum değerlerinin gösterildiği gibi döndürülür:
İşlev |
Koşul |
Döndürülen değer |
|---|---|---|
strtod |
Aşım |
+/- HUGE_VAL |
strtod |
Yetersizlik durumu veya dönüştürme |
0 |
strtol |
+ Taşma |
LONG_MAX |
strtol |
-Taşma |
LONG_MIN |
strtol |
Yetersizlik durumu veya dönüştürme |
0 |
_strtoi64 |
+ Taşma |
_I64_MAX |
_strtoi64 |
-Taşma |
_I64_MIN |
_strtoi64 |
Dönüştürme |
0 |
_strtoui64 |
Aşım |
_UI64_MAX |
_strtoui64 |
Dönüştürme |
0 |
_I64_MAX, _I64_MIN, ve _UI64_MAX SINIRLARI içinde tanımlanır.H.
wcstod, wcstol, wcstoul, _wcstoi64, and _wcstoui64 are wide-character versions of strtod, strtol, strtoul, _strtoi64, and _strtoui64, respectively; İşaretçiyi dönüştürme son argüman geniş karakter Bu işlevlerden her biri için bir geniş karakter dizesidir.Aksi halde, bu geniş karakter işlevlerden her biri aynı tek byte–character karşılığı davranır.