Modifier and Type	Class and Description
public static class	MarkupIterator.Chunk
pack-priv static class	MarkupIterator.FieldNumbering Class used locally to assign indexes to the automatically-numbered arguments (see String Formatting section of the Python Standard Library).

Field Summary

Modifier and Type	Field and Description
private final boolean	bytes True if originally given a `bytes` or `bytearray` (so that when a value is formatted using a chunk, it should be to bytes not the code points of a `str`).
private int	index How far along that string we are.
private final String	markup The UTF-16 string from which elements are being returned.
private final MarkupIterator.FieldNumbering	numbering A counter used to auto-number fields when not explicitly numbered in the format.
public static final PyType	TYPE The Python type `formatteriterator` of this class.

Constructor Summary

Access	Constructor and Description
private	MarkupIterator(String to parse markup, boolean if originally bytes-like bytes, MarkupIterator.FieldNumbering for automatically numbered arguments numbering) Constructor used at top-level to enumerate a format.
public	MarkupIterator(String to parse markup) Constructor used at top-level to enumerate a format.
public	MarkupIterator(String to parse markup, boolean if originally bytes-like bytes) Constructor used at top-level to enumerate a format that may be for a bytes-like object.
public	MarkupIterator(MarkupIterator within which this is nested enclosingIterator, String the substring this is to parse subMarkup) Variant constructor used when formats are nested.

Method Summary

Modifier and Type	Method and Description
pack-priv final Object	__iter__()
pack-priv final Object	Returns: `PyTuple` chunk or `null` __next__() Return the next "chunk" of the format (or return `null` if ended).
public PyType	getType() Implements org.python.core.CraftedPyObject.getType. The Python `type` of this object.
private int	indexOfFirst(String s, int start, char c1, char c2) Find the first of two characters, or return -1.
public final boolean	Returns: true if originally given a PyString isBytes() If originally given a PyString, string elements in the returned tuples must be PyString not PyUnicode.
public MarkupIterator.Chunk	Returns: the chunk nextChunk() Return the next `Chunk` from the iterator, which is a structure containing parsed elements of the replacement field (if any), and its preceding text.
private void	parseField(MarkupIterator.Chunk destination chunk result, String specifying a replacement field, possibly with nesting fieldMarkup) Parse a "replacement field" consisting of a name, conversion and format specification.
private String	unescapeBraces(String substring)
private Object	Returns: object for tuple wrap(String to wrap as a PyObject or null if `defaultValue` should be wrapped. value, String to return or `null` if default return is `None`. defaultValue) Convenience method for populating the return tuple, returning a `String` or `Py.None` if both arguments are `null`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

bytes	back to summary
private final boolean bytes True if originally given a `bytes` or `bytearray` (so that when a value is formatted using a chunk, it should be to bytes not the code points of a `str`).

index	back to summary
private int index How far along that string we are.

markup	back to summary
private final String markup The UTF-16 string from which elements are being returned.

numbering	back to summary
private final MarkupIterator.FieldNumbering numbering A counter used to auto-number fields when not explicitly numbered in the format.

TYPE	back to summary
public static final PyType TYPE The Python type `formatteriterator` of this class.

Constructor Detail

MarkupIterator	back to summary
private MarkupIterator(String markup, boolean bytes, MarkupIterator.FieldNumbering numbering) Constructor used at top-level to enumerate a format. Parameters markup:String to parse bytes:boolean if originally bytes-like numbering:MarkupIterator.FieldNumbering for automatically numbered arguments

MarkupIterator

back to summary

private MarkupIterator(String markup, boolean bytes, MarkupIterator.FieldNumbering numbering)

Constructor used at top-level to enumerate a format.

Parameters

markup:String: to parse
bytes:boolean: if originally bytes-like
numbering:MarkupIterator.FieldNumbering: for automatically numbered arguments

MarkupIterator	back to summary
public MarkupIterator(String markup) Constructor used at top-level to enumerate a format. Parameters markup:String to parse

MarkupIterator

back to summary

public MarkupIterator(String markup)

Constructor used at top-level to enumerate a format.

Parameters

markup:String: to parse

MarkupIterator	back to summary
public MarkupIterator(String markup, boolean bytes) Constructor used at top-level to enumerate a format that may be for a bytes-like object. Parameters markup:String to parse bytes:boolean if originally bytes-like

MarkupIterator

back to summary

public MarkupIterator(String markup, boolean bytes)

Constructor used at top-level to enumerate a format that may be for a bytes-like object.

Parameters

markup:String: to parse
bytes:boolean: if originally bytes-like

MarkupIterator	back to summary
public MarkupIterator(MarkupIterator enclosingIterator, String subMarkup) Variant constructor used when formats are nested. Parameters enclosingIterator:MarkupIterator within which this is nested subMarkup:String the substring this is to parse

MarkupIterator

back to summary

public MarkupIterator(MarkupIterator enclosingIterator, String subMarkup)

Variant constructor used when formats are nested.

Parameters

enclosingIterator:MarkupIterator: within which this is nested
subMarkup:String: the substring this is to parse

Method Detail

__iter__	back to summary
pack-priv final Object __iter__()

__next__ back to summary

__next__	back to summary
pack-priv final Object __next__() Return the next "chunk" of the format (or return `null` if ended). A chunk is a 4-tuple describing the text leading up to the next format field, the field name or number (as a string) for accessing the value, the format specifier such as `"#12x"`, and any conversion that should be applied (the `'s'` or `'r'` codes for `str()` and `repr()`) Elements 1-3 are None if this chunk contains no format specifier. Elements 0-2 are zero-length strings if missing from the format, while element 3 will be None if missing. Returns:Object `PyTuple` chunk or `null`

pack-priv final Object __next__()

Return the next "chunk" of the format (or return null if ended). A chunk is a 4-tuple describing

the text leading up to the next format field,
the field name or number (as a string) for accessing the value,
the format specifier such as "#12x", and
any conversion that should be applied (the 's' or 'r' codes for str() and repr())

Elements 1-3 are None if this chunk contains no format specifier. Elements 0-2 are zero-length strings if missing from the format, while element 3 will be None if missing.

Returns:Object: PyTuple chunk or null

getType back to summary

getType	back to summary
public PyType getType() Implements org.python.core.CraftedPyObject.getType. Doc from org.python.core.CraftedPyObject.getType. The Python `type` of this object. Returns:PyType `type` of this object Annotations @Override

public PyType getType()

Implements org.python.core.CraftedPyObject.getType.

Doc from org.python.core.CraftedPyObject.getType.

The Python type of this object.

Returns:PyType

type of this object

Annotations

@Override

indexOfFirst	back to summary
private int indexOfFirst(String s, int start, char c1, char c2) Find the first of two characters, or return -1.

isBytes	back to summary
public final boolean isBytes() If originally given a PyString, string elements in the returned tuples must be PyString not PyUnicode. Returns:boolean true if originally given a PyString

isBytes

back to summary

public final boolean isBytes()

If originally given a PyString, string elements in the returned tuples must be PyString not PyUnicode.

Returns:boolean: true if originally given a PyString

nextChunk back to summary

nextChunk	back to summary
public MarkupIterator.Chunk nextChunk() Return the next `Chunk` from the iterator, which is a structure containing parsed elements of the replacement field (if any), and its preceding text. This is the Java equivalent of the tuple returned by `__next__()`. This finds use in the implementation of `str.format` and `unicode.format`. Returns:MarkupIterator.Chunk the chunk

public MarkupIterator.Chunk nextChunk()

Return the next Chunk from the iterator, which is a structure containing parsed elements of the replacement field (if any), and its preceding text. This is the Java equivalent of the tuple returned by __next__(). This finds use in the implementation of str.format and unicode.format.

Returns:MarkupIterator.Chunk: the chunk

parseField	back to summary
private void parseField(MarkupIterator.Chunk result, String fieldMarkup) Parse a "replacement field" consisting of a name, conversion and format specification. According to the Python Standard Library documentation, a replacement field has the structure: replacement_field ::= "{" [field_name] ["!" conversion] [":" format_spec] "}" field_name ::= arg_name ("." attribute_name \| "[" element_index "]")* arg_name ::= [identifier \| integer] attribute_name ::= identifier element_index ::= integer \| index_string except at this point, we have already discarded the outer braces. Parameters result:MarkupIterator.Chunk destination chunk fieldMarkup:String specifying a replacement field, possibly with nesting

parseField

back to summary

private void parseField(MarkupIterator.Chunk result, String fieldMarkup)

Parse a "replacement field" consisting of a name, conversion and format specification. According to the Python Standard Library documentation, a replacement field has the structure:

replacement_field ::=  "{" [field_name] ["!" conversion] [":" format_spec] "}"
field_name        ::=  arg_name ("." attribute_name | "[" element_index "]")*
arg_name          ::=  [identifier | integer]
attribute_name    ::=  identifier
element_index     ::=  integer | index_string

except at this point, we have already discarded the outer braces.

Parameters

result:MarkupIterator.Chunk: destination chunk
fieldMarkup:String: specifying a replacement field, possibly with nesting

unescapeBraces	back to summary
private String unescapeBraces(String substring)

wrap back to summary

wrap	back to summary
private Object wrap(String value, String defaultValue) Convenience method for populating the return tuple, returning a `String` or `Py.None` if both arguments are `null`. Parameters value:String to wrap as a PyObject or null if `defaultValue` should be wrapped. defaultValue:String to return or `null` if default return is `None`. Returns:Object object for tuple

private Object wrap(String value, String defaultValue)

Convenience method for populating the return tuple, returning a String or Py.None if both arguments are null.

Parameters

value:String: to wrap as a PyObject or null if defaultValue should be wrapped.
defaultValue:String: to return or null if default return is None.

Returns:Object

object for tuple

org.python.core.stringlib back to summary

public final Class MarkupIterator.Chunk

Class Inheritance

extends Object

java.lang.Object
org.python.core.stringlib.MarkupIterator.Chunk

Field Summary

Modifier and Type	Field and Description
public String	conversion Conversion to be applied, e.g. `'r'` for `repr()`.
public String	fieldName The field name or number (as a string) for accessing the value.
public String	formatSpec The format specifier such as `"#12x"`.
public boolean	formatSpecNeedsExpanding Signals the `formatSpec` needs expanding recursively.
public String	literalText The text leading up to the next format field.

Constructor Summary

Access	Constructor and Description
public	Chunk()

Method Summary

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

conversion	back to summary
public String conversion Conversion to be applied, e.g. `'r'` for `repr()`.

fieldName	back to summary
public String fieldName The field name or number (as a string) for accessing the value.

formatSpec	back to summary
public String formatSpec The format specifier such as `"#12x"`.

formatSpecNeedsExpanding	back to summary
public boolean formatSpecNeedsExpanding Signals the `formatSpec` needs expanding recursively.

literalText	back to summary
public String literalText The text leading up to the next format field.

Constructor Detail

Chunk	back to summary
public Chunk()

org.python.core.stringlib back to summary

pack-priv final Class MarkupIterator.FieldNumbering

Class Inheritance

extends Object

java.lang.Object
org.python.core.stringlib.MarkupIterator.FieldNumbering

Class used locally to assign indexes to the automatically-numbered arguments (see String Formatting section of the Python Standard Library).

Field Summary

Modifier and Type	Field and Description
private int	automaticFieldNumber
private boolean	manualFieldNumberSpecified

Constructor Summary

Access	Constructor and Description
pack-priv	FieldNumbering()

Method Summary

Modifier and Type	Method and Description
pack-priv String	Returns: index as string nextAutomaticFieldNumber() Generate a numeric argument index automatically, or raise an error if already started numbering manually.
pack-priv void	useManualFieldNumbering() Remember we are numbering manually, and raise an error if already started numbering automatically.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

automaticFieldNumber	back to summary
private int automaticFieldNumber

manualFieldNumberSpecified	back to summary
private boolean manualFieldNumberSpecified

Constructor Detail

FieldNumbering	back to summary
pack-priv FieldNumbering()

Method Detail

nextAutomaticFieldNumber	back to summary
pack-priv String nextAutomaticFieldNumber() Generate a numeric argument index automatically, or raise an error if already started numbering manually. Returns:String index as string

nextAutomaticFieldNumber

back to summary

pack-priv String nextAutomaticFieldNumber()

Generate a numeric argument index automatically, or raise an error if already started numbering manually.

Returns:String: index as string

useManualFieldNumbering	back to summary
pack-priv void useManualFieldNumbering() Remember we are numbering manually, and raise an error if already started numbering automatically.

public Class MarkupIterator

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Class MarkupIterator.Chunk

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

pack-priv final Class MarkupIterator.FieldNumbering

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail