printf parser Download - printf parser Source Code Download

printf parser

PHP printf-syntax متوافق مع سلسلة printf سلسلة.

أخرس printf سلاسل في تيار من lexemes.

متطلبات

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 كما هو محرر

الطريقة: parser-> parsestr

 function parseStr( string $ string ) : void

تخلق سلسلة printf وينبعث من lexemes المحسورة على الباعث المكوّنة

الفصل: donatj printf lexemeemitter

الطريقة: lexemeemitter-> getlexemes

 function getLexemes() :  donatj  Printf  LexemeCollection

إرجاع lexemes التي تلقاها الباعث باعتباره lexemecollection

الفصل: donatj printf lexemecollection

lexemecollection هي مجموعة غير قابلة للتغيير من lexemes مع ArrayAccess

الطريقة: lexemecollection-> getInvalid

 function getInvalid() : ? donatj  Printf  Lexeme

استرجاع أول لوكسي أو فارغ غير صالح إذا كانت جميعها صالحة.

هذا مفيد للتحقق مما إذا كانت سلسلة printf متحللة دون خطأ.

الطريقة: lexemecollection-> toarray

 function toArray() : array

احصل على lexemecollection كمجموعة مرتبة من lexemes

عائدات:

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 elexeme

يمثل Lexeme مكونًا "أساسيًا" لسلسلة printf - إما السلاسل الحرفية "!" أو lexemes غير صالحة

 <?php
namespace donatj  Printf ;

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

الطريقة: lexeme-> __ بناء

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

مُنشئ ليكسيتيم.

الطريقة: lexeme-> getlexitemtype

 function getLexItemType() : string

نوع lexeme printf

الطريقة: lexeme-> getval

 function getVal() : string

نص lexeme

الطريقة: lexeme-> getPos

 function getPos() : int

موضع السلسلة من الكسيم المعطى

الفصل: donatj printf engumentlexeme

 <?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 = ' ! ' ;
}

الطريقة: PresentExeme-> __ بناء

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