Subversion Repositories php-qbpwcf

		#初始化儲存解析好的變數資訊陣列

		$result["parsedVar"]=array();

		#如果沒有解析出格式字串,代表關鍵字為空字串.

		if($OderOfPartInLine===array()){

			#儲存剩下的內容為關鍵字之一

			$keyWordPart[]=$conf["format"];

			#暫存的關鍵字資訊

			$tmp=array("name"=>"keyWordPart","index"=>0,"value"=>$conf["format"]);

			#設置順序資訊

			$OderOfPartInLine[]=$tmp;

			}#if end

						/*

						if($condition["value"]===""){

							#debug

							}#if end

						*/

						/*

						if($condition["value"]===" "){

							#debug

							}#if end

						*/

	#尋找連續的多行字串是否依順含有符合格式的內容,且回傳解析好的變數數值.

	#回傳結果:

	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

	#$reuslt["error"],執行不正常結束的錯訊息陣列.

	#$result["function"],當前執行的函式名稱.

	#$result["argu"],所使用的參數.

	#$result["found"],是否有找到符合格式的連續字串內容,"true"代表有找到,"false"代表沒有找到.

	#$result["content"],陣列,每段符合格式的段落資訊.

	#$result["content"][$i]["lineS"],字串,為第 $i+1 個符合格式的段落起始行數.

	#$result["content"][$i]["ori"],字串,為第 $i+1 個符合格式的段落每行原始內容資訊.

	#$result["content"][$i]["deletedHead"],字串,為第 $i+1 個符合格式的段落每行原始內容被剔除的開頭資訊.

	#$result["content"][$i]["new"],字串,為第 $i+1 個符合格式的段落每行關鍵字內容.

	#$result["content"][$i]["vars"],陣列,為第 $i+1 個符合格式的段落每行變數解析的結果.

	#必填參數:

	#$conf["input"],字串陣列,要檢查的每行字串.

	$conf["input"]=array("");

	#$conf["format"],格式字串陣列,要尋找的每行格式字串集合.格式為固定的字串("fixedStr format")與變數("${keyWordVarName}")組成.

	$conf["formats"]=array("");

	#可省略參數:

	#無.

	#參考資料:

	#無.

	#備註:

	#回傳結果 $result["content"][$i]["ori"][$j]=array("index"=>$oriLineIndex,"value"=>$oriLineContent) 代表第 $i+1 個符合格式的段落中第 $j+1 個原始內容對應的行數($oriLineIndex+1),其原始內容為 $oriLineContent.

	*/

	public static function findConMatchStrs(&$conf){

		#初始化要回傳的結果

		$result=array();

		#取得當前執行的函數名稱

		$result["function"]=__FUNCTION__;

		#如果沒有參數

		if(func_num_args()==0){

			#設置執行失敗

			$result["status"]="false";

			#設置執行錯誤訊息

			$result["error"]="函數".$result["function"]."需要參數";

			#回傳結果

			return $result;

			}#if end

		#取得參數

		$result["argu"]=$conf;

		#如果 $conf 不為陣列

		if(gettype($conf)!=="array"){

			#設置執行失敗

			$result["status"]="false";

			#設置執行錯誤訊息

			$result["error"][]="\$conf變數須為陣列形態";

			#如果傳入的參數為 null

			if(is_null($conf)){

				#設置執行錯誤訊息

				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";

				}#if end

			#回傳結果

			return $result;

			}#if end

		#函式說明:

		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.

		#回傳結果:

		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

		#$result["error"],執行不正常結束的錯訊息陣列.

		#$result["simpleError"],簡單表示的錯誤訊息.

		#$result["function"],當前執行的函式名稱.

		#$result["argu"],設置給予的參數.

		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過

		#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在

		#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確

		#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息

		#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.

		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.

		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.

		#$result["notNeedVar"],字串陣列,多餘的參數名稱.

		#必填參數:

		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。

		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;

		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.

		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";

		#可省略參數:

		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");

		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("input","formats");

		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null、any代表不指定變數形態.其中 resource也包含"resource (closed)".

		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","array");

		#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.

		#$conf["canBeEmptyString"]="false";

		#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.

		#$conf["canNotBeEmpty"]=array();

		#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.

		#$conf["canBeEmpty"]=array();

		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.

		#$conf["skipableVariableCanNotBeEmpty"]=array();

		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");

		#$conf["skipableVariableName"]=array();

		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");

		#$conf["skipableVariableType"]=array();

		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".

		#$conf["skipableVarDefaultValue"]=array("");

		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".

		#$conf["disallowAllSkipableVarIsEmpty"]="";

		#$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".

		#$conf["disallowAllSkipableVarIsEmptyArray"]="";

		#$conf["disallowAllSkipableVarNotExist"],字串,是否不允許每個可省略參數都不存在,預設為"false"代表允許,反之為"true".

		#$conf["disallowAllSkipableVarNotExist"]="";

		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.

		#$conf["arrayCountEqualCheck"][]=array();

		#參考資料:

		#array_keys=>http://php.net/manual/en/function.array-keys.php

		#備註:

		#無.

		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);

		unset($conf["variableCheck::checkArguments"]);

		#如果執行失敗

		if($checkArguments["status"]==="false"){

			#設置錯誤訊息

			$result["error"]=$checkArguments;

			#設置執行錯誤

			$result["status"]="false";

			#回傳結果

			return $result;

			}#if end

		#如果檢查不通過

		if($checkArguments["passed"]==="false"){

			#設置錯誤訊息

			$result["error"]=$checkArguments;

			#設置執行錯誤

			$result["status"]="false";

			#回傳結果

			return $result;

			}#if end

		#關鍵字行搜尋的索引預設數值為0

		$keyWordLineIndex=0;

		#針對每行原始內容

		for($oriLineContentIndex=0;$oriLineContentIndex<count($conf["input"]);$oriLineContentIndex++){

			#取得原始內容行

			$oriLineContent=$conf["input"][$oriLineContentIndex];

			#預設調整後的原始內容跟原本一樣

			$modifiedOriLineContent=$oriLineContent;

			#debug

			#var_dump(__LINE__,$modifiedOriLineContent);

			#初始化儲存移除的開頭內容

			$deletedOriHead="";

			#無窮迴圈

			while(true){

				#嘗試移除開頭的 空格 跟 \t

				#函式說明:

				#取得符合多個特定字首與字尾的字串

				#回傳結果:

				#$result["status"]，若爲"true"則代表執行正常；若爲"false"則代表執行失敗。

				#$result["function"],當前執行的函數名稱.

				#$result["error"],錯誤訊息陣列.

				#$result["founded"],若為"true"則代表有找到符合字首條件的結果；若爲"false"則代表沒有找到。

				#$result["content"],符合條件的字串,去掉字首字尾後的結果.

				#$result["returnString"]，爲符合字首字、尾條件的字串內容.

				#$result["meetConditions"],為符合的條件,會是$conf["keyWord"]中的其中一個元素.

				#$result["argu"],使用的參數.

				#必填參數:

				#$conf["checkString"],字串,要檢查的字串.

				$conf["search::getMeetMultiConditionsString"]["checkString"]=$modifiedOriLineContent;

				#$conf["keyWord"],字串陣列,用來檢查字首、字尾應該要有哪些字串之一,每個元素代表一個可能的條件,key為front者代表開頭的關鍵字,key為tail為代表結尾的官關鍵字.

				$conf["search::getMeetMultiConditionsString"]["keyWord"]=array(array("front"=>" "),array("front"=>"\t"));

				#可省略參數:

				#無.

				#參考資料:

				#無.

				#備註:

				#無.

				$getMeetMultiConditionsString=search::getMeetMultiConditionsString($conf["search::getMeetMultiConditionsString"]);

				unset($conf["search::getMeetMultiConditionsString"]);

				#debug

				#var_dump(__LINE__,$getMeetMultiConditionsString);

				#如果執行失敗

				if($getMeetMultiConditionsString["status"]==="false"){

					#設置錯誤識別

					$result["status"]="false";

					#設置錯誤訊息

					$result["error"]=$getMeetMultiConditionsString;

					#回傳結果

					return $result;

					}#if end

				#如果有關鍵字存在

				if($getMeetMultiConditionsString["founded"]==="true"){

					#取得已經移開頭空格跟\t後的內容

					$modifiedOriLineContent=$getMeetMultiConditionsString["content"];

					#另存符合且剔除的內容

					$meetConditions=$getMeetMultiConditionsString["meetConditions"]["front"];

					#串接開頭剔除的內容

					$deletedOriHead=$deletedOriHead.$meetConditions;

					#繼續檢查

					continue;

					}#if end

				#到這表代表已經移除開頭的 空格 跟 \t

				#結束 while

				break;

				}#while end

			#debug

			#var_dump(__LINE__,$modifiedOriLineContent);

			#取得關鍵字行的內容

			$keyWordLine=$conf["formats"][$keyWordLineIndex];

			#調整過的關鍵字內容行預設跟原始關鍵行內容一樣

			$modifiedKeyWordLine=$keyWordLine;

			#初始化關鍵字前面的內容(可能有為多個空格或tab)

			$keyWordContentOfHead="";

			#無窮迴圈

			while(true){

				#嘗試剔除開頭的 空格 跟 "\t"

				#函式說明:

				#取得符合多個特定字首與字尾的字串

				#回傳結果:

				#$result["status"]，若爲"true"則代表執行正常；若爲"false"則代表執行失敗。

				#$result["function"],當前執行的函數名稱.

				#$result["error"],錯誤訊息陣列.

				#$result["founded"],若為"true"則代表有找到符合字首條件的結果；若爲"false"則代表沒有找到。

				#$result["content"],符合條件的字串,去掉字首字尾後的結果.

				#$result["returnString"]，爲符合字首字、尾條件的字串內容.

				#$result["meetConditions"],為符合的條件,會是$conf["keyWord"]中的其中一個元素.

				#$result["argu"],使用的參數.

				#必填參數:

				#$conf["checkString"],字串,要檢查的字串.

				$conf["search::getMeetMultiConditionsString"]["checkString"]=$modifiedKeyWordLine;

				#$conf["keyWord"],字串陣列,用來檢查字首、字尾應該要有哪些字串之一,每個元素代表一個可能的條件,key為front者代表開頭的關鍵字,key為tail為代表結尾的官關鍵字.

				$conf["search::getMeetMultiConditionsString"]["keyWord"]=array(array("front"=>" "),array("front"=>"\t"));

				#可省略參數:

				#無.

				#參考資料:

				#無.

				#備註:

				#無.

				$getMeetMultiConditionsString=search::getMeetMultiConditionsString($conf["search::getMeetMultiConditionsString"]);

				unset($conf["search::getMeetMultiConditionsString"]);

				#debug

				#var_dump(__LINE__,$getMeetMultiConditionsString);

				#如果執行失敗

				if($getMeetMultiConditionsString["status"]==="false"){

					#設置錯誤識別

					$result["status"]="false";

					#設置錯誤訊息

					$result["error"]=$getMeetMultiConditionsString;

					#回傳結果

					return $result;

					}#if end

				#如果有關鍵字存在

				if($getMeetMultiConditionsString["founded"]==="true"){

					#取得移除開頭 空格 跟 \t 後的內容

					$modifiedKeyWordLine=$getMeetMultiConditionsString["content"];

					#取得關鍵字前面的內容

					$keyWordContentOfHead=substr($keyWordLine,0,strlen($keyWordLine)-strlen($modifiedKeyWordLine));

					#繼續檢查

					continue;

					}#if end

				#到這表代表已經移除開頭的 空格 跟 \t

				#解析關鍵字字串

				#函式說明：

				#尋找字串中是否含有符合格式的內容,且回傳解析好的變數數值.

				#回傳結果:

				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

				#$reuslt["error"],執行不正常結束的錯訊息陣列.

				#$result["function"],當前執行的函式名稱.

				#$result["argu"],所使用的參數.

				#$result["found"],是否有找到符合格式的字串內容,"true"代表有找到,"false"代表沒有找到.

				#$result["content"],陣列,若為n個${*},則當found為"true"時,就會回傳n個元素.

				#$result["parsedVar"][varName],陣列,解析好的變數陣列,varName為${}中的內容.

				#必填參數:

				#$conf["input"],字串,要檢查的字串.

				$conf["search::findSpecifyStrFormat"]["input"]=$modifiedOriLineContent;

				#$conf["format"],格式字串,要尋找的格式字串.格式為固定的字串("fixedStr format")與變數("${keyWordVarName}")組成.

				$conf["search::findSpecifyStrFormat"]["format"]=$modifiedKeyWordLine;

				#可省略參數:

				#$conf["varEqual"],陣列,變數對應的數值,null代表不指定,其他內容代表該變數解析出來必須要為該內容.

				#$conf["varEqual"]=array(null,"found");

				#$conf["varCon"],陣列,每個varEqual為null者,其是否有其他條件,預設為null代表無其他條件,條件的表示是用陣列的key與value來表達,例如:array("no_tail"=>" not"),就代表變數的結尾不能為" not",可以用的key有"head",代表開頭要有什麼;"no_head",代表不能為什麼開頭;"tail",代表要什麼結尾;"no_tail",代表不能什麼結尾.

				#$conf["varCon"]=array("no_tail"=>" not");

				#參考資料:

				#無.

				#備註:

				#無.

				$findSpecifyStrFormat=search::findSpecifyStrFormat($conf["search::findSpecifyStrFormat"]);

				unset($conf["search::findSpecifyStrFormat"]);

				#debug

				#var_dump(__LINE__,$findSpecifyStrFormat);

				#如果執行異常

				if($findSpecifyStrFormat["status"]==="false"){

					#設置錯誤識別

					$result["status"]="false";

					#設置錯誤訊息

					$result["error"]=$findSpecifyStrFormat;

					#回傳結果

					return $result;

					}#if end

				#如果沒有找到符合的格式

				if($findSpecifyStrFormat["found"]==="false"){

					#重新尋找第一個關鍵字串

					$keyWordLineIndex=0;

					}#if end

				#反之有找到符合的格式

				else if($findSpecifyStrFormat["found"]==="true"){

					#$result["content"][$i]["lineS"],字串,為第 $i+1 個符合格式的段落起始行數.

					#$result["content"][$i]["ori"],陣列,為第 $i+1 個符合格式的段落每行原始內容資訊.

					#$result["content"][$i]["ori"][$j]=array("index"=>$oriLineIndex,"value"=>$oriLineContent),代表第 $i+1 個符合格式的段落中第 $j+1 個原始內容對應的行數($oriLineIndex+1),其原始內容為 $oriLineContent.

					#$result["content"][$i]["new"],陣列,為第 $i+1 個符合格式的段落每行關鍵字內容.

					#$result["content"][$i]["vars"],陣列,為第 $i+1 個符合格式的段落每行變數解析的結果.

					#如果第一個關鍵字串有符合

					if($keyWordLineIndex===0){

						#初始化暫存符合的行數資訊

						$matchInfo=array();

						#記錄符合的行數

						$matchInfo["lineS"]=$oriLineContentIndex;

						}#if end

					#記錄符合的原始字串行

					$matchInfo["ori"][]=array("index"=>$oriLineContentIndex,"value"=>$modifiedOriLineContent,"deletedHead"=>$deletedOriHead);

					#記錄符合的關鍵字字串行

					$matchInfo["new"][]=$modifiedKeyWordLine;

					#記錄解析出來的變數結果

					$matchInfo["vars"][]=$findSpecifyStrFormat["parsedVar"];

					#如果後面還有關鍵字串

					if(isset($conf["formats"][$keyWordLineIndex+1])){

						#看下一個要判斷的關鍵字串

						$keyWordLineIndex++;

						}#if end

					#反之

					else{

						#記錄符合的結果資訊

						$result["content"][]=$matchInfo;

						#下次要再從第一個關鍵字字串看起

						$keyWordLineIndex=0;

						}#else end

					}#else end

				#不應該執行到這邊

				else{

					#設置錯誤識別

					$result["status"]="false";

					#設置錯誤訊息

					$result["error"][]="unexpected error";

					#設置錯誤訊息

					$result["error"][]=$findSpecifyStrFormat;

					#回傳結果

					return $result;

					}#else end

				#結束 while

				break;

				}#while end

			}#for end

		#預設沒有找到符合的字串區段

		$result["found"]="false";

		#如果有比對到的結果

		if(!empty($result["content"])){

			#設置有找到符合的字串區段

			$result["found"]="true";

			}#if end

		#設置執行正常

		$result["status"]="true";

		#回傳結果

		return $result;

		}#function findConMatchStrs end

	/*