base64-usage.nb

(* Content-type: application/vnd.wolfram.mathematica *)

(*** Wolfram Notebook File ***)
(* http://www.wolfram.com/nb *)

(* CreatedBy='Mathematica 8.0' *)

(*CacheID: 234*)
(* Internal cache information:
NotebookFileLineBreakTest
NotebookFileLineBreakTest
NotebookDataPosition[       157,          7]
NotebookDataLength[      8720,        289]
NotebookOptionsPosition[      6883,        221]
NotebookOutlinePosition[      7659,        250]
CellTagsIndexPosition[      7535,        244]
WindowFrame->Normal*)

(* Beginning of Notebook Content *)
Notebook[{

Cell[CellGroupData[{
Cell[TextData[{
 "A ",
 StyleBox["Mathematica",
  FontSlant->"Italic"],
 " base64 Package"
}], "Title"],

Cell["\<\
Dario Malchiodi
Universit\[AGrave] degli Studi di Milano
Dipartimento di Informatica
Via Comelico 39/41 2135 Milano ITALY
malchiodi@di.unimi.it\
\>", "Author",
 CellChangeTimes->{{3.558806788035758*^9, 3.558806800455718*^9}}],

Cell[BoxData[
 RowBox[{"(*", 
  RowBox[{
   RowBox[{
    RowBox[{
     RowBox[{
      RowBox[{
      "**", "**", "**", "**", "**", "**", "**", "**", "**", "**", "**", "**", 
       "**", "**", "**", "**", "**", "**", "**", "**", "**", "**", "**", "**",
        "**", "**", "**", "**", "**", "**", "**", "**", "**", "**", "**", "**",
        "**", "**"}], "*", "\n", "        ", "Copyright", " ", 
      RowBox[{"(", "C", ")"}], " ", "2010", " ", "Dario", " ", "Malchiodi"}], 
     "<", 
     RowBox[{
      RowBox[{"malchiodi", "@", "di"}], ".", "unimi", ".", "it"}], ">", "\n", 
     "\n", 
     RowBox[{"This", " ", "file", " ", "is", " ", "part", " ", "of", " ", 
      RowBox[{"base64", ".", "base64"}], " ", "is", " ", "free", " ", 
      "software"}]}], ";", 
    RowBox[{"you", " ", "can", " ", "redistribute", " ", "it", "\n", 
     RowBox[{"and", "/", "or"}], " ", "modify", " ", "it", " ", "under", " ", 
     "the", " ", "terms", " ", "of", " ", "the", " ", "GNU", " ", "Lesser", 
     " ", "General", " ", "Public", " ", "License", " ", "as", "\n", 
     "published", " ", "by", " ", "the", " ", "Free", " ", "Software", " ", 
     "Foundation"}], ";", 
    RowBox[{
    "either", " ", "version", " ", "2.1", " ", "of", " ", "the", " ", 
     "License"}]}], ",", "\n", 
   RowBox[{"or", " ", 
    RowBox[{"(", 
     RowBox[{"at", " ", "your", " ", "option"}], ")"}], " ", "any", " ", 
    "later", " ", 
    RowBox[{"version", ".", " ", "base64"}], " ", "is", " ", "distributed", 
    " ", "in", " ", "the", " ", "hope", " ", "that", "\n", "it", " ", "will", 
    " ", "be", " ", "useful"}], ",", " ", 
   RowBox[{
    RowBox[{"but", " ", "without", " ", "any", " ", "warranty"}], ";", 
    RowBox[{
    "without", " ", "even", " ", "the", " ", "implied", " ", "warranty", "\n",
      "of", " ", "merchantability", " ", "or", " ", "fitness", " ", "for", 
     " ", "a", " ", "particular", " ", 
     RowBox[{"purpose", ".", " ", "See"}], " ", "the", " ", "GNU", " ", 
     "Lesser", "\n", "General", " ", "Public", " ", "License", " ", "for", 
     " ", "more", " ", 
     RowBox[{"details", ".", " ", "You"}], " ", "should", " ", "have", " ", 
     "received", " ", "a", " ", "copy", " ", "of", "\n", "the", " ", "GNU", 
     " ", "Lesser", " ", "General", " ", "Public", " ", "License", " ", 
     "along", " ", "with", " ", "base64"}], ";", " ", 
    RowBox[{"if", " ", "not"}]}], ",", 
   RowBox[{
    RowBox[{"see", "\n", "<", 
     RowBox[{"http", ":"}]}], "//", 
    RowBox[{
     RowBox[{
      RowBox[{
       RowBox[{"www", ".", "gnu", ".", "org"}], "/", "licenses"}], "/"}], ">",
      "."}]}]}], "\n", "\n", 
  "******************************************************************************)"}\
]], "Code",
 CellChangeTimes->{{3.566664174659284*^9, 3.56666423311714*^9}}],

Cell[CellGroupData[{

Cell["The base64 encoding", "Section"],

Cell["\<\
Base64 is a 64-bit encoding typically used in order to encode binary \
attachments to e-mails. It mpas a group of three consecutive bytes with four \
ASCII printable characters according to a prefixed conversion table.\
\>", "Text"]
}, Open  ]],

Cell[CellGroupData[{

Cell["Obtaining and installing the package", "Section"],

Cell[TextData[{
 "The software is available at the address \
http://homes.dsi.unimi.it/~malchiod/software/base64 in form of a package file \
for ",
 StyleBox["Mathematica",
  FontSlant->"Italic"],
 ". The installation consists in downloading base64.m file and saving it in a \
directory within the $Path variable (a suggested choice is the Applications \
directory in the ",
 StyleBox["Mathematica",
  FontSlant->"Italic"],
 " system- or user-based root directory)."
}], "Text"]
}, Open  ]],

Cell[CellGroupData[{

Cell["Using the package", "Section"],

Cell[TextData[{
 "The package loads as usual in ",
 StyleBox["Mathematica",
  FontSlant->"Italic"],
 ":"
}], "Text"],

Cell[BoxData[
 RowBox[{"<<", "base64`"}]], "Input"],

Cell[TextData[{
 "The functions ",
 StyleBox["base64Encode", "InlineInput"],
 " and ",
 StyleBox["base64Decode", "InlineInput"],
 " are provided. The first handles encoding a succession of bytes (contained \
in a list):"
}], "Text"],

Cell[CellGroupData[{

Cell[BoxData[
 RowBox[{"?", "base64Encode"}]], "Input"],

Cell[BoxData["\<\"base64Encode[byt] returns the string base64-encoding the \
sequence of bytes byt\"\>"], "Print",
 CellTags->"Info3347957193-2060766"]
}, Open  ]],

Cell[CellGroupData[{

Cell[BoxData[{
 RowBox[{
  RowBox[{"original", "=", 
   RowBox[{
   "ToCharacterCode", "[", 
    "\"\<The quick brown fox jumps over the lazy dog\>\"", "]"}]}], 
  ";"}], "\[IndentingNewLine]", 
 RowBox[{"base64Encode", "[", "original", "]"}]}], "Input"],

Cell[BoxData["\<\"VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZw==\
\"\>"], "Output"]
}, Open  ]],

Cell[TextData[{
 "Analogously, ",
 StyleBox["base64Decode", "InlineInput"],
 " returns a list containing the decoded bytes corresponding to a \
base64-encoded string:"
}], "Text",
 CellChangeTimes->{{3.558720453455593*^9, 3.558720460212511*^9}}],

Cell[CellGroupData[{

Cell[BoxData[
 RowBox[{"?", "base64Decode"}]], "Input"],

Cell[BoxData["\<\"base64Decode[str] returns the list containing the bits \
corresponding to the base64-decoded version of the string str\"\>"], "Print",
 CellTags->"Info3347957195-9892054"]
}, Open  ]],

Cell[CellGroupData[{

Cell[BoxData[{
 RowBox[{
  RowBox[{"decodedBytes", "=", 
   RowBox[{
   "base64Decode", "[", 
    "\"\<VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZw==\>\"", 
    "]"}]}], ";"}], "\[IndentingNewLine]", 
 RowBox[{"FromCharacterCode", "[", "decodedBytes", "]"}]}], "Input"],

Cell[BoxData["\<\"The quick brown fox jumps over the lazy dog\"\>"], "Output"]
}, Open  ]]
}, Open  ]],

Cell[CellGroupData[{

Cell["References", "Section"],

Cell["\<\
Please send comments to malchiodi@di.unimi.it.\
\>", "Text",
 CellChangeTimes->{{3.558711144216466*^9, 3.558711165211451*^9}}]
}, Open  ]]
}, Open  ]]
},
WindowToolbars->"EditBar",
WindowSize->{784, 636},
WindowMargins->{{Automatic, 70}, {Automatic, 13}},
ShowSelection->True,
FrontEndVersion->"8.0 for Mac OS X x86 (32-bit, 64-bit Kernel) (November 6, \
2010)",
StyleDefinitions->FrontEnd`FileName[{"Report"}, "AutomatedReport.nb", 
  CharacterEncoding -> "UTF-8"]
]
(* End of Notebook Content *)

(* Internal cache information *)
(*CellTagsOutline
CellTagsIndex->{
 "Info3347957193-2060766"->{
  Cell[5163, 157, 151, 2, 20, "Print",
   CellTags->"Info3347957193-2060766"]},
 "Info3347957195-9892054"->{
  Cell[6048, 190, 189, 2, 36, "Print",
   CellTags->"Info3347957195-9892054"]}
 }
*)
(*CellTagsIndex
CellTagsIndex->{
 {"Info3347957193-2060766", 7323, 235},
 {"Info3347957195-9892054", 7432, 238}
 }
*)
(*NotebookFileOutline
Notebook[{
Cell[CellGroupData[{
Cell[579, 22, 103, 5, 66, "Title"],
Cell[685, 29, 235, 7, 100, "Author"],
Cell[923, 38, 2795, 59, 239, "Code"],
Cell[CellGroupData[{
Cell[3743, 101, 38, 0, 66, "Section"],
Cell[3784, 103, 242, 4, 41, "Text"]
}, Open  ]],
Cell[CellGroupData[{
Cell[4063, 112, 55, 0, 66, "Section"],
Cell[4121, 114, 478, 12, 56, "Text"]
}, Open  ]],
Cell[CellGroupData[{
Cell[4636, 131, 36, 0, 66, "Section"],
Cell[4675, 133, 116, 5, 26, "Text"],
Cell[4794, 140, 51, 1, 19, "Input"],
Cell[4848, 143, 232, 7, 26, "Text"],
Cell[CellGroupData[{
Cell[5105, 154, 55, 1, 19, "Input"],
Cell[5163, 157, 151, 2, 20, "Print",
 CellTags->"Info3347957193-2060766"]
}, Open  ]],
Cell[CellGroupData[{
Cell[5351, 164, 254, 7, 35, "Input"],
Cell[5608, 173, 97, 1, 19, "Output"]
}, Open  ]],
Cell[5720, 177, 245, 6, 26, "Text"],
Cell[CellGroupData[{
Cell[5990, 187, 55, 1, 19, "Input"],
Cell[6048, 190, 189, 2, 36, "Print",
 CellTags->"Info3347957195-9892054"]
}, Open  ]],
Cell[CellGroupData[{
Cell[6274, 197, 283, 7, 35, "Input"],
Cell[6560, 206, 78, 0, 19, "Output"]
}, Open  ]]
}, Open  ]],
Cell[CellGroupData[{
Cell[6687, 212, 29, 0, 66, "Section"],
Cell[6719, 214, 136, 3, 26, "Text"]
}, Open  ]]
}, Open  ]]
}
]
*)

(* End of internal cache information *)