strtol詳解

文章裝載自：http://blog.csdn.net/happylife1527/article/details/8441799，你們看到這篇文章想轉載的請註明出處，尊重原做者勞動成果。

今天，在review 一些代碼的時候，看到了strtol()這個函數，因爲之前使用它的時候，尚未深入的瞭解，此次，我決定探個究竟。

網上關於這個函數的資料大都來源於同份資料，linux庫函數，講的不夠細緻。因而，我花了幾個小時，認真地嘗試其功能，並整理了這篇文章，但願能對C語言的愛好者一些幫助。

但願你們可以將本文中發現的錯誤及時反饋給我，以便修正。個人信箱是wp.qin@sunmedia.com。

+----------------+
|      strtol             |
+----------------+

i.e. string to long

long int strtol(const char *nptr, char **endptr, int base)
strtol()會將nptr指向的字符串，根據參數base，按權轉化爲long int, 而後返回這個值。
參數base的範圍爲2~36,和0；它決定了字符串以被轉換爲整數的權值。
能夠被轉換的合法字符依據base而定，舉例來講，當base爲2時，合法字符爲‘0’，‘1’；base爲8時，合法字符爲‘0’，‘1’，……‘7’；base爲10時，合法字符爲‘0’，‘1’，……‘9’；base 爲16時，合法字符爲‘0’，‘1’，……‘9’，‘a’，……‘f’；base爲24時，合法字符爲‘0’，……‘9’，‘a’，……‘n’，base爲36時，合法字符爲‘0’，……‘9’，‘a’，……‘z’；等等。其中，不區分大小寫，好比，‘A’和‘a’會都會被轉化爲10。
當字符合法時，‘0’，……‘9’依次被轉換爲十進制的0～9，‘a’，……‘z’一次北轉換爲十進制的10～35。
strtol()函數檢測到第一個非法字符時，當即中止檢測，其後的全部字符都會被看成非法字符處理。合法字符串會被轉換爲long int, 做爲函數的返回值。非法字符串，即從第一個非法字符的地址，被賦給*endptr。**endptr是個雙重指針，即指針的指針。strtol()函數就是經過它改變*endptr的值，即把第一個非法字符的地址傳給endptr。

多數狀況下，endptr設置爲NULL, 即不返回非法字符串。
下面看幾個例子:
------------------------------------------------------
char buffer[20]="10379cend$3";
char *stop;
printf("%d\n",strtol(buffer, &stop, 2));
printf("%s\n", stop);
輸出結果：
2
379cend$3
-------------------------------------------------------
char buffer[20]="10379cend$3";
char *stop;
printf("%d\n",strtol(buffer, &stop, 8));
printf("%s\n", stop);
輸出結果：
543
9cend$3
--------------------------------------------------------
char buffer[20]="10379cend$3";
char *stop;
printf("%d\n",strtol(buffer, &stop, 10));
printf("%s\n", stop);
輸出結果：
10379
cend$3
-------------------------------------------------------
char buffer[20]="10379cend$3";
char *stop;
printf("%d\n",strtol(buffer, &stop, 16));
printf("%s\n", stop);
輸出結果：
17005006
nd$3
另外，若是base爲0，且字符串不是以0x(或者0X)開頭，則按十進制進行轉化。若是base爲0或者16，而且字符串以0x（或者0X）開頭，那麼，x（或者X）被忽略，字符串按16進制轉化。若是base不等於0和16，而且字符串以0x(或者0X)開頭，那麼x被視爲非法字符。
例如:
-------------------------------------------------------
char buffer[20]="0x31da6c";
char *stop;
printf("%d\n",strtol(buffer, &stop, 0));
printf("%s\n", stop);
輸出結果(stop爲空)：
3267180

-------------------------------------------------------
char buffer[20]="0x31da6c";
char *stop;
printf("%d\n",strtol(buffer, &stop, 13));
printf("%s\n", stop);
輸出結果：
0
0x31da6c
-------------------------------------------------------

最後，須要說明的是，對於nptr指向的字符串，其開頭和結尾處的空格被忽視，字符串中間的空格被視爲非法字符。
例如：
-------------------------------------------------------
char buffer_1[20]="10379c";
char buffer_2[20]="      10379c        ";
char buffer_3[20]="      10      379c        ";
printf("%d\n",strtol(buffer_1,NULL,0));
printf("%d\n",strtol(buffer_2,NULL,0));
printf("%d\n",strtol(buffer_3,NULL,0));
輸出結果爲：
10379
10379
10