Скачать printf parser - printf parser Support Code Скачать

Printf Parser

PHP printf-syntax Совместимый с Printf String Parser.

Струнения SARSES 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.

Метод: анализатор-> __ Construct

 function __construct(  donatj  Printf  Emitter $ emitter )

Конструктор анализатора.

Параметры:

donatj printf emitter $emitter - данный эмиттер для излучения лекса в качестве разобработанного

Метод: анализатор-> parsestr

 function parseStr( string $ string ) : void

Подготовки строки Printf и излучающие лексики для настроенного излучения

Класс: Donatj printf lexemeemitter

Метод: lexemeemitter-> getlexemes

 function getLexemes() :  donatj  Printf  LexemeCollection

Верните лексы, полученные излучателем в качестве неизменной лексики

Класс: Donatj printf lexemecollection

LexeMecollection - это неизменная итерабильная коллекция лексов с Arrayaccess

Метод: lexemecollection-> getInvalid

 function getInvalid() : ? donatj  Printf  Lexeme

Получите первую неверную лексиму или NULL, если все действительны.

Это полезно для проверки, проанализирована ли строка печати без ошибок.

Метод: lexemecollection-> toarray

 function toArray() : array

Получите LexeMecollection в качестве упорядоченного массива Lexemes

Возвращает:

donatj printf lexeme []

Метод: lexemecollection-> argtypes

 function argTypes() : array

Возвращает список ожидаемых аргументов 1-индексированную карту следующего

 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-> __ Construct

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

Lexitem Constructor.

Метод: lexeme-> getlexitemtype

 function getLexItemType() : string

Тип печать лексем

Метод: Lexeme-> getval

 function getVal() : string

Текст лексимы

Метод: Lexeme-> getPos

 function getPos() : int

Строковая позиция данной лексимы

Класс: Donatj printf argyslexeme

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

Метод: Argentlexeme-> __ Construct

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