summaryrefslogtreecommitdiff
path: root/textproc/p5-Text-xSV/DESCR
diff options
context:
space:
mode:
authormarkd <markd>2016-02-08 02:56:23 +0000
committermarkd <markd>2016-02-08 02:56:23 +0000
commit7759a58a3e758a42ee0f588cd0ed63b24a968916 (patch)
treed1ba14c12f7a3c18fe08fadbbb001d11fd11ff03 /textproc/p5-Text-xSV/DESCR
parente621f3a4ebe30449d6024e779c3f1b5eb05e8a23 (diff)
downloadpkgsrc-7759a58a3e758a42ee0f588cd0ed63b24a968916.tar.gz
Add p5-Text-xSV 0.21
This module is for reading and writing a common variation of character separated data. The most common example is comma-separated. However that is far from the only possibility, the same basic format is exported by Microsoft products using tabs, colons, or other characters. The format is a series of rows separated by returns. Within each row you have a series of fields separated by your character separator. Fields may either be unquoted, in which case they do not contain a double-quote, separator, or return, or they are quoted, in which case they may contain anything, and will encode double-quotes by pairing them. In Microsoft products, quoted fields are strings and unquoted fields can be interpreted as being of various datatypes based on a set of heuristics. By and large this fact is irrelevant in Perl because Perl is largely untyped. The one exception that this module handles that empty unquoted fields are treated as nulls which are represented in Perl as undefined values. If you want a zero-length string, quote it.
Diffstat (limited to 'textproc/p5-Text-xSV/DESCR')
-rw-r--r--textproc/p5-Text-xSV/DESCR17
1 files changed, 17 insertions, 0 deletions
diff --git a/textproc/p5-Text-xSV/DESCR b/textproc/p5-Text-xSV/DESCR
new file mode 100644
index 00000000000..22aeba59c04
--- /dev/null
+++ b/textproc/p5-Text-xSV/DESCR
@@ -0,0 +1,17 @@
+This module is for reading and writing a common variation of character
+separated data. The most common example is comma-separated. However
+that is far from the only possibility, the same basic format is
+exported by Microsoft products using tabs, colons, or other
+characters.
+The format is a series of rows separated by returns. Within each row
+you have a series of fields separated by your character
+separator. Fields may either be unquoted, in which case they do not
+contain a double-quote, separator, or return, or they are quoted, in
+which case they may contain anything, and will encode double-quotes by
+pairing them. In Microsoft products, quoted fields are strings and
+unquoted fields can be interpreted as being of various datatypes based
+on a set of heuristics. By and large this fact is irrelevant in Perl
+because Perl is largely untyped. The one exception that this module
+handles that empty unquoted fields are treated as nulls which are
+represented in Perl as undefined values. If you want a zero-length
+string, quote it.