1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
<?php /*
+----------------------------------------------------------------------+
| Copyright (c) 1997-2025 The PHP Group |
+----------------------------------------------------------------------+
| This source file is subject to version 3.01 of the PHP license, |
| that is bundled with this package in the file LICENSE, and is |
| available through the world-wide-web at the following url: |
| https://www.php.net/license/3_01.txt. |
| If you did not receive a copy of the PHP license and are unable to |
| obtain it through the world-wide-web, please send a note to |
| license@php.net, so we can mail you a copy immediately. |
+----------------------------------------------------------------------+
| Authors: André L F S Bacci <ae php.net> |
+----------------------------------------------------------------------+
# Description
This class coordinates and centrailzes control for $argv command line
parameters, used between vairous classes. */
class ArgvParser
{
private array $argv;
private array $used;
public function __construct( array $argv )
{
$this->argv = array_values( array_filter( $argv ) );
$this->used = array_fill( 0 , count( $argv ) , false );
}
public function use( string $arg ) : void
{
foreach ( $this->argv as $pos => $value )
if ( $arg == $value && $this->used[ $pos ] == false )
{
$this->used[ $pos ] = true;
return;
}
throw new Exception( "Unused '$arg' not found." );
}
public function consume( string $equals = null , string $prefix = null , int $position = -1 ) : string|null
{
$args = $this->argv;
foreach ( $args as $pos => $arg )
{
if ( $arg == null )
continue;
$foundByEquals = $equals != null && $arg == $equals;
$foundByPrefix = $prefix != null && str_starts_with( $arg , $prefix );
$foundByPosition = $position == $pos;
if ( $foundByEquals || $foundByPrefix || $foundByPosition )
{
$this->argv[ $pos ] = null;
$this->used[ $pos ] = true;
if ( $foundByPrefix )
return substr( $arg , strlen( $prefix ) );
return $arg;
}
}
return null;
}
public function complete() : void
{
foreach ( $this->argv as $pos => $arg )
if ( $this->used[ $pos ] == false )
fwrite( STDERR , "Unknown argument: {$arg}\n\n" );
}
public function residual() : array
{
return array_filter( $this->argv );
}
}
|
