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的字符串位置