WebSVN – php-qbpwcf – Diff – /trunk/usr/lib64/qbpwcf/arrays.php

 <?php
 /*
 	QBPWCF, Quick Build PHP website Component base on Fedora Linux.
-    Copyright (C) 2015~2025 Min-Jhin,Chen
+    Copyright (C) 2014~2025 MIN ZHI, CHEN
     This file is part of QBPWCF.
     QBPWCF is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
 	#無.
 	#備註:
 	#用array_diff()可快速得到結果
 	*/
 	public static function eraseRepeatedElement(&$conf){
 		#初始化要回傳的變數
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$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["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["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果參數檢查不過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#剔除掉特定元素的陣列,使用原來陣列的key來儲存.
 		$result["content"]["byName"]=array();
 		#剔除掉特定元素的陣列,使用從0開始的整數key來儲存.
 		$result["content"]["byNumber"]=array();
 		#如果arrayB沒有內容
 		if(count($conf["arrayB"])===0){
 			#直接將arrayA的內容放進去
 			$result["content"]["byName"]=$conf["arrayA"];
 			#針對每隔陣列a
 			foreach($conf["arrayA"] as $val){
 				$result["content"]["byNumber"][]=$val;
+				}
 			}#if end
 		else{
 			#針對 $conf["arrayA"] 的每個元素
 			foreach($conf["arrayA"] as $aAk => $aAv){
 				#針對 $conf["arrayB"] 的每個元素
 				foreach($conf["arrayB"] as $aBk => $aBv){
 					/*
 					#debug
 					echo "\$aAV:".$aAv.PHP_EOL;
 					echo "\$aBV:".$aBv.PHP_EOL;
 					echo "(\$aAv===\$aBv):".($aAv===$aBv).PHP_EOL;
 					*/
 					#如果arrayA的元素數值存在於陣列arrayB
 					if($aAv===$aBv){
 						/*
 						#debug
 						echo "(\$aAv===\$aBv):".($aAv===$aBv).PHP_EOL;
 						*/
 						#移除重複的元素
 						#unset($conf["arrayA"][$aAk]);
 						#unset($conf["arrayB"][$aBk]);
 						/*
 						#debug
 						echo $aAv." repeated, ignore it.".PHP_EOL;
 						*/
 						#跳過
 						continue 2;
 						}#if end
 					/*
 					#debug
 					echo "(\$aAv!==\$aBv):".($aAv!==$aBv).PHP_EOL;
 					echo "add ".$aAv." ".PHP_EOL;
 					*/
 					#如果還沒比較到最後一個
 					#參考資料:
 					#array_key_last => https://stackoverflow.com/questions/1070244/how-to-determine-the-first-and-last-iteration-in-a-foreach-loop
 					if($conf["arrayB"][$aBk]!==$conf["arrayB"][array_key_last($conf["arrayB"])]){
 						/*
 						#debug
 						echo "not last, continue...".PHP_EOL;
 						*/
 						#繼續比
 						continue;
 						}#if end
 					#以key取得未重複的元素
 					$result["content"]["byName"][$aAk]=$aAv;
 					#如果IP未重複
 					if(!in_array($aAv,$result["content"]["byNumber"])){
 						#重新排列未重複的元素
 						$result["content"]["byNumber"][]=$aAv;
 						}#if end
 					}#foreach end
 				}#foreach end
 			}#else end
 		#設置有剩下未重複的元素
 		$result["empty"]="false";
 		#如果沒有剩下未重複的元素
 		if($result["content"]["byName"]===array()){
 			#設置沒有剩下未重複的元素
 			$result["empty"]="true";
 			}#if end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function eraseRepeatedElement end
 	/*
 	#函式說明:
 	#將陣列中特定元素剔除,並重新按照順序排序
 			#回傳結果
 			return $result;
 			}#if end
 		#針對要合併的每組一維陣列
 		foreach($conf["inputArray"] as $array){
 			#如果要合併的元素不是陣列
 			if(gettype($array)!=="array"){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$checkArguments;
 				#回傳結果
 				return $result;
 				}#if end
 			#針對該陣列中的每個元素
 			foreach($array as $arrayAdded){
 				#如果不允許重複的內容
 				if($conf["allowRepeat"]==="false"){
 					#如果要寬鬆的視為相異
 					if($conf["looseDiff"]==="true"){
 						#如果有重複了
 						if(in_array($arrayAdded,$result["content"])){
 							#跳到下一個
 							continue;
 							}#if end
 						}#if end
 					#反之,代表不能寬鬆的認為相異
 					else{
 						#針對每個既有的元素
 						foreach($result["content"] as $key=>$val){
 							#取得元素的參考
 							$valExist=&$val;
 							#取得要檢查是否重複的元素
 							$valAdded=&$arrayAdded;
 							#如果既有元素跟要檢查是否重複的元素均是陣列
 							if( (gettype($valExist)==="array") && (gettype($valAdded)==="array") ){
 								#預設不知道是否有差異
 								$varExistAndValAddedIsDiff="?";
 								#針對每個已存在元素
 								foreach($valExist as $veKey => $veVal){
 									#若存在 key 相同的地方
 									if(isset($valAdded[$veKey])){
 										#如果 $veVal 跟 $valAdded[$veKey] 兩者都是陣列
 										if( gettype($veVal)==="array" && gettype($valAdded[$veKey])==="array" ){
 											#用來判斷是否 陣列 $veVal 跟 $valAdded[$veKey] 有相異的元素數量
 											$sameCount=count($veVal);
 											#如果 陣列 $valAdded 的元素數量比較多
 											if($sameCount<count($valAdded[$veKey])){
 												#更新 用來判斷是否 陣列 $veVal 跟 $valAdded[$veKey] 有相異的元素數量
 												$sameCount=count($valAdded[$veKey]);
 												}#if end
 											#遞回處理
 											#函式說明:
 											#將多個一維陣列串聯起來,key從0開始排序.
 											#回傳的結果：
 											#$result["status"],"true"表執行正常,"false"代表執行不正常.
 											#無.
 											#備註:
 											#無.
 											$mergeArray=arrays::mergeArray($conf["arrays::mergeArray"]);
 											unset($conf["arrays::mergeArray"]);
 											#如果執行失敗
 											if($mergeArray["status"]==="false"){
 												#設置執行失敗
 												$result["status"]="false";
 												#設置錯誤訊息
 												$result["error"]=$mergeArray;
 												#回傳結果
 												return $result;
 												}#if end
 											#如果 合併好元素數量大於 陣列 $veVal 跟 $valAdded[$veKey] 有相異的元素數量
 											if( count($mergeArray["content"]) > $sameCount ){
 												#代表 $veVal 跟 $valAdded[$veKey] 是有差異的陣列
 												#設置有相異
 												$varExistAndValAddedIsDiff="true";
 												#跳出 foreach
 												break;
 												}#if end
 											}#if end
 										#反之
 										else{
 											#若 key 相同的地方,其 val 有相異
 											if($veVal!==$valAdded[$veKey]){
 												#設置有相異
 												$varExistAndValAddedIsDiff="true";
 												#跳出 foreach
 												break;
 												}#if end
 											}#else end
 										}#if end
 									#反之沒有  key 相同的地方
 									else{
 										#設置有相異
 										$varExistAndValAddedIsDiff="true";
 										#跳出 foreach
 										break;
 										}#else end
 									}#foreach end
 								#如果沒有找到有相異的
 								if($varExistAndValAddedIsDiff==="?"){
 									#設置無相異
 									$varExistAndValAddedIsDiff="false";
 									}#if end
 								#如果無相異
 								if($varExistAndValAddedIsDiff==="false"){
 									#跳到下一個
 									continue 3 ;
 									}#if end
 								}#if end
 							#反之不是都為陣列,
 							else{
 								#若為同形態,且數值相同
 								if($valExist===$valAdded){
 									#跳到下一個
 									continue 2;
 									}#if end
 								}#else end
 							}#foreach end
 						#執行到這邊代表既有的元素與要新增的元素是相異的
 						#將之合併到 $result 陣列裡面
 						$result["content"][]=$arrayAdded;
 						}#else end
 					}#if end
 				#反之
 				else{
 					#將之合併到 $result 陣列裡面
 					$result["content"][]=$arrayAdded;
 					}#else end
 				}#foreach end
 			}#foreach end
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function unique(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#初始話要回傳的陣列
 		$result["content"]=array();
 			#回傳結果
 			return $result;
 			}#if end
 		#初始化給 arrays::mergeArray 用的 inputArray 參數
 		$paramsOfInputArrayOfArraysMergeArray=array();
 		#針對每個元素
 		foreach($conf["inputArray"] as $ele){
 			#包成陣列並儲存起來
 			$paramsOfInputArrayOfArraysMergeArray[]=array($ele);
 			}#foreach end
 		#函式說明:
 		#將多個一維陣列串聯起來,key從0開始排序.
 		#回傳的結果：
 		#$result["status"],"true"表執行正常,"false"代表執行不正常.
 		#$result["error"],錯誤訊息陣列.
 		#無.
 		#備註:
 		#無.
 		$mergeArray=arrays::mergeArray($conf["arrays::mergeArray"]);
 		unset($conf["arrays::mergeArray"]);
 		#debug
 		#var_dump(__LINE__,$mergeArray);
 		#如果執行失敗
 		if($mergeArray["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#回傳結果
 			return $result;
 			}#if end
 		#設置執行後得到的不重複陣列結果
 		$result["content"]=$mergeArray["content"];
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function unique end
 	/*
 	#函式說明:
 	#將多個多維陣列串聯起來,key從0開始排序.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function mergeMultiDimensionArray(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#初始話要回傳的陣列
 		$result["content"]=array();
 			}#if end
 		#儲存使用的參數
 		$result["argu"]=$conf;
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 			#回傳結果
 			return $result;
 			}#if end
 		#針對每組一維陣列
 		foreach($conf["inputArray"] as $array){
 			#如果是空陣列
 			if(empty($array)){
 				#跳過之
 				continue;
 				}#if end
 			#針對該一維陣列中的每個元素
 			foreach($array as $arrayAdded){
 				#如果不允許重複的內容
 				if($conf["allowRepeat"]==="false"){
 					#如果有指定 key 階層
 					if(isset($conf["equalKeyStruc"])){
 						#初始化儲存用來比對是否相符的變數
 						$valInArray=$arrayAdded;
 						#debug
 						#var_dump(__LINE__,$valInArray);
 						#針對每個 key 階層
 						foreach($conf["equalKeyStruc"] as $keyLayer){
 							#如果沒有該階層
 							if(!isset($valInArray[$keyLayer])){
 								#換看下個元素
 								continue 2;
 								}#if end
 							#取得對應key的內容
 							$valInArray=$valInArray[$keyLayer];
 							}#foreach end
 						#預設要新增
 						$add=true;
 						#針對已經合併好的陣列中的每個元素
 						foreach($result["content"] as $index => $val){
 							#針對每個 key 階層
 							foreach($conf["equalKeyStruc"] as $keyLayer){
 								#取得對應key的內容
 								$val=$val[$keyLayer];
 								}#foreach end
 							#如果遇到新的相同內容
 							if($val===$valInArray){
 								#用新的取代舊的
 								$result["content"][$index]=$array;
 								#設置不用新增
 								$add=false;
 								}#if end
 							}#foreach end
 						#如果要新增
 						if($add){
 							#新增之
 							$result["content"][]=$arrayAdded;
 							#debug
 							#var_dump(__LINE__,$result["content"]);
 							#跳到下一個
 							continue;
 							}#if end
 						}#if end
 					#反之如果有重複了
 					else if(in_array($arrayAdded,$result["content"])){
 						#跳到下一個
 						continue;
 						}#if end
 					}#if end
 				#將之合併到 $result 陣列裡面
 				$result["content"][]=$arrayAdded;
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function mergeMultiDimensionArray end
 	/*
 	#函式說明:
 	#透過多個擁有一樣數量元素的一維陣列,透過指定的連接字串,組成一組同樣數量的一維陣列。
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function stringToArray(&$conf){
 		#初始化要回傳的變數
 		$result=array();
 		#初始化當前執行的函數名稱
 		$result["funciton"]=__FUNCTION__;
 			}#if end
 		#取得使用的參數
 		$result["argu"]=$conf;
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#必填寫的參數：
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("inputStr");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
 		#$conf["canBeEmptyString"]="false";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("spiltSymbol");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(",");
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["arrayCountEqualCheck"][]=array();
 		$checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查有誤
 		if($checkResult["status"]=="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkResult["passed"]=="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#將固定格式的字串分開，並回傳分開的結果。
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息陣列
 		#可省略參數:
 		#$conf["allowEmptyStr"],是否允許分割出來空字串,預設為"false"不允許;"true"代表允許.
 		$conf["stringProcess::spiltString"]["allowEmptyStr"]="false";
 		$spiltString=stringProcess::spiltString($conf["stringProcess::spiltString"]);
 		unset($conf["stringProcess::spiltString"]);
 		#如果分割字串失敗
 		if($spiltString["status"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$spiltString;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得分割好的字串陣列
 		$result["content"]=$spiltString["dataArray"];
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function stringToArray end
 	/*
 	#函式說明:
 	#將一維陣列轉換為用特定符號間隔的字串,ex:array("1","2","3") to "a;b;c;".
 	#回傳的結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 			}#if end
 		#取得使用的參數
 		$result["argu"]=$conf;
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],執行不正常結束的錯訊息陣列.
 		#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["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行錯誤的識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#初始化 $result["content"]
 		$result["content"]="";
 		#如果開頭就要放置分割的字串
 		if($conf["spiltSymbolAtStart"]==="true"){
 			#串接分割的字串
 			$result["content"]=$result["content"].$conf["spiltSymbol"];
 			}#if end
 		#紀錄總共有幾個變數
 		$Tcount=count($conf["inputArray"]);
 			#計數
 			$count++;
 			#如果要串接的內容不為字串
 			if(gettype($elementValue)!=="string"){
 				#設置錯誤識別
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"][]="要串接的內容須為字串";
 				#設置錯誤訊息
 				$result["error"][]=$elementValue;
 				#設置錯誤訊息
 				$result["error"][]="wrong type is ".gettype($elementValue);
 				#回傳結果
 				return $result;
 				}#if end
 			#如果是最後一個
 			if($count===$Tcount && $conf["skipEnd"]==="true"){
 				#如果切出的長度還不足
 				if($conf["length"]>count($result["content"]["get"])){
 					#儲存切割出來的元素
 					$result["content"]["get"][]=$val;
 					}#if end
 				#反之切割出來的長度已經足夠了
 				else{
 				}#if end
 			#反之沒到要切割的位置
 			else{
 				#儲存剩下來的右方陣列
 				$result["content"]["leftL"][]=$val;
 				}#else end
 			}#foreach end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function split end
 	/*
 	#函式說明:
 	#將既有的一維陣列變成二維陣列，新增指定或相同的欄位資訊.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function addColumn(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 			#回傳結果
 			return $result;
 			}#if end
 		#初始化要回傳的二維陣列內容
 		$result["content"]=array(array());
 		#針對每個要處理的既有一維陣列變數
 		foreach($conf["array"] as $index => $firstEle){
 			#如果存在新的欄位指定內容
 			if(isset($conf["newArray"][$index])){
 				#設置新的欄位內容
 				$secondEle=$conf["newArray"][$index];
 				}#if end
 			#反之
 			else{
 				#設置新的欄位內容為第一個新的元素
 				$secondEle=$conf["newArray"][0];
 				}#else end
 			#設置新的欄位內容
 			$row=array($firstEle,$secondEle);
 			#儲存新的欄位內容
 			$result["content"][]=$row;
 			}#foreach end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function addColumn end
 		/*
 		#函式說明:
 		#將陣列的key資訊取出,以方便使用.
 		#無.
 		#備註:
 		#無.
 		*/
 		public static function inspectKey(&$conf){
 			#初始化要回傳的結果
 			$result=array();
 			#取得當前執行的函數名稱
 			$result["function"]=__FUNCTION__;
 				#回傳結果
 				return $result;
 				}#if end
 			#檢查參數
 			#函式說明:
 			#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 			#回傳結果:
 			#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 			#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["status"]="false";
 				#設置執行錯誤訊息
 				$result["error"]=$checkArguments;
 				#回傳結果
 				return $result;
 				}#if end
 			#若檢查不通過
 			if($checkArguments["passed"]==="false"){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置執行錯誤訊息
 				$result["error"]=$checkArguments;
 				#回傳結果
 				return $result;
 				}#if end
 			#針對每個元素
 			foreach($conf["array"] as $arrayKey => $arrayVal){
 				#儲存 array key
 				$result["content"]["key"][]=$arrayKey;
 				#儲存 array value
 				$result["content"]["val"][]=$arrayVal;
 				}#foreach end
 			#取得陣列的元素數量
 			$result["count"]=count($result["content"]["key"]);
 			#設置執行正常
 			$result["status"]="true";
 			#回傳結果
 			return $result;
 			}#function inspectKey end
 	}#class arrays end
 ?>

Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/arrays.php – Rev 62 → 226