printf parser Download - printf parser Quellcode herunterladen

Printf Parser

PHP Printf-Syntax Compatible Printf String Parser.

Parsse Strings in einen Strom von Lexemen.

Anforderungen

Php :> = 7.4

Installation

Installieren Sie die neueste Version mit:

composer require ' donatj/printf-parser '

Beispiel

Hier ist ein einfaches Beispiel:

 <?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 ;
}

Ausgabe:

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

Dokumentation

Klasse: Donatj printf Parser

Parser implementiert einen PHP -Printf -kompatiblen Printf -String -Parser.

Methode: Parser-> __ Konstrukt

 function __construct(  donatj  Printf  Emitter $ emitter )

Parser -Konstruktor.

Parameter:

donatj printf Emitter $emitter - Der gegebene Emitter, der Lexemes als an Parsen ausgibt

Methode: Parser-> Parsestr

 function parseStr( string $ string ) : void

Analysiert eine Printf -Zeichenfolge und senden Sie an den konfigurierten Emitter an Parsen -Lexeme

Klasse: Donatj printf lexemeemitter

Methode: LexemeEmitter-> getlexemes

 function getLexemes() :  donatj  Printf  LexemeCollection

Geben Sie die vom Emitter erhaltenen Lexeme als unveränderliche Lexemecollection zurück

Klasse: Donatj printf lexemecollection

Lexemecollection ist eine unveränderliche iterbare Sammlung von Lexemen mit ArrayAccess

Methode: Lexemecollection-> getInvalid

 function getInvalid() : ? donatj  Printf  Lexeme

Rufen Sie das erste ungültige Lexeme oder Null ab, wenn alle gültig sind.

Dies ist nützlich, um zu überprüfen, ob eine printf -Zeichenfolge ohne Fehler analysiert wird.

Methode: lexemecollection-> toArray

 function toArray() : array

Holen Sie sich die Lexemecollection als eine geordnete Reihe von Lexemen

Rückgaben:

donatj printf lexeme []

Methode: Lexemecollection-> Argtypes

 function argTypes() : array

Gibt die Liste der erwarteten Argumente zurück, eine 1-idexierte Karte der folgenden Karte

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

Rückgaben:

String []

Klasse: Donatj printf lexeme

Lexeme repräsentiert eine "grundlegende" Komponente einer Printf -Zeichenfolge - entweder buchstäbliche Zeichenfolgen "!" oder ungültige Lexeme

 <?php
namespace donatj  Printf ;

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

Methode: Lexeme-> __ Konstrukt

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

Lexitem -Konstruktor.

Methode: Lexeme-> getlexItemtype

 function getLexItemType() : string

Der Typ des Printf -Lexems

Methode: Lexeme-> GetVal

 function getVal() : string

Der Text des Lexems

Methode: Lexeme-> getPos

 function getPos() : int

Die Stringposition des gegebenen Lexems

Klasse: Donatj printf argumentExeme

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

Methode: ArgumentExem-> __ Konstrukt

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