NAME
docs/deprecations/deprecations_2_9.pod - Parrot Deprecations for 2.9
DESCRIPTION
Parrot Deprecations for 2.9.
Remove charset opcodes and fixed_8 encoding
Description
Charsets have been merged into encodings. The charset opcodes and the fixed_8 encoding will be removed.
Rational
After the charset/encoding merge, they're unneeded.
Replacment
Use the corresponding encoding opcodes instead.
/* old code */
$I0 = charset $S0
$S1 = charsetname $I0
$I1 = find_charset "ascii"
$S2 = trans_charset $S0, $I1
/* updated code */
$I0 = encoding $S0
$S1 = encodingname $I0
$I1 = find_encoding "ascii"
$S2 = trans_encoding $S0, $I1
The list of supported encodings is:
ascii
iso-8859-1
binary
utf8
utf16
ucs2
ucs4
Use the 'utf8' encoding instead of the 'unicode' charset. The 'fixed_8' encoding is also going away. Use 'ascii' instead. If you want to test for a fixed_8 encoding, you have to compare the encoding to 'ascii', 'iso-8859-1' and 'binary' separately.
Remove Parrot_PCCINVOKE
Description
The C function Parrot_PCCINVOKE has been removed.
See TT #443 and [wiki:PCCMigrationNotes] for details.
Rational
This function didn't conform to Parrot's naming conventions.
Replacment
Use Parrot_pcc_invoke_method_from_c_arg instead.
A simple textual substitution is enough to update any code that depends on this function.
/* old code */
Parrot_PCCINVOKE(interp, interp->scheduler, CONST_STRING(interp, "count_handlers"), "S->I", handler_type, &count);
/* updated code */
Parrot_pcc_invoke_method_from_c_args(interp, interp->scheduler, CONST_STRING(interp, "count_handlers"), "S->I", handler_type, &count);
See r42129 for more examples.
Remove Parrot_find_global_s and Parrot_store_global_s
Description
Parrot_find_global_s and Parrot_store_global_s were removed after they were found to be unused.
Rational
Nothing in Parrot used them and they were therefore untested.
Replacment
Use the body of one of the old functions in place of its call.
/* old code */
XXX: insert code here
/* updated code */
XXX: insert code here
See r48435 (src/namespace.c changes) for an example of what to replace calls to these functions with.
See r42129 for more example
Change behavior of find_lex opcode
Description
The find_lex opcode no longer throws an exception when the lexical is not found; it returns PMCNULL instead.
Rational
This is consistent with the other "lookup" opcodes.
Replacment
If you want to throw an exception, you must check the result of the opcode and throw the exception explicitly.
Remove CodeString PMC
Description
The CodeString pmc has been removed.
See TT #1633
Rational
With the switch to immutable strings, CodeString became very expensive, as it did a lot of string concatenations.
Replacment
As a replacement for the .emit() functionality, instead use .append_format() in StringBuilder. Only difference from emit() is that newlines are not automatically appended, so you'll have to add them manually.
Charname_to_ord is now an opcode: find_codepoint.
The other methods that were provided are now part of PCT (and are probably not needed directly).
Eliminate Raw NCI
Description
It is no longer possible to create an NCI pmc without a corresponding NCI signature.
See TT #1549
Rational
This functionality abused the NCI and went against the initial purpose - bridging the gap between parrot and C by translating calling conventions.
This was error prone, generally leading to segfaults.
Replacment
If you must have an equivalent, take a look at NativePCCMethod. Otherwise, enjoy the fact that your segfaults are now most likely "not implemented" errors.
GetRuntimePrefix
Description
The function Parrot_get_runtime_prefix has been removed.
See TT #1191
Rational
It returned a char * instead of a Parrot string.
A new function provides better functionality and there is no need to keep this.
Replacment
Parrot_get_runtime_path
RemoveIsTty
Description
The method is_tty in several Handle PMCs has been removed.
See TT #1689
Rational
There was a inconsistency, some PMCs used is_tty and others isatty. The decision was to keep isatty.
Replacment
Use isatty.