第一章 00 StringUtil.cpp和StringUtil.hh分析

/*
 * StringUtil.hh
 *
 * Copyright 2002, Log4cpp Project. All rights reserved.
 *
 * See the COPYING file for the terms of usage and distribution.
 */
頭文件的說明，以及與版權相關的說明一般都會放置在文件的開始位置


#ifndef _LOG4CPP_STRINGUTIL_HH     //為了防止代碼被多重包含
#define _LOG4CPP_STRINGUTIL_HH

#include "PortabilityImpl.hh"
#include <string>
#include <vector>
#include <climits>
#include <stdarg.h>

namespace log4cpp {

    class StringUtil {
        public:

        /**
           Returns a string contructed from the a format specifier
           and a va_list of arguments, analogously to vprintf(3).
           @param format the format specifier.
           @param args the va_list of arguments.
        **/
        static std::string vform(const char* format, va_list args);

        /**
           Returns a string identical to the given string but without leading
           or trailing HTABs or spaces.
        **/
        static std::string trim(const std::string& s);

        /**
           splits a string into a vector of string segments based on the
           given delimiter.
           @param v The vector in which the segments will be stored. The vector
           will be emptied before storing the segments
           @param s The string to split into segments.
           @param delimiter The delimiter character
           @param maxSegments the maximum number of segments. Upon return
           v.size() <= maxSegments.  The string is scanned from left to right
           so v[maxSegments - 1] may contain a string containing the delimiter
           character.
       @return The actual number of segments (limited by maxSegments).
        **/
        static unsigned int split(std::vector<std::string>& v, 
                  const std::string& s, char delimiter,
                  unsigned int maxSegments = INT_MAX);
        /**
           splits a string into string segments based on the given delimiter
           and assigns the segments through an output_iterator.
           @param output The output_iterator through which to assign the string
           segments. Typically this will be a back_insertion_iterator.
           @param s The string to split into segments.
           @param delimiter The delimiter character
           @param maxSegments The maximum number of segments.
           @return The actual number of segments (limited by maxSegments).
        **/
        template<typename T> static unsigned int split(T& output,
                const std::string& s, char delimiter,
                unsigned int maxSegments = INT_MAX) {
            std::string::size_type left = 0;
            unsigned int i;
            for(i = 1; i < maxSegments; i++) {
                std::string::size_type right = s.find(delimiter, left);
                if (right == std::string::npos) {
                    break;
                }
                *output++ = s.substr(left, right - left);
                left = right + 1;
            }
            
            *output++ = s.substr(left);
            return i;
        }
    };
}

#endif // _LOG4CPP_STRINGUTIL_HH


一、關于#include的話題
#include <iostream>
#include <iostream.h>
兩行代碼有什么區別呢

#include <iostream.h>

using namespace std;

int main(int argc,char**argv)
{
   cout<<"hi guys"<<endl;
        
  return 0;   
}

編譯器會發出報警哦：


看來是C++標準的問題，新的代碼逐漸不再支持<X.h>的包含方式,但是該警告信息可以在編譯器中用-Wno-deprecated選項關閉的。deprecated這里的意思是“過時了”

至于是否在頭文件中要用include包含頭文件，這個可以開新的話題了，留待以后補上吧。。。。。
嗯哼。。。LINE16還沒解釋，為毛？？？？
stdarg.h是C語言中C標準函數庫的頭文件，stdarg是由standard（標準） arguments（參數）簡化而來，主要目的為讓函數能夠接收可變參數。
C++的cstdarg頭文件中也提供這樣的功能；雖然與C的頭文件是兼容的，但是也有沖突存在。

這里引出了兩個標準函數庫：C標準函數庫和C++標準函數庫。額，這也是兩個巨大的Topics，還是度娘吧。。。。。由于這里引用了C標準函數庫的頭文件，
So,用了#include <stdargs.h>的寫法。至于。。。至于哪個頭文件屬于C++標準函數庫，哪個屬于C標準函數庫呢，Windows平臺的IDE開發環境發揮了積極的優勢。
See See吧，

自動補齊功能，提示的是.h文件哦。。。。


這個是沒有.h的。
好了，不要在這個話題上糾結了。Go on  .......睡覺鳥。。。。。 

?