Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Data::Unixish::trunc(3User Contributed Perl DocumentatiData::Unixish::trunc(3)

NAME
       Data::Unixish::trunc - Truncate string to a certain column width

VERSION
       This document describes version 1.572 of	Data::Unixish::trunc (from
       Perl distribution Data-Unixish),	released on 2019-10-26.

SYNOPSIS
       In Perl:

	use Data::Unixish qw(lduxl);
	my @res	= lduxl([trunc => {width=>4}], "123", "1234", "12345");	# => ("123", "1234", "1234")

       In command line:

	% echo -e "123\n1234\n12345" | dux trunc -w 4 --format=text-simple
	123
	1234
	1234

FUNCTIONS
   trunc
       Usage:

	trunc(%args) ->	[status, msg, payload, meta]

       Truncate	string to a certain column width.

       This function can handle	text containing	wide characters	and ANSI
       escape codes.

       Note: to	truncate by character instead of column	width (note that wide
       characters like Chinese can have	width of more than 1 column in
       terminal), you can turn of "mb" option even when	your text contains
       wide characters.

       This function is	not exported.

       Arguments ('*' denotes required arguments):

       o   ansi	=> bool	(default: 0)

	   Whether to handle ANSI escape codes.

       o   in => array

	   Input stream	(e.g. array or filehandle).

       o   mb => bool (default:	0)

	   Whether to handle wide characters.

       o   out => any

	   Output stream (e.g. array or	filehandle).

       o   width* => int

       Returns an enveloped result (an array).

       First element (status) is an integer containing HTTP status code	(200
       means OK, 4xx caller error, 5xx function	error).	Second element (msg)
       is a string containing error message, or	'OK' if	status is 200. Third
       element (payload) is optional, the actual result. Fourth	element	(meta)
       is called result	metadata and is	optional, a hash that contains extra
       information.

       Return value:  (any)

HOMEPAGE
       Please visit the	project's homepage at
       <https://metacpan.org/release/Data-Unixish>.

SOURCE
       Source repository is at
       <https://github.com/perlancar/perl-Data-Unixish>.

BUGS
       Please report any bugs or feature requests on the bugtracker website
       <https://rt.cpan.org/Public/Dist/Display.html?Name=Data-Unixish>

       When submitting a bug or	request, please	include	a test-file or a patch
       to an existing test-file	that illustrates the bug or desired feature.

AUTHOR
       perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE
       This software is	copyright (c) 2019, 2017, 2016,	2015, 2014, 2013, 2012
       by perlancar@cpan.org.

       This is free software; you can redistribute it and/or modify it under
       the same	terms as the Perl 5 programming	language system	itself.

perl v5.32.1			  2021-02-28	       Data::Unixish::trunc(3)

NAME | VERSION | SYNOPSIS | FUNCTIONS | HOMEPAGE | SOURCE | BUGS | AUTHOR | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Data::Unixish::trunc&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help