---
name: "kdk_printer_print_local_file"
section: "3"
platform: "linux"
package: "libkysdk-system"
version: "3.0.1.4-1"
release: "Arch Linux 2026-11-07"
platforms: ["linux"]
url: "https://carta.tech/man/kdk_printer_print_local_file"
---

# kdk\_printer\_print\_local\_file(3)

打印本地文件

## NAME

kdk\_printer\_print\_local\_file - 打印本地文件

## SYNOPSIS

```
#include <libkyprinter.h>

extern int kdk_printer_print_local_file(const char *printername, const char *filepath);

Link with -lkyprinter.
```

## Detailed Description

The main function of the interface is to print a local file.

The argument *printername* is printer name, *kdk\_printer\_get\_list* returned value.

The argument *filepath* is the absolute path to the file.

## RETURN VALUE

On success, returns the id of the print job of type int.

On error, return **0.**

## EXAMPLES

```
#include "libkyprinter.h"
#include <stdio.h>
int main()
{
    int index = 0;
    //获取打印机列表
    char **printers = kdk_printer_get_available_list();
    while (printers[index])
    {
        printf("%zd: %s0, index + 1, printers[index]);
        //取消当前打印机所有打印任务
        kdk_printer_cancel_all_jobs(printers[index]);
        //获取url对应的文件名
        char *url = "http://www.cztouch.com/upfiles/soft/testpdf.pdf";
        int res = -1;
        char *filename = kdk_printer_get_filename(url); //从完整路径名中解析出文件名称，例如：/home/test/abc.txt,解析完成后为abc.txt
        printf("filename = %s0, filename);
        //设置打印参数
        kdk_printer_set_options(2, "A4", "lrtb", "two-sided-long-edge");
        //下载
        res = kdk_printer_print_download_remote_file(url, filename);
        printf("[%s] res = %d0, __FUNCTION__, res);
        printf("[%s] filepath = %s0, __FUNCTION__, filename);
        //打印
        int job_id = kdk_printer_print_local_file(printers[index], filename);
        if (job_id == 0)
        {
            //打印失败
            printf("[%s] create print job fail0, __FUNCTION__);
        }
        else
        {
            //打印成功，等待一会获取任务状态
            sleep(10);
            int status = kdk_printer_get_job_status(printers[index], job_id);
        }
        index++;
        free(filename);
    }
    kdk_printer_freeall(printers);
    return 0;
}
```

## CONFORMING TO

These functions are as per the withdrawn POSIX.1e draft specification. The following functions are Linux extensions: **kdk\_printer\_get\_list**(), **kdk\_printer\_get\_available\_list**(), **kdk\_printer\_set\_options**(), **kdk\_printer\_print\_download\_remote\_file**(), **kdk\_printer\_cancel\_all\_jobs**(), **kdk\_printer\_get\_status**(), **kdk\_printer\_get\_job\_status**(), **kdk\_printer\_get\_filename**() and **kdk\_printer\_freeall**().

## SEE ALSO

[**kdk\_printer\_get\_list**(3)](/man/kdk_printer_get_list/3.md), [**kdk\_printer\_get\_available\_list**(3)](/man/kdk_printer_get_available_list/3.md), [**kdk\_printer\_set\_options**(3)](/man/kdk_printer_set_options/3.md), [**kdk\_printer\_print\_download\_remote\_file**(3)](/man/kdk_printer_print_download_remote_file/3.md), [**kdk\_printer\_cancel\_all\_jobs**(3)](/man/kdk_printer_cancel_all_jobs/3.md), [**kdk\_printer\_get\_status**(3)](/man/kdk_printer_get_status/3.md), [**kdk\_printer\_get\_job\_status**(3)](/man/kdk_printer_get_job_status/3.md), [**kdk\_printer\_get\_filename**(3)](/man/kdk_printer_get_filename/3.md) and [**kdk\_printer\_freeall**(3)](/man/kdk_printer_freeall/3.md).