printf parser

printf解析器

php printf-syntax兼容printf字符串解析器。

將printf字符串解析成詞彙流。

要求

• PHP ：> = 7.4

安裝

以以下方式安裝最新版本

composer require ' donatj/printf-parser ' 

例子

這是一個簡單的例子：

 <?php

require __DIR__ . ' /../vendor/autoload.php ' ;

$ emitter = new  donatj  Printf  LexemeEmitter ;
$ parser  = new  donatj  Printf  Parser ( $ emitter );

$ parser -> parseStr ( ' percent of %s: %d%% ' );

$ lexemes = $ emitter -> getLexemes ();

foreach ( $ lexemes as $ lexeme ) {
	echo $ lexeme -> getLexItemType () . ' -> ' ;
	echo var_export ( $ lexeme -> getVal (), true );

	if ( $ lexeme instanceof  donatj  Printf ArgumentLexeme ) {
		echo ' arg type: ' . $ lexeme -> argType ();
	}

	echo PHP_EOL ;
}

輸出：

 ! -> 'percent of '
s -> 's' arg type: string
! -> ': '
d -> 'd' arg type: int
! -> '%'

文件

班級：Donatj printf Parser

解析器實現PHP printf兼容printf字符串解析器。

方法：解析器 - > __構造

 function __construct(  donatj  Printf  Emitter $ emitter )

解析器構造函數。

參數：

• donatj printf emitter $emitter給定的發射器散發出lexemes

---

方法：解析器 - >解脫

 function parseStr( string $ string ) : void

解析printf字符串並將解析的Lexemes發射到配置的發射器

班級：Donatj printf lexemeEmemitter

---

方法：lexememitter-> getlexemes

 function getLexemes() :  donatj  Printf  LexemeCollection

將發射器收到的詞彙作為不變的lexemecollection返回

班級：Donatj printf lexemecollection

LexeMeclection是一個不可變的詞彙集合的收藏

---

方法：lexemecollection-> getInvalid

 function getInvalid() : ? donatj  Printf  Lexeme

如果全部有效，請檢索第一個無效的詞彙或空。

這對於檢查printf字符串是否沒有錯誤而有用。

---

方法：lexemecollection-> toarray

 function toArray() : array

將lexemecollection作為列出的詞彙陣列

返回：

• donatj printf lexeme []

---

方法：lexemecollection-> argtypes

 function argTypes() : array 

返回預期參數的列表

 ArgumentLexeme::ARG_TYPE_MISSING  
ArgumentLexeme::ARG_TYPE_INT  
ArgumentLexeme::ARG_TYPE_DOUBLE  
ArgumentLexeme::ARG_TYPE_STRING  

返回：

• 細繩[]

班級：Donatj printf lexeme

Lexeme代表printf字符串的“基本”組件 - 要么字面字符串“！”或無效的詞彙

 <?php
namespace donatj  Printf ;

class Lexeme {
	public const T_INVALID = '' ;
	public const T_LITERAL_STRING = ' ! ' ;
}

方法：Lexeme-> __構造

 function __construct( string $ lexItemType , string $ val , int $ pos )

LexItem構造函數。

---

方法：lexeme-> getLexItemType

 function getLexItemType() : string

printf lexeme的類型

---

方法：lexeme-> getVal

 function getVal() : string

Lexeme的文字

---

方法：lexeme-> getPos

 function getPos() : int

給定Lexeme的字符串位置

班級：Donatj printf grigentlexeme

 <?php
namespace donatj  Printf ;

class ArgumentLexeme {
	/** @var string the argument is treated as an integer and presented as a binary number. */
	public const T_INT_AS_BINARY = ' b ' ;
	/** @var string the argument is treated as an integer and presented as the character with that ASCII value. */
	public const T_INT_AS_CHARACTER = ' c ' ;
	/** @var string the argument is treated as an integer and presented as a (signed) decimal number. */
	public const T_INT = ' d ' ;
	/** @var string the argument is treated as scientific notation (e.g. 1.2e+2). The precision specifier stands for the
number of digits after the decimal point since PHP 5.2.1. In earlier versions, it was taken as number of
significant digits (one less). */
	public const T_DOUBLE_AS_SCI = ' e ' ;
	/** @var string like %e but uses uppercase letter (e.g. 1.2E+2). */
	public const T_DOUBLE_AS_SCI_CAP = ' E ' ;
	/** @var string the argument is treated as a float and presented as a floating-point number (locale aware). */
	public const T_FLOAT_LOCALE = ' f ' ;
	/** @var string the argument is treated as a float and presented as a floating-point number (non-locale aware).
Available since PHP 5.0.3. */
	public const T_FLOAT_NO_LOCALE = ' F ' ;
	/** @var string shorter of %e and %f. */
	public const T_FLOAT_AUTO_SCI = ' g ' ;
	/** @var string shorter of %E and %F. */
	public const T_FLOAT_AUTO_SCI_CAP = ' G ' ;
	/** @var string the argument is treated as an integer and presented as an octal number. */
	public const T_INT_AS_OCTAL = ' o ' ;
	/** @var string the argument is treated as and presented as a string. */
	public const T_STRING = ' s ' ;
	/** @var string the argument is treated as an integer and presented as an unsigned decimal number. */
	public const T_INT_UNSIGNED = ' u ' ;
	/** @var string the argument is treated as an integer and presented as a hexadecimal number (with lowercase letters). */
	public const T_INT_HEX = ' x ' ;
	/** @var string the argument is treated as an integer and presented as a hexadecimal number (with uppercase letters). */
	public const T_INT_HEX_CAP = ' X ' ;
	public const VALID_T_TYPES = [ self :: T_INT_AS_BINARY , self :: T_INT_AS_CHARACTER , self :: T_INT , self :: T_DOUBLE_AS_SCI , self :: T_DOUBLE_AS_SCI_CAP , self :: T_FLOAT_LOCALE , self :: T_FLOAT_NO_LOCALE , self :: T_FLOAT_AUTO_SCI , self :: T_FLOAT_AUTO_SCI_CAP , self :: T_INT_AS_OCTAL , self :: T_STRING , self :: T_INT_UNSIGNED , self :: T_INT_HEX , self :: T_INT_HEX_CAP ];
	public const ARG_TYPE_MISSING = '' ;
	public const ARG_TYPE_INT = ' int ' ;
	public const ARG_TYPE_DOUBLE = ' float ' ;
	public const ARG_TYPE_STRING = ' string ' ;
	/** @var string[] string    s */
	public const STRING_TYPES = [ self :: T_STRING ];
	/** @var string[] integer    d, u, c, o, x, X, b */
	public const INTEGER_TYPES = [ self :: T_INT , self :: T_INT_UNSIGNED , self :: T_INT_AS_CHARACTER , self :: T_INT_AS_OCTAL , self :: T_INT_HEX , self :: T_INT_HEX_CAP , self :: T_INT_AS_BINARY ];
	/** @var string[] double    g, G, e, E, f, F */
	public const DOUBLE_TYPES = [ self :: T_FLOAT_AUTO_SCI , self :: T_FLOAT_AUTO_SCI_CAP , self :: T_DOUBLE_AS_SCI , self :: T_DOUBLE_AS_SCI_CAP , self :: T_FLOAT_LOCALE , self :: T_FLOAT_NO_LOCALE ];
	public const T_INVALID = '' ;
	public const T_LITERAL_STRING = ' ! ' ;
}

方法：gromentLexeme-> __構造

 function __construct( string $ lexItemType , string $ val , int $ pos , ? int $ arg , bool $ showPositive , ? string $ padChar , ? int $ padWidth , bool $ leftJustified , ? int $ precision )

gronglexememe構造函數。

LexItem構造函數。

---

方法：grightlexeme-> getarg

 function getArg() : ? int

位置指定符（例如%3$s將返回3， %s將返回null

返回：

• int | null-未指定的null

---

方法：groment lexemem-> getShowpostive

 function getShowPositive() : bool

是啟用“帶有加號的前綴正數”，啟用了標誌

---

方法：gromentLexeme-> getPadchar

 function getPadChar() : ? string

指定的墊子字符標誌

返回：

• 字符串| null-未指定的null

---

方法：groment lexemem-> getPadWidth

 function getPadWidth() : ? int

指定的墊子寬度

返回：

• int | null-未指定的null

---

方法：groment lexemem-> getLeftJustified

 function getLeftJustified() : bool

是否啟用了左簽名標誌？

---

方法：groment lexemem-> getPrecision

 function getPrecision() : ? int

詞彙指示的精度。

返回：

• int | null-未指定的null

---

方法：groment lexemem-> argtype

 function argType() : string

基於參數類型的返回以下一個

gonge xlexeme :: arg_type_missing
grigent lexlexeme :: arg_type_int
gromentLexeme :: arg_type_double
gongementlexeme :: arg_type_string

---

方法：groment lexemem-> getLexItemType

 function getLexItemType() : string

printf lexeme的類型

---

方法：gromentlexeme-> getVal

 function getVal() : string

Lexeme的文字

---

方法：gromentLexeme-> getPos

 function getPos() : int

給定Lexeme的字符串位置